MCP dans Claude Code : ajouter des serveurs et savoir où se trouve la configuration

Comment ajouter un serveur MCP à Claude Code

1. Choisissez le transport

   Utilisez HTTP pour les serveurs distants hébergés dans le cloud ; c’est le transport recommandé, et Claude Code se rabat sur le transport SSE, désormais obsolète, quand un serveur ne propose que celui-là. Utilisez stdio pour les serveurs qui tournent comme un processus local. Avec stdio, tout ce qui suit -- est transmis tel quel au serveur.

   # Serveur HTTP distant (recommandé pour les services cloud)
   claude mcp add --transport http notion https://mcp.notion.com/mcp
   
   # Avec un bearer token
   claude mcp add --transport http secure-api https://api.example.com/mcp \
     --header "Authorization: Bearer your-token"
   
   # Serveur stdio local : tout ce qui suit -- est la commande propre du serveur
   claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
     -- npx -y airtable-mcp-server

2. Choisissez une portée

   Sans --scope, un serveur est local : pour vous seul, dans ce projet seulement. Ajoutez --scope project pour l’écrire dans .mcp.json à l’intention de l’équipe, ou --scope user pour tous vos projets. Voir le tableau ci-dessous.

3. Connectez-vous si le serveur l’exige

   Beaucoup de serveurs distants utilisent OAuth. Lancez /mcp dans Claude Code et choisissez le serveur pour vous authentifier, ou claude mcp login <name> dans votre terminal. Les exécutions headless avec -p ne peuvent pas ouvrir le flux de connexion : connectez-vous d’abord en mode interactif.

4. Vérifiez la connexion

   Lancez /mcp pour voir l’état et les outils de chaque serveur, et claude mcp list dans votre terminal. Demandez ensuite à Claude d’utiliser l’outil par son nom.

5. Gérez vos serveurs

   Listez, inspectez, supprimez ou importez des serveurs en ligne de commande. Désactivez depuis /mcp un serveur que vous utilisez rarement plutôt que de le supprimer.

   claude mcp list            # tous les serveurs configurés
   claude mcp get notion      # le détail d'un serveur
   claude mcp remove notion   # le supprimer (lancez d'abord claude mcp logout notion pour révoquer les tokens)
   claude mcp add-from-claude-desktop   # importer depuis Claude Desktop (macOS, WSL)

Source : documentation de Claude Code, Connect Claude Code to tools via MCP

Portées MCP et emplacement des fichiers de configuration

Voici où Claude Code conserve la configuration MCP. Notez que la portée « local » de MCP se trouve dans ~/.claude.json, et non dans .claude/settings.local.json.

Partager des serveurs avec .mcp.json

.mcp.json permet à toute l’équipe d’utiliser les mêmes serveurs. Gardez-en les secrets à l’écart grâce aux variables d’environnement : ${VAR} est remplacé par la valeur de la variable, et ${VAR:-default} prend une valeur par défaut quand elle n’est pas définie. L’expansion fonctionne dans command, args, env, url et headers.

1. Référencez des variables plutôt que des secrets

   Claude Code demande à chaque personne d’approuver les serveurs de projet de .mcp.json la première fois ; claude mcp reset-project-choices réinitialise ces réponses. Une entrée JSON avec une url doit aussi avoir un type, par exemple http.

   {
     "mcpServers": {
       "api-server": {
         "type": "http",
         "url": "${API_BASE_URL:-https://api.example.com}/mcp",
         "headers": {
           "Authorization": "Bearer ${API_KEY}"
         }
       }
     }
   }

Priorité, connecteurs et autres détails

• Quand le même serveur est défini deux fois, Claude Code ne s’y connecte qu’une fois, en retenant le premier dans cet ordre : local, project, user, plugin, connecteur claude.ai. Les entrées ne sont pas fusionnées ; les serveurs gérés d’une organisation passent avant tous les autres.
• Si vous vous connectez à Claude Code avec un compte claude.ai, les connecteurs ajoutés dans claude.ai apparaissent automatiquement.
• Claude Code peut lui-même être un serveur MCP : claude mcp serve expose ses outils à un autre client, comme Claude Desktop.
• Les serveurs peuvent aussi proposer des prompts qui apparaissent comme des commandes slash ; voir les commandes slash de Claude Code.
• Supprimer un serveur distant efface les tokens enregistrés par Claude Code sans les révoquer ; pour cela, lancez d’abord claude mcp logout <name>.

MCP et consommation de tokens

Les définitions d’outils sont chargées à la demande par défaut : seuls les noms des outils et les instructions des serveurs occupent le contexte jusqu’à ce que Claude utilise un outil, si bien qu’une longue liste de serveurs coûte moins cher qu’avant. Chaque serveur ajoute tout de même quelque chose : désactivez dans /mcp ceux que vous n’utilisez pas, et préférez une CLI comme gh, aws ou gcloud quand elle existe, puisqu’elle n’ajoute aucune liste d’outils. Plus de détails dans comment réduire la consommation de tokens de Claude Code.

Dépannage : quand un serveur ne se connecte pas

• Le serveur demande une authentification : ouvrez /mcp et choisissez Re-authenticate, ou lancez claude mcp login <name>.
• « has a url but no type » : ajoutez "type": "http" (ou sse ou ws) à l’entrée JSON ; sans type, Claude Code la traite comme un serveur stdio.
• Les options d’un serveur stdio ont disparu : placez -- avant la commande du serveur pour que Claude Code ne les interprète pas comme les siennes.
• Avertissement de variable manquante dans claude mcp list : définissez la variable ou donnez-lui une valeur :-default.
• Un serveur de projet ne se charge jamais avec claude -p : en mode headless, il n’y a pas de demande d’approbation, donc vérifiez vos paramètres ou passez les serveurs explicitement avec --mcp-config et --strict-mcp-config.
• Les noms de serveurs ajoutés avec claude mcp ne peuvent contenir que des lettres, des chiffres, des tirets et des underscores.

Donnez à vos employés IA les mêmes outils que vous

MCP, c’est ce qui permet à Claude Code d’atteindre votre gestionnaire d’issues, votre base de données ou vos statistiques. Crewmark transforme une session Claude Code, Codex, DeepSeek Harness ou OpenCode en employé IA avec un rôle, un objectif et des horaires de travail, et la réveille à chaque pulsation pour qu’elle prenne la prochaine issue d’un tableau, avec les serveurs MCP de votre projet à disposition.

1. Committez .mcp.json

   Les serveurs de portée projet se chargent dans la session de l’employé comme dans la vôtre ; pour les serveurs qui exigent OAuth, connectez-la une fois en mode interactif.

2. Laissez la pulsation lancer le travail

   Pendant ses horaires de travail, l’employé se réveille toutes les 15, 30 ou 60 minutes dans la même conversation ; voir comment rendre Claude Code proactif.

3. Donnez à chaque rôle uniquement ce dont il a besoin

   Un employé SEO reçoit Search Console ; un développeur, GitHub et Sentry. Découvrez ce qu’est un employé IA.

FAQ MCP pour Claude Code