MCP dans Claude Code : ajouter et gérer ses serveurs

Pour connecter Claude Code à vos outils sur un vrai projet, la formation Claude Code de Dyma consacre un chapitre à MCP, puis le met en pratique dans son projet fil rouge. Ce guide montre comment ajouter, configurer, authentifier et partager des serveurs MCP dans Claude Code, et ce que cela coûte en contexte. Tout a été vérifié le 2 novembre 2026 sur la documentation officielle d’Anthropic (Claude Code 2.1.316). Il porte sur l’usage de MCP dans Claude Code ; le protocole lui-même et l’écriture d’un serveur feront l’objet d’un article dédié.

MCP dans Claude Code, en deux mots

MCP est un protocole ouvert qui décrit comment un outil expose ses fonctions à un modèle d’IA. Un serveur MCP propose des outils (créer un ticket, lire une erreur, interroger une base), parfois des ressources et des prompts. Une fois le serveur ajouté, Claude Code voit ces outils et les appelle quand la tâche l’exige, en vous demandant la permission comme pour ses propres outils.

Si vous êtes connecté avec un compte claude.ai, les connecteurs que vous avez ajoutés sur claude.ai sont aussi disponibles dans Claude Code, sans rien configurer.

Ajouter un serveur MCP

La commande claude mcp add se lance dans votre terminal, hors de Claude Code. Elle prend un transport, un nom, puis une adresse ou une commande.

Un serveur distant, avec un en-tête d’authentification si le service en demande un :

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

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

Un serveur local. Le double tiret sépare les options de Claude Code de la commande qui lance le serveur ; --env lui passe ses variables :

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

Depuis la version 2.1.265, un serveur déclaré en HTTP qui ne parle que l’ancien protocole bascule de lui-même en SSE. Les noms de serveur n’acceptent que lettres, chiffres, tirets et tirets bas.

Si vous avez déjà la configuration JSON d’un serveur, claude mcp add-json l’accepte telle quelle :

claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

Les trois portées : local, projet, utilisateur

L’option --scope décide où le serveur est enregistré, et qui en profite :

Par exemple, claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic rend HubSpot disponible dans tous vos projets. Quand deux portées déclarent un serveur du même nom, la portée locale l’emporte, puis le projet, puis l’utilisateur.

Partager un serveur avec l’équipe : .mcp.json

La portée project écrit le fichier .mcp.json à la racine du dépôt. Pour ne pas y committer de secret, utilisez des variables d’environnement, avec une valeur par défaut si besoin :

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

Par sécurité, en session interactive, Claude Code demande votre accord avant d’utiliser un serveur déclaré dans le .mcp.json d’un projet ; pour revenir sur vos choix, lancez claude mcp reset-project-choices. En mode non interactif (claude -p), ces serveurs se chargent sans demander : sur un dépôt que vous ne connaissez pas, ajoutez --strict-mcp-config pour ne charger que les serveurs que vous indiquez.

Se connecter à un serveur avec OAuth

Beaucoup de services distants demandent une connexion à votre compte. Claude Code gère OAuth 2.0 :

1. Ajoutez le serveur, par exemple claude mcp add --transport http sentry https://mcp.sentry.dev/mcp.
2. Tapez /mcp dans Claude Code et choisissez le serveur.
3. Autorisez l’accès dans le navigateur qui s’ouvre.
4. C’est fait : le jeton est stocké de façon sécurisée et renouvelé automatiquement.

Depuis le terminal, claude mcp login sentry fait la même chose, et claude mcp logout sentry retire l’accès. Le mode non interactif (claude -p) ne peut pas mener cette connexion : faites-la d’abord en session interactive.

Gérer ses serveurs

claude mcp list           # tous les serveurs configurés
claude mcp get notion     # le détail d'un serveur
claude mcp remove notion  # le retirer

Dans Claude Code, /mcp affiche l’état de chaque serveur (connecté, authentification requise, échec de connexion, en attente d’approbation) et permet de le reconnecter, de l’activer ou de le désactiver.

Vous utilisez déjà des serveurs dans l’application Claude Desktop ? Sur macOS et WSL, claude mcp add-from-claude-desktop vous propose de choisir lesquels importer.

MCP et contexte : ce que coûtent les outils

Chaque outil a une description, et des dizaines d’outils pèsent dans le contexte. Claude Code règle ce problème par défaut avec la recherche d’outils : au démarrage, il ne charge que les noms des outils et les instructions des serveurs, et va chercher la définition complète d’un outil quand il en a besoin. La variable ENABLE_TOOL_SEARCH=false désactive ce comportement.

Quand la réponse d’un outil dépasse 25 000 jetons (le seuil par défaut, avec un avertissement dès 10 000), Claude Code l’enregistre dans un fichier et y renvoie Claude, qui la lit au besoin. Pour un serveur qui renvoie de gros volumes, vous pouvez relever ce seuil :

export MAX_MCP_OUTPUT_TOKENS=50000
claude

Ressources et prompts des serveurs

Un serveur MCP peut exposer plus que des outils. Ses ressources se mentionnent avec @, comme un fichier : @github:issue://123 insère un ticket GitHub dans votre demande. Ses prompts deviennent des commandes, affichées dans le menu sous la forme /github:pr_review ; la forme /mcp__github__pr_review 456 fonctionne aussi.

Sécurité : choisir ses serveurs

L’avertissement de la documentation est court : vérifiez que vous faites confiance à chaque serveur avant de le connecter. Un serveur qui va chercher du contenu extérieur (pages web, tickets, e-mails) vous expose à l’injection de prompt : un texte malveillant peut tenter de détourner Claude. Préférez les serveurs officiels des éditeurs, donnez-leur les droits minimaux, et gardez les confirmations pour les outils qui modifient des données. En entreprise, l’administrateur peut fixer la liste des serveurs autorisés.

Claude Code comme serveur MCP

L’inverse est possible : claude mcp serve expose les outils de Claude Code (lire, modifier des fichiers, lancer des commandes) à un autre client MCP, comme Claude Desktop. La documentation prévient que c’est alors à ce client de demander confirmation avant chaque appel d’outil.

Aller plus loin

MCP donne des outils à Claude ; les autres modules lui disent comment s’en servir. Un skill peut décrire la procédure qui utilise un serveur, CLAUDE.md en rappeler les règles, et un hook peut même appeler un outil MCP. Pour démarrer, voyez installer Claude Code et notre tutoriel Claude Code.

La formation Claude Code vous fait connecter vos outils sur un projet complet. Pour comprendre le protocole en profondeur et intégrer MCP dans vos propres agents, la formation IA pour développeurs va plus loin ; pour utiliser les connecteurs dans l’application Claude, voyez la formation Claude.

Questions fréquentes