Comment partager un serveur MCP avec toute l'équipe dans Claude Code ?

Ajoutez-le en portée project : il est enregistré dans un fichier .mcp.json à la racine du projet, que vous versionnez. Claude Code demande une approbation avant d'utiliser un serveur de portée project.

Comment se connecter à un serveur MCP qui demande OAuth dans Claude Code ?

Tapez /mcp dans Claude Code et suivez la connexion dans le navigateur, ou lancez claude mcp login suivi du nom du serveur dans votre terminal.

Ajouter un serveur MCP à Claude Code : claude mcp add

Pour ajouter un serveur MCP (Model Context Protocol) à Claude Code, on utilise la commande claude mcp add : avec --transport http et une adresse pour un serveur distant, ou avec --transport stdio suivi de -- et de la commande à lancer pour un serveur local. On choisit ensuite où l'enregistrer (portée locale, projet ou utilisateur) et on gère l'authentification avec /mcp. Syntaxe relevée le 15/11/2026 dans la documentation de Claude Code.

Ajouter un serveur distant (HTTP)

La documentation recommande le transport HTTP (le protocole du web) pour les serveurs distants :

claude mcp add --transport http <nom> <adresse>
claude mcp add --transport http notion https://mcp.notion.com/mcp

Si le serveur attend une clé fixe plutôt qu'OAuth (le standard de délégation d'accès), passez-la en en-tête :

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

Le transport SSE (Server-Sent Events, l'ancien mode de diffusion par HTTP) est indiqué comme déprécié : préférez HTTP quand le serveur le propose.

Ajouter un serveur local (stdio)

Pour un programme lancé sur votre poste, le double tiret -- sépare les options de Claude Code (--transport, --env, --scope) de la commande et des arguments du serveur :

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

Les noms ajoutés par claude mcp ne peuvent contenir que des lettres, des chiffres, des tirets et des tirets bas.

Vous avez déjà la définition en JSON ? claude mcp add-json l'accepte directement, par exemple claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp"}'.

Choisir la portée

Portée	Disponible dans	Partagée	Stockée dans
local (par défaut)	Le projet courant seulement	Non	`~/.claude.json`
project	Le projet courant	Oui, par le gestionnaire de versions	`.mcp.json` à la racine du projet
user	Tous vos projets	Non	`~/.claude.json`

La portée project est celle d'une équipe : le fichier .mcp.json se versionne avec le code. Exemple :

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

Claude Code demande une approbation avant d'utiliser un serveur de portée project ; claude mcp reset-project-choices remet ces choix à zéro. Attention à ne jamais mettre de clé en clair dans un .mcp.json versionné.

Gérer et authentifier

claude mcp list            # lister les serveurs
claude mcp get notion      # voir le détail d'un serveur
claude mcp remove notion   # retirer un serveur

Dans une session Claude Code, /mcp affiche l'état des serveurs et lance l'authentification OAuth : la connexion se termine dans le navigateur. Depuis le terminal, claude mcp login <nom> fait la même chose.

Récupérer vos serveurs de Claude Desktop

Si vous avez déjà configuré des serveurs dans Claude Desktop, claude mcp add-from-claude-desktop ouvre une sélection interactive, puis claude mcp list permet de vérifier. Un serveur dont le nom contient un espace ou un autre caractère interdit ne peut pas être importé : l'import le signale et importe les autres.

Utiliser ressources et prompts dans Claude Code

Ressources : tapez @ pour voir les ressources des serveurs connectés, à côté des fichiers. Une ressource précise se cite sous la forme @serveur:protocole://chemin, par exemple @github:issue://123.
Prompts : tapez / ; chaque prompt MCP apparaît sous la forme /serveur:prompt (MCP), et /mcp__serveur__prompt le lance aussi.

Réglages utiles

MCP_TIMEOUT règle le délai de démarrage d'un serveur, en millisecondes : MCP_TIMEOUT=10000 claude donne dix secondes.
MAX_MCP_OUTPUT_TOKENS limite la taille de la réponse d'un outil MCP. La valeur par défaut relevée est de 25 000 jetons, avec un avertissement au-delà de 10 000.
Un outil dont le nom complet (mcp__<serveur>__<outil>) dépasse 128 caractères n'est pas transmis à Claude : gardez des noms courts.

Dans l'autre sens : Claude Code comme serveur

claude mcp serve démarre Claude Code lui-même comme serveur MCP en stdio, pour qu'une autre application s'y connecte. La commande n'affiche rien au démarrage : un terminal silencieux signifie que le serveur attend un client.

Sécurité et administration

La documentation le rappelle : vérifiez que vous faites confiance à chaque serveur avant de le connecter, car un serveur qui récupère du contenu extérieur vous expose à l'injection de prompt (des instructions cachées dans les données). Pour une organisation, Claude Code prévoit une configuration gérée (managed-mcp.json, listes allowedMcpServers et deniedMcpServers) qui fixe les serveurs autorisés. Voir aussi sécurité des serveurs MCP et MCP en entreprise.

Pour écrire le serveur que vous allez ajouter : en Python ou en TypeScript.