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.

Pour les débutants : les personnes qui créent une nouvelle organisation et celles qui rejoignent une organisation sur invitation trouvent « Configurer Addness » sur leur page des objectifs. Sur la ligne « 1. Connecter ton IA à Addness » qu'il contient, appuyez sur « Demander à l'IA » → « Ouvrir dans Claude Code » (ou « Ouvrir dans Codex ») : l'IA avance dans l'ordre, à commencer par la connexion à Addness (→ page Objectif). 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

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

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

claude mcp login addness

1. 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

1. 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"
    }
  }
}

1. 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 : « Demander à l'IA »

Au lieu de demander avec des mots, vous pouvez aussi transmettre depuis le ✦ (« Demander à l'IA ») à droite de la ligne d'un objectif (sur les largeurs mobiles, « … » de la ligne → « Demander à l'IA »).

• 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 Code », « Ouvrir dans Codex » ou « Ouvrir dans ChatGPT », 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 page Objectif.

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 au bout de 90 jours. Elle est coupée plus tôt dans les cas suivants. Si vous vous reconnectez depuis la même application d'IA, la connexion précédente de cette application est coupée. Chaque personne peut avoir jusqu'à 20 connexions ; au-delà, c'est la connexion inutilisée depuis le plus longtemps qui est coupée en premier (si vous utilisez plusieurs ordinateurs ou plusieurs IA, d'anciennes connexions peuvent être coupées ainsi). Demandez à l'IA « Reconnecte-toi à Addness » et appuyez sur « Autoriser » dans le navigateur
• 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

<a id="mobile-only"></a>

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.

<a id="phone-pc-relay"></a>

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 ».

« Demander à l'IA » 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, confiez à l'IA de votre ordinateur l'objectif « Confier des tâches à ton IA depuis ton téléphone » : 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 « Demander à l'IA » (✦) sur « 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 : Joignez une capture de l'écran où cela bloque et contactez-nous depuis « Questions sur Addness » sur la page d'accueil de l'aide