Connecter Claude à la gestion de projet (MCP)

Une bonne partie du temps qu'un assistant passe sur la gestion de projet se perd en copier-coller. Vous collez un ticket dans la conversation, vous demandez un plan, puis vous recopiez ce plan à la main dans votre outil de suivi. En connectant Claude directement à votre outil de gestion de projet, vous supprimez ces deux allers-retours : Claude lit le tableau lui-même et, si vous l'y autorisez, crée et met à jour le travail lui-même.

Ce guide explique comment faire avec Claude Code, Claude et Claude Desktop, et Cursor. L'exemple utilisé est Atrix, mais les étapes et les vérifications valent pour n'importe quel outil qui expose un serveur MCP.

Qu'est-ce que MCP ?

Le Model Context Protocol (MCP) est un standard ouvert qui permet à un assistant IA d'appeler des outils dans une autre application. Un outil de gestion de projet doté d'un serveur MCP publie une liste d'outils, par exemple « lister mes tickets » ou « créer un ticket », et un client comme Claude Code les appelle pour vous, dans la limite des permissions que vous accordez.

Concrètement, cela change trois choses. L'assistant travaille sur le vrai tableau, et non sur ce que vous avez collé. Il peut agir, et pas seulement proposer. Et chaque action passe par les contrôles de permissions de l'outil lui-même : il ne peut faire que ce que vous pourriez faire vous-même.

Ce qu'il vous faut avant de commencer

Un compte dans l'outil. Pour Atrix, c'est un espace de travail. Il n'existe pas d'offre gratuite : chaque espace de travail démarre par un essai Builder de 7 jours, carte bancaire requise, et le serveur MCP est inclus dans toutes les offres.
L'adresse du serveur. Pour Atrix, c'est https://atrix.dev/api/mcp, servi en Streamable HTTP.
Un client. Claude Code, Claude sur le web ou sur ordinateur, Cursor, ou tout autre client qui parle MCP sur HTTP.

Vous n'avez besoin de créer de clé API pour aucun des clients ci-dessous. Ils se connectent via votre navigateur avec OAuth.

Connecter Claude Code

Claude Code est le meilleur choix si vous voulez un assistant capable de lire votre code et votre tableau dans la même session.

Ajoutez le serveur. Aucun identifiant ne figure dans la commande :
```
claude mcp add --transport http atrix https://atrix.dev/api/mcp
```
Lancez Claude Code, exécutez /mcp, sélectionnez atrix et choisissez Authenticate.
Une fenêtre de navigateur s'ouvre. Connectez-vous, choisissez l'espace de travail et approuvez les scopes. La première connexion ne demande que la lecture.
De retour dans le terminal, vérifiez que tout fonctionne :
```
Who am I connected to Atrix as, and what can you do?
```
Claude appelle atrix_whoami, qui indique la personne, l'espace de travail, les scopes détenus par la connexion et les outils utilisables.

Pour la CI ou un serveur sans navigateur, vous pouvez passer un jeton personnel à la place. Créez-en un dans Atrix sous Settings → Atrix Tokens et gardez-le dans une variable d'environnement :

claude mcp add --transport http atrix https://atrix.dev/api/mcp \
  --header "Authorization: Bearer $ATRIX_TOKEN"

Sur un ordinateur portable, préférez la connexion par navigateur. Un jeton OAuth renouvelable et révocable est préférable, sur le disque, à une clé de longue durée.

Connecter Claude et Claude Desktop

Claude sur le web et Claude Desktop utilisent des connecteurs personnalisés.

Ouvrez Settings → Connectors → Add custom connector.
Donnez-lui un nom et collez l'adresse du serveur :
```
https://atrix.dev/api/mcp
```
Cliquez sur Connect et connectez-vous à Atrix dans la fenêtre qui s'ouvre.

Claude s'enregistre lui-même auprès du serveur : il n'y a ni identifiant client ni secret à créer. Si vous utilisez une offre Claude d'entreprise, un administrateur devra peut-être autoriser les connecteurs personnalisés avant que vous puissiez en ajouter un.

Connecter Cursor

Cursor, comme la plupart des clients qui parlent Streamable HTTP, accepte le même JSON. Placez-le dans .cursor/mcp.json au sein d'un projet, ou dans ~/.cursor/mcp.json pour l'utiliser partout :

{
  "mcpServers": {
    "atrix": { "url": "https://atrix.dev/api/mcp" }
  }
}

Cursor ouvre le navigateur pour la connexion la première fois qu'un outil est appelé. Pour utiliser un jeton à la place :

{
  "mcpServers": {
    "atrix": {
      "url": "https://atrix.dev/api/mcp",
      "headers": { "Authorization": "Bearer atx_pat_…" }
    }
  }
}

Comment fonctionnent les permissions une fois connecté

La première connexion est volontairement en lecture seule. Vous voyez ce que Claude fait de votre tableau avant qu'il puisse y changer quoi que ce soit.

Quand vous demandez une action qui écrit, comme créer un ticket, le serveur répond 403 insufficient_scope en nommant le scope manquant. Un client bien conçu rouvre alors le navigateur pour que vous approuviez exactement ce scope, et rien de plus. Si votre client ne le fait pas, authentifiez-vous de nouveau (dans Claude Code, /mcp) et approuvez-y le scope supplémentaire.

Quelques règles valent pour toutes les connexions :

Les scopes restreignent, ils n'élargissent jamais. Une connexion ne peut jamais faire plus que la personne qui l'a approuvée. Accorder crm.value n'affiche pas le montant des affaires à quelqu'un qui n'a pas le droit de les voir.
Les permissions sont vérifiées à chaque appel. Si quelqu'un perd son accès dans l'espace de travail, toutes ses connexions le perdent au même instant.
Les limites s'appliquent par connexion : 120 appels et 30 écritures par minute. Au-delà, le serveur répond 429 avec un en-tête Retry-After.
Chaque appel est audité : l'outil, le scope et le résultat, enregistrés sous forme d'identifiants, jamais de contenu.
La rémunération n'est jamais accessible. Aucun scope n'atteint un salaire.

Des prompts qui fonctionnent vraiment

Ils correspondent directement aux outils fournis par le serveur Atrix. Inutile de nommer l'outil : Claude le choisit. Les noms sont indiqués pour que vous sachiez à quoi vous attendre dans la demande d'approbation.

Commencer la journée

« Qu'est-ce qui est en retard pour moi cette semaine ? » utilise attention_today, qui renvoie votre travail en retard et à rendre cette semaine, les mentions non lues et les réunions du jour.
« Où en est le produit Website ? Qu'est-ce qui bloque ? » utilise project_status : pourcentage d'avancement, travail par statut, et tout ce qui reste en revue ou en cours depuis plus d'une semaine.

Trouver et lire

« Trouve la spec de tarification et résume les questions ouvertes. » utilise search puis fetch. La recherche porte sur le corps des pages, pas seulement sur les titres.
« Montre-moi tout ce qui est assigné à Zara et en revue. » utilise people_find et work_list_issues.

Créer et modifier le travail (nécessite work.write)

« Crée un ticket dans Website : "Corriger le lien de tarification cassé dans le pied de page", priorité haute, pour vendredi, assigné à moi. » utilise work_create_issue, puis work_schedule_issue et work_assign_issue.
« Passe les trois bugs du paiement en revue et ajoute un commentaire indiquant que le correctif est en préproduction. » utilise work_bulk_update et work_comment_issue.

Du code au tableau (Claude Code)

« Lis les commentaires TODO dans src/billing et crée une tâche par TODO dans Website. Pas de doublons. » Claude lit les fichiers en local et appelle work_create_issue avec ifNotExists, qui renvoie un ticket ouvert existant portant le même titre au lieu de le créer deux fois.

Une chose que le serveur refuse volontairement : un assistant ne peut pas créer d'epic. Les epics, c'est la façon dont vous cadrez le travail ; Claude ouvre donc des stories, des tâches et des bugs, et leur attribue un parent.

Ce qu'il faut vérifier dans le serveur MCP de n'importe quel outil de gestion de projet

Atrix n'est qu'une option. Quel que soit l'outil que vous connectez, vérifiez ces points avant de donner à un assistant un accès en écriture.

OAuth ou clé API. OAuth, c'est un jeton limité à des scopes que vous avez approuvés sur un écran de consentement, et que vous pouvez révoquer sans rien changer d'autre. Une clé API collée donne souvent accès à tout ce que votre compte peut faire, et elle traîne dans un fichier de configuration.
Scopes. Pouvez-vous accorder la lecture sans l'écriture ? Séparer les projets, les clients et les données sur les personnes ? Si le seul choix est « tout », traitez la connexion comme votre mot de passe.
Approbation des écritures. Le client demande-t-il avant chaque écriture, et le serveur indique-t-il quels outils sont en lecture seule ? Un modèle qui comprend mal une demande doit tomber sur une confirmation, pas sur vos données.
Audit. Pouvez-vous voir ce qu'une connexion a fait, et quand ? Un journal des appels d'outils permet de répondre à « qui a fermé ces vingt tickets ? ».
Limites de débit. Une boucle qui s'emballe doit s'arrêter sur une limite, pas à la fin de votre backlog.
Ce que lit le modèle. Le texte et les commentaires des tickets sont lus par le modèle. N'importe qui peut écrire des instructions dans un ticket : gardez l'approbation des écritures pour tout ce qui compte.

En cas de problème

401 : la connexion a expiré ou a été révoquée. Exécutez /mcp et authentifiez-vous de nouveau.
403 insufficient_scope : il manque un scope à la connexion. Approuvez-le quand le navigateur s'ouvre, ou reconnectez-vous avec.
403 sans scope nommé : le scope est là, mais votre compte n'a pas la permission dans l'espace de travail. Demandez à un administrateur.
429 : attendez le nombre de secondes indiqué dans Retry-After. Réessayer en boucle ne fait qu'allonger l'attente.

FAQ

Peut-on connecter Claude à Atrix gratuitement ?

Non. Atrix n'a pas d'offre gratuite. Chaque espace de travail démarre par un essai Builder de 7 jours, carte bancaire requise, et le serveur MCP est inclus dès le premier jour. Builder coûte 39 $ par mois pour 5 places et Studio 149 $ par mois pour 15 ; les offres annuelles bénéficient de 20 % de réduction.

Claude peut-il modifier mon tableau sans demander ?

Pas lors de la première connexion, qui est en lecture seule. Les écritures exigent un scope que vous approuvez dans le navigateur, et les clients comme Claude Code demandent aussi avant d'exécuter un outil, sauf si vous leur avez dit de ne pas le faire.

Atrix voit-il ma conversation avec Claude ?

Non. Le serveur ne voit que les appels d'outils que fait Claude, comme une requête de recherche ou les champs d'un ticket qu'il crée. Le journal d'audit enregistre des identifiants, pas du contenu.

Quel client utiliser ?

Utilisez Claude Code quand le travail part de votre code, par exemple pour transformer des TODO ou un test qui échoue en tickets. Utilisez Claude ou Claude Desktop pour la planification, les questions d'avancement et la rédaction. Utilisez Cursor si c'est là que vous travaillez déjà. Les trois accèdent aux mêmes outils, avec les mêmes limites.

Comment se déconnecter ?

Supprimez le serveur dans le client (claude mcp remove atrix dans Claude Code) et révoquez la connexion dans les paramètres d'Atrix. La révocation dans Atrix prend effet dès la requête suivante.

Essayez sur votre propre tableau

Créez un espace de travail depuis la page tarifs, connectez Claude en suivant les étapes ci-dessus et demandez ce qui est en retard. Le guide du serveur MCP détaille l'installation pour chaque client, et la référence des outils liste chaque outil avec son scope et ses paramètres. Pour une vue d'ensemble, consultez Atrix avec Claude et la page de la fonctionnalité MCP.

Comment connecter Claude à votre outil de gestion de projet avec MCP