Source: https://claudetutorial.com/guides/fr-fr/comment-ajouter-un-serveur-mcp-a-claude-code-commandes-portees-et-solutions [Retour aux Guides](https://claudetutorial.com/guides/fr-fr) Builders # Comment ajouter un serveur MCP à Claude Code : commandes, portées et solutions 27 octobre 2026 12 min de lecture --- 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. > Chaque serveur MCP que tu ajoutes à Claude Code se résume à une commande : claude mcp add, suivie de la façon dont il se connecte. 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 ?](https://claudetutorial.com/guides/fr-fr/c-est-quoi-mcp-le-model-context-protocol-explique-simplement) ## Ce qu’il te faut - Claude Code installé et fonctionnel. Sinon, vois [Claude Code pour débutants](https://claudetutorial.com/guides/fr-fr/claude-code-pour-debutants-installer-se-connecter-et-lancer-une-premiere-tache) - L’adresse du serveur (pour un serveur distant) ou sa commande de démarrage (pour un serveur local), tirée de la documentation du service - Un compte chez le service que tu relies 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. | Type | Comment il se connecte | À utiliser pour | | --- | --- | --- | | **HTTP distant** | Une adresse web sur Internet | La plupart des services cloud. Le choix recommandé | | **SSE distant** | Une adresse web avec une méthode plus ancienne | Les services qui ne proposent que cela. Obsolète, donc préfère HTTP quand c’est possible | | **stdio local** | Un programme qui s’exécute sur ta machine | Les fichiers, bases de données et outils locaux | ### Serveur HTTP distant La forme de base est la même pour tous les services : ``` claude mcp add --transport http ``` 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] -- [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 ``` N’oublie pas le double tiret Tout ce qui suit `--` est transmis au serveur tel quel. Sans lui, Claude Code essaie de lire les options du serveur comme les siennes, et la commande échoue de façon déroutante. ## Vérifier que ça a marché Après avoir ajouté un serveur, vérifie-le depuis ton terminal ou depuis Claude Code. Terminal ``` $ claude mcp list$ claude mcp get notion$ claude mcp remove notion ``` Liste tous les serveurs configurés, affiche les détails de l’un d’eux, ou supprime-en un. 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. | État | Ce que ça signifie | Que faire | | --- | --- | --- | | Connecté | Le serveur est prêt | Demande à Claude de l’utiliser | | Authentification requise | Tu ne t’es pas encore connecté | Lance `/mcp` et suis la connexion dans le navigateur | | Échec de connexion | Claude Code n’a pas pu l’atteindre ou le démarrer | Vois les solutions plus bas | ## 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. 1. Ajoute le serveur Par exemple : `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` 2. Authentifie-toi Dans Claude Code, lance `/mcp` et suis les étapes de connexion dans ton navigateur. Depuis le shell, tu peux aussi lancer `claude mcp login ` et `claude mcp logout `. 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. | Portée | Disponible dans | Partagé avec ton équipe | Stocké dans | | --- | --- | --- | --- | | **Local** (par défaut) | Le projet courant uniquement | Non | `~/.claude.json` | | **Project** | Le projet courant uniquement | Oui, via le contrôle de version | `.mcp.json` à la racine du projet | | **User** | Tous tes projets | Non | `~/.claude.json` | 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. L’emporte en premier L’emporte en dernier 1. Local Ce projet seulement, toi seul, stocké dans ~/.claude.json 2. Project Partagé avec ton équipe via .mcp.json 3. User Tous tes projets, toi seul, stocké dans ~/.claude.json Utilise la portée projet pour les outils dont toute l’équipe a besoin, la portée utilisateur pour tes outils personnels, et local pour tester. 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. | Service | Commande | | --- | --- | | Sentry (erreurs) | `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` | | Stripe (paiements) | `claude mcp add --transport http stripe https://mcp.stripe.com` | | GitHub (revues de code) | `claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer YOUR_GITHUB_PAT"` | | Notion | `claude mcp add --transport http notion https://mcp.notion.com/mcp` | | PostgreSQL via DBHub | `claude mcp add --transport stdio db -- npx -y @bytebase/dbhub --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"` | 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. Vérifie que tu fais confiance à chaque serveur Les serveurs qui récupèrent du contenu extérieur peuvent t’exposer à l’injection de prompt : un texte écrit pour tromper une IA et lui faire faire ce que tu n’as pas demandé. N’ajoute que des serveurs de sources de confiance, et regarde ce que Claude prévoit d’en faire. - Le serveur vient de la documentation du service, pas d’un message au hasard - Les bases de données utilisent un compte en lecture seule - Les jetons vont dans des en-têtes ou des variables d’environnement, jamais dans un fichier que tu commites - Tu travailles dans un mode de permission où tu vois ce que Claude fait avec les outils 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](https://claudetutorial.com/guides/fr-fr/modes-de-permission-et-mode-plan-de-claude-code-expliques) 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 [DISPONIBLE SUR Google Play](https://play.google.com/store/apps/details?id=com.claudetutorial.mobile) ## 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 | Ce que tu vois | Cause probable | Solution | | --- | --- | --- | | Le serveur manque dans `claude mcp list` | Il a été ajouté dans une autre portée ou un autre projet | Lance `claude mcp list` depuis le projet où tu l’as ajouté, ou ajoute-le avec `--scope user` | | `/mcp` affiche authentification requise | Tu ne t’es pas connecté | Lance `/mcp` et suis les étapes dans le navigateur, ou `claude mcp login ` | | `/mcp` affiche échec de connexion | Mauvaise adresse, serveur en panne, ou commande de démarrage qui échoue | Vérifie l’URL dans la documentation du service. Pour un serveur local, lance sa commande dans ton terminal pour voir l’erreur | | Les options d’un serveur local sont rejetées | Le double tiret manque | Ajoute `--` avant la commande du serveur | | Ça marche dans un projet mais pas dans un autre | La portée local ne s’applique qu’à un projet | Ajoute-le de nouveau avec `--scope user`, ou en portée projet pour une équipe | | Claude ignore un serveur de projet | L’approbation du `.mcp.json` a été refusée | Lance `claude mcp reset-project-choices` et approuve de nouveau | | La sortie est coupée | La valeur par défaut de 25 000 jetons | Relève `MAX_MCP_OUTPUT_TOKENS` | 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 ` pour un serveur distant, ou `claude mcp add -- ` 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 `. Pour te déconnecter d’un serveur sans le supprimer, utilise `claude mcp logout `. ### 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 - `claude mcp list` affiche le serveur et `/mcp` le montre comme connecté - Tu as choisi la portée exprès : local pour tester, projet pour l’équipe, utilisateur pour toi - Les identifiants vivent dans des en-têtes ou des variables d’environnement, pas dans des fichiers commités - Tout ce qui touche des données que tu ne peux pas restaurer passe par un accès en lecture seule ## Pour aller plus loin - [C’est quoi MCP ? Le Model Context Protocol expliqué simplement](https://claudetutorial.com/guides/fr-fr/c-est-quoi-mcp-le-model-context-protocol-explique-simplement) pour l’idée derrière tout cela. - [Comment ajouter des connecteurs dans Claude : annuaire, URL personnalisée et sécurité](https://claudetutorial.com/guides/fr-fr/comment-ajouter-des-connecteurs-dans-claude-annuaire-url-personnalisee-et-securite) pour la même chose dans les applis Claude. - [Bonnes pratiques de Claude Code : les habitudes qui donnent de meilleurs résultats](https://claudetutorial.com/guides/fr-fr/bonnes-pratiques-de-claude-code-les-habitudes-qui-donnent-de-meilleurs-resultats) pour bien travailler une fois les outils connectés. - [CLAUDE.md expliqué : apprends ton projet à Claude Code une fois pour toutes](https://claudetutorial.com/guides/fr-fr/claude-md-explique-apprends-ton-projet-a-claude-code-une-fois-pour-toutes) pour dire à Claude comment utiliser les outils connectés dans ton projet.