Workbranch › Guides

Comment connecter des serveurs MCP à Claude Code

Les serveurs MCP donnent à Claude Code accès à des outils extérieurs à votre code, comme un gestionnaire de tickets, une base de données ou un outil de design. Ce guide montre les commandes pour en ajouter un, où le réglage est enregistré, comment vous connecter et comment savoir s'il fonctionne.

Mis à jour le 30 octobre 2026

Les commandes ci-dessous suivent la documentation Claude Code d'Anthropic en octobre 2026. Les commandes claude mcp se lancent dans votre terminal habituel, pas à l'intérieur d'une session Claude Code.

Ajouter un serveur distant (le cas le plus courant)

Un service hébergé vous donne une adresse web pour son serveur MCP, que vous trouverez dans ses propres instructions de configuration. Anthropic recommande le transport HTTP pour ces serveurs.

1. Dans votre terminal, faites cd vers le projet avec lequel vous l'utiliserez.
2. Lancez claude mcp add --transport http notion https://mcp.notion.com/mcp, en remplaçant le nom et l'adresse par les vôtres. Le nom est celui que vous verrez dans les listes et dans /mcp.
3. Si le service utilise une clé d'API plutôt qu'une connexion, passez-la en en-tête : --header "Authorization: Bearer your-token".

Les serveurs plus anciens ne proposent parfois que SSE, qui est obsolète. Les versions récentes de Claude Code essaient d'abord HTTP et basculent d'elles-mêmes sur SSE ; sur les versions plus anciennes, utilisez --transport sse.

Ajouter un serveur local

Un serveur local (stdio) est un programme qui tourne sur votre ordinateur, souvent lancé avec npx.

1. Écrivez d'abord les options de Claude, puis --, puis la commande propre au serveur : claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server.
2. Claude Code transmet tel quel au programme serveur tout ce qui suit --. Sans ce séparateur, les options destinées au serveur (comme -y) sont lues comme des options de Claude Code.
3. Quand vous utilisez --env, placez une autre option entre celle-ci et le nom du serveur, comme dans l'exemple, sinon le nom est lu comme une variable de plus.

Choisir une portée

Choisissez user pour les outils que vous voulez partout, comme votre application de notes, et project pour les outils dont toute l'équipe a besoin dans un dépôt. Si un même serveur est défini à plusieurs endroits, Claude Code ne se connecte qu'une fois, dans cet ordre de priorité : local, project, user, puis les serveurs des plugins, puis les connecteurs claude.ai. Les trois portées sont comparées par nom ; les serveurs de plugins et les connecteurs comptent comme doublons lorsqu'ils pointent vers la même adresse ou la même commande. L'entrée retenue est utilisée en entier ; les champs ne sont pas combinés.

Ne mettez pas de secrets directement dans un .mcp.json partagé. Il accepte des variables comme ${API_KEY} ou ${API_BASE_URL:-https://api.example.com}, que chacun définit dans son propre environnement.

Se connecter à un serveur qui demande un compte

1. Lancez Claude Code avec claude.
2. Tapez /mcp. Le panneau liste les serveurs auxquels vous devez encore vous connecter.
3. Sélectionnez le serveur et suivez la connexion dans le navigateur. Le token est enregistré sur votre ordinateur et renouvelé pour vous.
4. Vous pouvez aussi lancer claude mcp login name depuis votre shell. Déconnectez-vous avec claude mcp logout name.

Certains services exigent d'abord d'y enregistrer une application. Dans ce cas, ajoutez le serveur avec --client-id, --client-secret (il vous sera demandé de le saisir) et, si leur configuration exige une redirection fixe, --callback-port.

Vérifier que cela fonctionne

• claude mcp list affiche chaque serveur avec son statut : Connected, Needs authentication, Failed to connect, Pending approval ou Disabled for this project.
• claude mcp get name affiche les détails d'un serveur, y compris l'erreur HTTP en cas d'échec.
• Dans une session, /mcp affiche le même statut et permet de se reconnecter.
• Enfin, demandez à Claude une action que seul ce serveur peut faire, comme « liste mes tickets Linear ouverts ».

Supprimez un serveur avec claude mcp remove name.

Bon à savoir

• Les serveurs de projet demandent d'abord : la première fois qu'une session trouve des serveurs dans le .mcp.json d'un dépôt, Claude Code vous demande de les approuver. Annulez vos choix avec claude mcp reset-project-choices. N'approuvez que les serveurs de dépôts en qui vous avez confiance.
• Les permissions s'appliquent toujours : chaque appel d'outil MCP peut vous demander une confirmation comme n'importe quel autre outil ; voir comment gérer les permissions dans Claude Code.
• Résultats volumineux : Claude Code avertit quand un outil renvoie plus de 10 000 tokens et limite la sortie à 25 000 par défaut. Augmentez cette limite avec la variable d'environnement MAX_MCP_OUTPUT_TOKENS.
• Plugins : certains plugins apportent leurs propres serveurs MCP ; installer un plugin peut donc être plus simple. Voir comment installer des plugins dans Claude Code.

Si cela ne fonctionne pas

• Failed to connect : lancez claude mcp get name pour voir l'erreur, vérifiez l'URL, puis lancez /mcp reconnect all dans une session (versions récentes) pour réessayer.
• Un serveur local lent dépasse le délai au démarrage : lancez Claude Code avec une limite plus longue, par exemple MCP_TIMEOUT=10000 claude (en millisecondes).
• « has a url but no type » : il manque "type": "http" dans une entrée JSON pour un serveur distant.
• La clé d'API est refusée : Claude Code avertit en cas d'espaces ou de retours à la ligne au début ou à la fin d'un en-tête. Ajoutez de nouveau le serveur avec un token collé proprement.

Sources

• Claude Code user FAQ (centre d'aide Claude, consulté le 30 octobre 2026)
• Connect Claude Code to tools via MCP (documentation Claude Code, consultée le 30 octobre 2026)

Questions fréquentes