Comment ajouter un serveur MCP à Claude Code : commandes, portées et solutions

La manière habituelle de relier Claude Code à un outil consiste à lire trois pages d’installation différentes, à copier une commande légèrement fausse pour ton système, puis à se demander pourquoi rien n’apparaît. Le vrai processus tient en une commande et une vérification, à condition de savoir quel type de serveur tu ajoutes.

Ce guide te donne les commandes pour les trois types de serveur, explique les portées qui décident qui obtient le serveur, et couvre la connexion, la sécurité et les solutions quand ça se passe mal. Si MCP est nouveau pour toi, commence par C’est quoi MCP ?

Ce qu’il te faut

Connecte un serveur quand tu te surprends à copier des données d’un autre outil dans la conversation. Une fois connecté, Claude peut lire dans ce système et y agir directement.

Trois types de serveur

La commande à utiliser dépend de la façon dont le serveur se connecte à toi.

Serveur HTTP distant

La forme de base est la même pour tous les services :

claude mcp add --transport http <name> <url>

Un exemple réel relie Notion :

claude mcp add --transport http notion https://mcp.notion.com/mcp

Si le serveur a besoin d’un jeton, transmets-le dans un en-tête :

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

Serveur SSE distant (obsolète)

La méthode SSE est obsolète, donc utilise HTTP quand le service le propose. Si un service n’a que SSE, la commande emploie un autre transport :

claude mcp add --transport sse asana https://mcp.asana.com/sse

Serveur stdio local

Un serveur stdio est un programme qui s’exécute sur ta propre machine, lancé par Claude Code. La forme de base comporte un double tiret, et tout ce qui suit est la commande qui démarre le serveur :

claude mcp add [options] <name> -- <command> [args...]

Un exemple qui ajoute un serveur Airtable avec une clé d’API :

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

Vérifier que ça a marché

Après avoir ajouté un serveur, vérifie-le depuis ton terminal ou depuis Claude Code.

$ claude mcp list$ claude mcp get notion$ claude mcp remove notion

Dans une session, tape /mcp pour voir l’état de chaque serveur. Tu verras l’un de trois états : connecté, authentification requise, ou échec de connexion.

Se connecter avec OAuth

Beaucoup de serveurs cloud utilisent OAuth 2.0, le mode « connecte-toi avec ton compte ». Le chemin le plus simple tient en deux étapes.

Depuis le shell, tu peux aussi lancer claude mcp login <name> et claude mcp logout <name>. Les jetons sont stockés de façon sécurisée et renouvelés automatiquement. Pour révoquer l’accès, utilise Clear authentication (effacer l’authentification) dans le menu /mcp.

Les portées : qui obtient le serveur

Quand tu ajoutes un serveur, tu choisis sa portée (scope). La portée décide quels projets le voient et si ton équipe le partage.

Choisis-en une avec l’option --scope :

# Project scope: shared with your team
claude mcp add --transport http shared-server --scope project https://example.com/mcp

# User scope: available in all your projects
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

Un serveur de portée projet écrit un fichier .mcp.json à la racine de ton projet, que tu commites pour que tout le monde obtienne la même connexion :

{
  "mcpServers": {
    "shared-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

Si le même nom de serveur apparaît dans plusieurs portées, Claude Code se connecte une seule fois, avec la définition de la source la plus prioritaire : d’abord local, puis projet, puis utilisateur.

Quand tu ouvres un projet qui contient un .mcp.json écrit par quelqu’un d’autre, Claude Code demande ton approbation avant d’utiliser ses serveurs dans une session interactive. Pour réinitialiser ces choix d’approbation, lance claude mcp reset-project-choices.

Des serveurs courants à ajouter dès aujourd’hui

Ces exemples viennent de la documentation officielle. Lis toujours la page du service pour connaître l’adresse actuelle.

Pour la base de données, remarque le nom d’utilisateur : readonly. Donne à Claude un compte de base de données qui peut seulement lire. Ce seul choix écarte l’erreur la plus coûteuse que tu pourrais faire.

Tu peux aussi parcourir les connecteurs contrôlés dans l’annuaire d’Anthropic sur claude.ai/directory. Et si tu as ajouté un connecteur dans claude.ai, il est déjà disponible dans Claude Code quand tu te connectes avec ton compte Claude.

Rester prudent

Un serveur MCP donne à Claude l’accès à un système, et certains serveurs récupèrent du contenu extérieur, comme des pages web ou des tickets écrits par des inconnus.

Ce dernier point touche à la part de travail que Claude fait sans demander. Vois Modes de permission et mode plan de Claude Code, expliqués pour en décider.

Dans Claude Tutorial

Faire confiance à un outil est une décision, pas un réglage par défaut

Juger quels systèmes méritent un accès, et pour quelles actions, est une compétence qui sert bien au-delà du code, et l’appli la fait pratiquer sur des scénarios réels.

Bientôt disponible

Télécharger dans l’App Store

DISPONIBLE SURGoogle Play

Limites et réglages

Deux limites aident à expliquer des comportements qui semblent étranges.

• Gros résultats. Claude Code affiche un avertissement quand la sortie d’un outil dépasse 10 000 jetons, et limite la sortie à 25 000 jetons par défaut. Pour relever la limite, définis la variable MAX_MCP_OUTPUT_TOKENS, par exemple MAX_MCP_OUTPUT_TOKENS=50000.
• Serveurs lents. Pour changer le temps que Claude Code attend le démarrage d’un serveur, définis MCP_TIMEOUT. Par exemple, MCP_TIMEOUT=10000 claude accorde dix secondes.

La recherche d’outils est activée par défaut, pour que ton contexte ne se remplisse pas de toutes les descriptions d’outils à la fois. Lance /context pour voir ce qui prend de la place.

Quand ça ne marche pas

Quand rien de tout cela ne correspond, demande de l’aide à Claude Code : colle l’erreur et demande ce qu’elle signifie. Lancer /doctor vérifie aussi ta configuration.

Questions fréquentes

Comment ajouter un serveur MCP à Claude Code ?

Lance claude mcp add --transport http <name> <url> pour un serveur distant, ou claude mcp add <name> -- <command> pour un serveur local. Lance ensuite /mcp dans Claude Code pour vérifier son état et te connecter.

Où Claude Code stocke-t-il les serveurs MCP ?

Les serveurs de portée local et utilisateur sont stockés dans ~/.claude.json. Les serveurs de portée projet sont stockés dans un fichier .mcp.json à la racine de ton projet, que tu peux commiter.

Quelle différence entre les portées local, projet et utilisateur ?

Local s’applique au projet courant et à toi seul. Projet s’applique au projet courant et se partage avec ton équipe. Utilisateur s’applique à tous tes projets et à toi seul.

Comment supprimer un serveur MCP ?

Lance claude mcp remove <name>. Pour te déconnecter d’un serveur sans le supprimer, utilise claude mcp logout <name>.

Que signifie le double tiret dans claude mcp add ?

Il sépare les options de Claude Code de la commande qui démarre le serveur. Tout ce qui le suit est transmis au serveur tel quel.

Les serveurs MCP sont-ils sûrs ?

Seulement autant que les serveurs que tu choisis et l’accès que tu donnes. Utilise des serveurs de confiance, des comptes de base de données en lecture seule, et un mode de permission où tu vois ce que Claude fait.

Puis-je utiliser mes connecteurs claude.ai dans Claude Code ?

Oui. Les connecteurs que tu ajoutes dans claude.ai sont disponibles dans Claude Code, dans le terminal et dans les sessions cloud, quand tu te connectes avec ton compte Claude.

Ta checklist MCP pour Claude Code

Pour aller plus loin

• C’est quoi MCP ? Le Model Context Protocol expliqué simplement pour l’idée derrière tout cela.
• Comment ajouter des connecteurs dans Claude : annuaire, URL personnalisée et sécurité pour la même chose dans les applis Claude.
• Bonnes pratiques de Claude Code : les habitudes qui donnent de meilleurs résultats pour bien travailler une fois les outils connectés.
• CLAUDE.md expliqué : apprends ton projet à Claude Code une fois pour toutes pour dire à Claude comment utiliser les outils connectés dans ton projet.