Intégration MCP

Connectez à Addness une IA comme Claude Code, Codex, ChatGPT, Cursor ou Claude Desktop (intégration MCP), et l’IA peut lire et écrire vos objectifs, ToDo, commentaires et plus encore dans Addness.

Votre IA habituelle

Claude Code

Codex

Cursor

MCP

Bidirectionnel, en lecture et en écriture

Arborescence des objectifs d'Addness

🎯 100 nouveaux clients au T1

Finaliser les supports de proposition

Idéal, mémo, commentaires, livrables

Quelle que soit l'IA utilisée, la destination connectée est la même arborescence d'objectifs. L'avancement comme le contexte s'y accumulent

Pour les débutants : à la première étape, « Connecter », de l’écran de configuration qui s’ouvre après l’inscription, vous connectez à Addness l’IA que vous utilisez (→ Accueil). Les étapes à partir de l’installation de l’application d’IA se trouvent dans l’article Installer une app d’IA et la connecter à Addness. Cet article n’explique que la partie relative à l’intégration MCP.

Envoyer la demande à l’IA

Il vous suffit d’envoyer cette demande à l’IA que vous utilisez.

Configure le MCP d'Addness (https://vt.api.addness.com/mcp).

L’IA avance là où elle le peut et ne vous guide que là où votre intervention est nécessaire. L’approbation de la connexion dans le navigateur, c’est la seule chose à faire vous-même lorsque l’IA vous y invite.

Ce que l’IA devient capable de faire

Ce qu’elle peut faire	Exemple
Lire et écrire des objectifs	Consulter l’arbre des objectifs, créer/mettre à jour/terminer des objectifs
Vos ToDo	Répondre à « qu’est-ce que je fais aujourd’hui ? » en regardant vos vraies tâches et objectifs
Progression et activité	Saisir les mouvements de l’équipe, l’activité des membres et les objectifs à l’arrêt
Commentaires et notifications	Publier des commentaires sur les objectifs, consulter et traiter les notifications
Enregistrer des ressources	Rattacher ce que vous avez produit à un objectif comme ressource
Recherche d’objectifs	Rechercher les objectifs de l’organisation
Connaissances	Rechercher, lire, créer et mettre à jour les connaissances de l’organisation
Drive	Rechercher des ressources, créer des dossiers, déplacer, mettre à la corbeille et restaurer
Enregistrement d’écran	Lister les enregistrements, lire les transcriptions, rattacher aux objectifs, partager
File Transfer	Envoyer de gros fichiers, consulter l’historique d’envoi, désactiver des liens
Liste de clients (CRM)	Importer des clients, mettre à jour les étapes, organiser les contacts, journaliser l’activité
Analytics	Créer des définitions de KPI et des tableaux de bord, actualiser les données chaque matin
Parcours client	Créer des parcours, enregistrer des étapes et des actions, consigner les exécutions quotidiennes
Bases de données	Créer des tables et modifier des colonnes, lire et écrire des lignes
Formulaires	Créer et publier des formulaires, lire les réponses, les exporter en CSV
Discussion	Lire et écrire dans les discussions d’objectif, les groupes et les DM, et créer des groupes
Réunions et comptes rendus	Demander le bot de compte rendu pour une réunion, lister et lire les comptes rendus
Carte mentale	Créer des cartes, ajouter, modifier et déplacer des branches (nœuds)
Modèles et routines	Créer des objectifs à partir de modèles, planifier et modifier des routines
Membres et organigramme	Affecter des membres, définir les supérieurs, émettre des liens d’invitation
Widgets	Placer les widgets prévus sur Accueil et sur la page de détail d’un objectif
Network	Rechercher des personnes et des organisations, consulter les profils, publications et offres d’emploi, répondre aux publications
Défis	Signaler que les étapes d’un défi sont terminées

Quelle que soit l’IA depuis laquelle vous vous connectez, elle lit et écrit le même arbre des objectifs de la même organisation.

Si cela s’interrompt en cours de route : étapes par outil

Si la configuration s’arrête sur les autorisations ou l’authentification, montrez les étapes ci-dessous à l’IA, ou poursuivez vous-même.

ChatGPT (plugin officiel)

Saisissez « @Addness » dans ChatGPT ou sélectionnez Addness dans la liste des applications. Appuyez sur « Connecter », connectez-vous à Addness et appuyez sur « Autoriser ». Disponible avec l’offre Free. Les opérations d’écriture nécessitent une confirmation. Vous ne pouvez connecter qu’un compte Addness existant (impossible de créer un compte depuis ChatGPT).

Claude Code (terminal)

1. Ajouter Addness MCP (avec --scope user, pour qu’il soit utilisable depuis n’importe quel projet)

claude mcp add --transport http --scope user addness https://vt.api.addness.com/mcp

2. Se connecter à Addness (lorsque le navigateur s’ouvre, approuvez avec votre compte Addness)

claude mcp login addness

3. Vérifier la connexion (c’est fait si addness apparaît dans la liste ; vous pouvez aussi vérifier depuis /mcp à l’intérieur de Claude Code)

claude mcp list

Codex (CLI)

Il suffit de vous connecter à Addness dans le navigateur pour l’utiliser. La création d’une clé API n’est pas nécessaire (l’ancien Codex ne prend pas en charge OAuth, mettez-le donc à jour vers la dernière version avant de l’exécuter).

1. Ajouter Addness MCP (le navigateur s’ouvre automatiquement, approuvez donc avec votre compte Addness. Les paramètres sont enregistrés dans ~/.codex/config.toml)

codex mcp add addness --url https://vt.api.addness.com/mcp

2. Vérifier la connexion (c’est fait si Auth est OAuth. Si la connexion ne démarre pas, exécutez codex mcp login addness)

codex mcp list

Cursor

1. Ouvrez ~/.cursor/mcp.json et ajoutez le paramètre suivant (si vous avez d’autres serveurs, n’ajoutez que l’entrée addness)

{
  "mcpServers": {
    "addness": {
      "url": "https://vt.api.addness.com/mcp"
    }
  }
}

2. Dans Settings → Tools & MCP de Cursor, appuyez sur Connect pour addness et approuvez avec votre compte Addness dans le navigateur

Claude Desktop

Ajoutez un MCP distant non pas via un fichier de configuration mais en tant que connecteur personnalisé.

1. Ouvrez Customize → Connectors et choisissez + → Add custom connector
2. Définissez le nom sur Addness et l’URL sur https://vt.api.addness.com/mcp puis enregistrez (sur Team / Enterprise, une configuration de l’organisation par l’Owner est requise)
3. Appuyez sur Connect pour Addness et approuvez dans le navigateur (vous pouvez l’activer par conversation depuis Connectors)

Autres clients compatibles MCP

Tout client MCP prenant en charge Streamable HTTP et OAuth peut se connecter.

1. Définissez le nom du serveur sur addness et le transport sur Streamable HTTP
2. Indiquez https://vt.api.addness.com/mcp comme cible de connexion
3. Connectez-vous à Addness depuis le bouton d’authentification du client ; c’est terminé une fois que la liste des outils est récupérée

Vérifier la connexion

Demandez à votre IA : « Montre-moi la liste de mes organisations Addness ». Si elle répond avec le nom des organisations dont vous faites partie, la connexion fonctionne. Vous pouvez aussi lui demander « Montre-moi mes ToDo dans Addness » et vérifier qu’elle renvoie vos ToDo.

Si vous faites partie de plusieurs organisations, demandez à l’IA avant de commencer à travailler : « Passe à l’organisation 〈nom de l’organisation〉 dans Addness ». L’IA change l’organisation dans laquelle elle travaille (switch_organization). Si elle est déjà connectée à cette organisation, rien ne change. L’organisation choisie est conservée dans les conversations suivantes avec la même IA.

Si elle répond qu’il n’y a pas d’outils Addness ou qu’une authentification est nécessaire, consultez Si la connexion ne fonctionne pas.

Pour transmettre depuis l’écran : Addness it

Au lieu de demander avec des mots, vous pouvez aussi transmettre avec Addness it à droite de la ligne d’un objectif (sur les largeurs mobiles aussi, il se trouve juste à gauche du « … » de la ligne).

• Faire avancer : L’IA lit le contexte de cet objectif et le fait avancer directement
• Réfléchir : L’IA met les choses au clair en discutant avec vous et propose des objectifs enfants. Seuls ceux que vous validez sont créés
• Poser une question : Écrivez ce que vous voulez savoir et transmettez-le : l’IA lit l’objectif et répond. Elle ne modifie pas l’objectif

Appuyez sur « Ouvrir dans Claude », « Ouvrir dans Codex », « Ouvrir dans ChatGPT » ou « Ouvrir dans Grok Bot », et l’IA s’ouvre avec une instruction qui inclut l’URL de l’objectif et la façon de procéder. Avec « Copier les instructions », vous pouvez les coller dans une autre IA comme Cursor et les utiliser. En choisissant la « Destination des instructions » dans la section « AI » de Mes paramètres, l’IA s’ouvre en un clic sans avoir à choisir à chaque fois. Pour une explication détaillée de ce qui se passe, voir la Accueil.

Différence avec l’API des intégrations externes

L’intégration MCP permet à votre IA de lire et d’écrire dans Addness avec votre propre compte connecté. Si vos systèmes doivent seulement lire les membres et les tâches du jour de votre organisation, utilisez l’API des intégrations externes (lecture seule), appelée avec une clé liée à l’organisation. Les clés d’intégration externe ne fonctionnent pas avec MCP. Cette API n’est disponible que pour les organisations activées par Addness.

Si la connexion ne fonctionne pas

Voici les problèmes fréquents et comment les résoudre. Pour installer l’application d’IA et la connecter, consultez Installer une app d’IA et la connecter à Addness.

Les outils Addness ne sont pas disponibles

• Vous avez connecté l’IA, mais elle dit qu’il n’y a pas d’outils Addness : Sur un ordinateur, dans Claude Code ou Codex, Juste après la connexion, les outils n’apparaissent pas tant que vous n’avez pas rouvert l’application d’IA. Quittez l’application, rouvrez-la, choisissez la même conversation et envoyez « continue ». Fermer la fenêtre ne suffit pas à quitter l’application. Sur Mac, quittez-la avec Command + Q. Sur Windows, fermez-la avec Alt + F4 ; si son icône reste en bas à droite de l’écran, faites un clic droit dessus et choisissez « Quitter ». Dans un terminal, appuyez deux fois sur Ctrl + C pour quitter, puis revenez à la même conversation avec claude --resume (pour Codex, codex resume)
• Elle dit toujours qu’il n’y en a pas après la réouverture : Il arrive que Claude Code ne charge les outils Addness qu’au moment de les utiliser. Dites à l’IA : « Cherche les outils Addness et utilise-les »
• Elle demande une autorisation à chaque outil utilisé et s’arrête : Demandez à l’IA : « Fais en sorte de pouvoir utiliser les outils Addness sans me demander à chaque fois ». Dans Claude Code, mcp__addness est alors ajouté à la liste des autorisations du fichier de paramètres (~/.claude/settings.json)
• Vous aviez retiré les outils Addness pour libérer du contexte : Tant qu’ils sont retirés, l’IA ne peut lire ni vos objectifs ni vos tâches dans Addness. Gardez-les connectés quand vous travaillez avec Addness. Si vous les avez retirés, demandez à l’IA « Réactive les outils Addness » et rouvrez l’application
• Addness n’apparaît pas dans Claude ou ChatGPT dans le navigateur : Connectez Addness via le plugin officiel dans ChatGPT ou via un connecteur personnalisé dans Claude depuis le navigateur. Consultez Utiliser Addness uniquement sur un téléphone.

Impossible de se connecter, ou la connexion est coupée

• L’écran de connexion ne s’ouvre pas : Demandez à l’IA : « Lance la connexion à Addness et affiche l’URL ». Collez l’URL affichée dans votre navigateur, ouvrez-la et appuyez sur « Autoriser ». Si l’écran « Autoriser » n’apparaît pas ou si un autre navigateur s’ouvre, consultez « Si cela ne fonctionne pas » dans Installer une app d’IA et la connecter à Addness
• Vous avez appuyé sur « Autoriser », mais une erreur s’affiche : Si l’écran de connexion reste ouvert un certain temps, une erreur comme « Le code d’autorisation n’a pas pu être généré. » s’affiche. Demandez à l’IA de relancer la connexion, puis appuyez tout de suite sur « Autoriser » dans l’écran qui s’ouvre
• Cela fonctionnait avant, mais il faut maintenant se reconnecter, ou la connexion est demandée sans cesse : La connexion à Addness expire 90 jours après avoir été établie. Demandez à l’IA « Reconnecte-toi à Addness » et appuyez sur « Autoriser » dans le navigateur
• Une nouvelle connexion échoue avec une erreur de limite : Chaque personne peut avoir jusqu’à 50 connexions (Outre les connexions de l’IA, les connexions comme celle de l’application de bureau comptent aussi dans ces mêmes 50). Une fois les 50 atteintes, les nouvelles connexions sont refusées (les connexions actuelles restent utilisables). En revanche, quand vous vous connectez dans l’application de bureau, parmi les connexions créées automatiquement par l’application de bureau et d’autres outils, celle qui n’a pas servi depuis le plus longtemps est coupée automatiquement et la nouvelle connexion est créée (les connexions établies depuis une application d’IA ne sont pas coupées). Les anciennes connexions expirent 90 jours après leur création, et vous pouvez alors en créer de nouvelles
• L’écran « Autoriser » affiche « Les connexions IA sont désactivées dans cette organisation. Contactons un administrateur. » : Un administrateur de l’organisation a désactivé les connexions d’IA. Demandez à un administrateur d’activer « Les membres peuvent connecter leur propre IA » dans Paramètres de l’organisation › Accès externe (→ Paramètres de l’organisation). Une fois activé, demandez à l’IA « Reconnecte-toi à Addness »
• Vous avez confondu votre compte professionnel et votre compte personnel : L’IA se connecte au compte indiqué par « Connecté en tant que … » sur l’écran « Se connecter à Addness MCP ». Vérifiez l’adresse e-mail avant d’appuyer sur « Autoriser ». Si vous avez connecté le mauvais compte, reconnectez-vous à Addness dans le navigateur avec le bon compte, puis demandez à l’IA « Reconnecte-toi à Addness »

L’IA est connectée à une autre organisation

• L’IA dit « introuvable », ou elle lit les objectifs d’une autre organisation : L’IA se connecte à l’organisation qui était sélectionnée dans Addness, dans le navigateur, au moment où vous avez appuyé sur « Autoriser ». Si vous faites partie de plusieurs organisations, demandez à l’IA : « Passe à l’organisation 〈nom de l’organisation〉 dans Addness ». Quand vous lui donnez l’URL d’un objectif, faites-la d’abord passer à l’organisation de cet objectif

Blocage sous Windows

• La connexion avec Codex ou les demandes depuis le téléphone s’arrêtent : Il arrive qu’installer l’application Codex ne suffise pas pour pouvoir utiliser la commande codex sur l’ordinateur. Sous Windows, c’était la cause dans certains cas. Demandez à l’IA : « Vérifie si la commande codex fonctionne, et installe-la si ce n’est pas le cas ». Si Codex ne s’ouvre pas quand vous appuyez sur « Ouvrir dans Codex », appuyez sur « Copier l’instruction », collez-la dans Codex et envoyez-la
• Dans Codex pour Windows, la connexion à Addness ne se termine pas : Mettez Codex à jour vers la dernière version, puis reconnectez-vous. Si elle ne se termine toujours pas, vous pouvez aussi vous connecter avec Claude Code

Utiliser Addness uniquement sur un téléphone

• Application ChatGPT : Saisissez « @Addness » dans ChatGPT ou sélectionnez Addness dans la liste des applications. Appuyez sur « Connecter », connectez-vous à Addness et appuyez sur « Autoriser ».
• Application Claude : Dans Safari, ouvrez claude.ai → Personnaliser → Connecteurs → ＋Ajouter → Ajouter un connecteur personnalisé → nom Addness et URL https://vt.api.addness.com/mcp → Connecter et autoriser. Activez Addness dans l’application Claude, collez les instructions et envoyez-les.
• Continuer sur un ordinateur : Suivez Les demandes envoyées depuis un téléphone n’arrivent pas pour envoyer du travail à l’IA sur votre ordinateur.

Impossible de faire une demande depuis le téléphone

« Les demandes envoyées depuis un téléphone n’arrivent pas » explique comment envoyer du travail à l’IA sur un ordinateur. Pour utiliser uniquement un téléphone, consultez « Utiliser Addness uniquement sur un téléphone ».

Addness it dans l’application mobile Addness envoie votre demande à Claude Code ou à Codex sur votre ordinateur. Il faut que l’application de bureau Addness (→ Version web et application de bureau) soit installée sur l’ordinateur, ouverte et connectée avec le même compte Addness, et que l’ordinateur ne soit pas en veille. Utilisez aussi la même organisation sur le téléphone et dans l’application de bureau. Pour préparer tout cela, utilisez Addness it sur l’objectif « Confier des tâches à ton IA depuis ton téléphone » depuis votre ordinateur : l’IA s’en charge. Sur un ordinateur Windows d’entreprise, il arrive que l’application de bureau ne puisse pas fonctionner.

• « L’IA de ton ordinateur n’est pas encore connectée » s’affiche : La préparation de votre ordinateur n’est pas terminée. Ouvrez Addness sur votre ordinateur, appuyez sur Addness it dans la ligne « Confier des tâches à ton IA depuis ton téléphone » et suivez les étapes
• « Démarrera au réveil du PC » reste affiché et rien ne se passe : L’ordinateur est en veille, ou l’application de bureau est fermée. Réveillez l’ordinateur et ouvrez l’application : la demande démarre. Au bout de 24 heures, la demande est annulée
• « Codex introuvable sur le PC » s’affiche : La commande codex n’est pas installée sur votre ordinateur. Demandez à l’IA de votre ordinateur « Installe la commande codex », puis rouvrez l’application de bureau
• Vous utilisez le Codex inclus dans l’application ChatGPT sur Mac : L’application de bureau ne trouve pas le Codex inclus dans l’application ChatGPT. Demandez à l’IA de votre ordinateur « Installe la commande codex », puis rouvrez l’application de bureau (l’application de bureau cherche Codex uniquement dans .local/bin de votre dossier personnel et aux emplacements où le terminal cherche les commandes)
• « Choisissez un dossier de travail dans Addness sur le PC » ou « Aucun dossier de travail n’est choisi dans Addness sur le PC » s’affiche : Ouvrez « リモート操作 » (Contrôle à distance) dans les paramètres de l’application de bureau sur votre ordinateur, et choisissez tout en haut, dans « 作業フォルダ » (Dossier de travail), le dossier où l’IA doit travailler. D’ici là, les demandes n’atteignent ni Claude Code ni Codex
• « Mettez à jour Addness sur le PC » s’affiche : L’application de bureau de votre ordinateur est une ancienne version. Mettez-la à jour vers la dernière version, puis renvoyez
• « « Accepter depuis le téléphone » est désactivé pour Codex dans Addness sur le PC » s’affiche : Ouvrez « リモート操作 » (Contrôle à distance) dans les paramètres de l’application de bureau sur votre ordinateur, et activez « スマホから受け付ける » (Accepter depuis le téléphone) dans la section « Codex » (choisissez d’abord un « 作業フォルダ » (Dossier de travail))
• La demande n’arrive pas à Claude Code : Vérifiez que vous êtes connecté à l’application Claude de votre téléphone avec le même compte Claude que sur votre ordinateur

Toujours pas de connexion

• Aucune étape ne permet de se connecter : Un antivirus ou le réseau de votre entreprise bloque peut-être la communication avec Addness. Dans certains cas, la connexion a fonctionné après avoir exclu vt.api.addness.com de l’analyse dans les paramètres du logiciel. Sur un ordinateur d’entreprise, adressez-vous à votre service informatique
• Rien n’avance malgré tout cela : Contactez-nous depuis « Questions sur Addness (formulaire d’assistance) » sur la page d’accueil de l’aide. Recopiez le message d’erreur tel quel et, si vous avez une capture de l’écran où cela bloque, collez dans le formulaire un lien de partage vers celle-ci

Cet article vous a-t-il été utile ?

OuiNon

← PrécédentInstaller une app d’IA et la connecter à AddnessSuivant →Voir l’utilisation en vidéo

Commencer

• Installer une app d’IA et la connecter à Addness
• Voir l’utilisation en vidéo