Intégration Claude Code MCP : Connecter des outils à l'agent

Mis à jour le: June 28, 2026

De base, Claude Code lit et modifie des fichiers et exécute des commandes shell. Il ne peut pas lire vos problèmes GitHub, interroger votre base de données ou piloter un navigateur. Le Model Context Protocol (MCP) comble cette lacune : c'est le plug standard qui permet à l'agent de communiquer avec des outils et des données externes. Ce guide montre les commandes exactes claude mcp add, quand choisir un serveur local par rapport à un serveur distant, comment fonctionnent les scopes, quels serveurs valent la peine d'être connectés, et les vérifications de sécurité à effectuer avant de faire confiance à l'un d'eux.

Réponse rapide : comment ajouter un serveur MCP à Claude Code ?

Vous enregistrez un serveur avec la commande claude mcp add, puis Claude Code peut appeler ses outils pendant une session.

Pour un serveur local qui s'exécute comme un processus sur votre machine :

claude mcp add playwright -- npx -y @playwright/mcp@latest

Pour un serveur distant atteint via HTTPS :

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Après avoir ajouté un serveur, exécutez /mcp dans Claude Code pour voir son statut de connexion et compléter tout enregistrement OAuth. Utilisez claude mcp list pour confirmer qu'il est enregistré. La référence des commandes officielles se trouve dans les docs MCP de Claude Code.

Qu'est-ce que MCP, et pourquoi le connecter à Claude Code ?

MCP est un protocole ouvert, publié pour la première fois par Anthropic, qui définit comment un client IA et un serveur d'outils échangent des capacités. Un serveur annonce des outils (actions que l'agent peut effectuer), des ressources (données qu'il peut lire) et des prompts. Tout client conscient de MCP peut utiliser n'importe quel serveur MCP, donc un serveur GitHub fonctionne dans Claude Code, un IDE ou un autre agent sans colle personnalisée. La spécification et le registre des serveurs se trouvent sur modelcontextprotocol.io.

Le bénéfice pratique : au lieu de coller le corps d'un problème dans le chat, vous connectez le serveur GitHub une seule fois et demandez à l'agent de lire, étiqueter et répondre aux problèmes directement. Pour un contexte plus approfondi sur le protocole lui-même, consultez notre explication MCP, et pour le guide ultime des outils en contexte, le guide ultime de Claude Code.

Un serveur peut être un minuscule script stdio que vous avez écrit, une image Docker ou un point de terminaison SaaS hébergé par un fournisseur. Claude Code les traite tous de la même manière une fois qu'ils parlent MCP.

Quel transport utiliser : local ou distant ?

Le transport est comment Claude Code atteint le serveur. Les serveurs locaux s'exécutent sur votre machine via stdio ; les serveurs distants s'exécutent ailleurs et répondent via HTTP ou SSE. Le choix dépend généralement de l'endroit où résident les données.

Utilisez un serveur stdio local lorsque l'outil a besoin de fichiers ou de services sur votre ordinateur portable, comme un dossier d'assets de projet ou une instance Postgres sur localhost. Utilisez un serveur HTTP ou SSE distant lorsqu'un fournisseur l'héberge déjà, car vous sautez l'installation et obtenez des mises à jour sans toucher à votre configuration. Les serveurs distants vous connectent presque toujours via OAuth, que vous déclenchez depuis le menu /mcp.

Choisir un scope : local, projet ou utilisateur

Le Scope détermine qui voit le serveur et où la configuration est stockée. Claude Code prend en charge trois options, et choisir la bonne permet de garder les secrets hors de votre dépôt tout en partageant des serveurs sûrs avec l'équipe.

Définissez le scope avec le flag --scope, par exemple claude mcp add --scope project .... Le scope projet écrit un .mcp.json soumis, ne mettez donc jamais de jeton brut ; référencez plutôt une variable d'environnement. Le scope local est le défaut et l'endroit le plus sûr pour tester un nouveau serveur avant de s'engager à le partager. Si vous construisez également des compétences Claude Code, gardez la cohérence entre le scope du serveur et le scope de la compétence afin qu'un coéquipier qui récupère le dépôt ait une configuration fonctionnelle.

Comment ajouter un serveur avec claude mcp add ?

Le modèle est le même pour chaque serveur : un nom, un flag de transport optionnel et la commande ou l'URL. Le séparateur -- marque le début de la commande locale et de ses arguments.

Ajouter un serveur système de fichiers local limité à un dossier afin que l'agent ne puisse toucher que ce que vous autorisez :

claude mcp add filesystem -- \
  npx -y @modelcontextprotocol/server-filesystem ~/projects/my-app

Passer des secrets comme variables d'environnement au lieu de les coder en dur :

claude mcp add my-api --env API_KEY=your_key_here -- node ./my-mcp-server.js

Ajouter un serveur distant avec son transport et son URL :

claude mcp add --transport sse linear https://mcp.linear.app/sse

Puis gérer ce que vous avez :

• claude mcp list affiche chaque serveur enregistré et son statut.
• claude mcp get <name> affiche la configuration d'un serveur.
• claude mcp remove <name> le désenregistre.
• /mcp (tapé dans une session) montre l'état de connexion en direct et exécute OAuth.

Gardez l'utilisation des flags proche de la documentation officielle ; les fournisseurs peuvent occasionnellement changer le nom du package ou l'URL d'un serveur, alors copiez la valeur actuelle du README du serveur plutôt que de deviner.

Serveurs MCP courants à connecter

Commencez par un serveur qui élimine une tâche réelle, prouvez-le, puis ajoutez-en plus. Ce sont ceux que les développeurs recherchent en premier, et ce qu'ils débloquent chacun.

Le Playwright MCP server est exceptionnel pour le travail front-end : l'agent ouvre votre page, clique à travers un flux et signale ce qui a échoué avec une capture d'écran. Un serveur de base de données est pratique pour les questions de schéma en lecture seule, mais scopez-le sur une réplique de lecture afin qu'une requête errante ne puisse jamais écrire. Lorsque vous commencez à chaîner plusieurs serveurs ensemble, dirigez le travail lourd vers un worker dédié en utilisant Claude Code subagents pour que la session principale reste réactive.

Scénario : connecter un serveur MCP GitHub pour ouvrir des PRs

Disons que vous voulez que l'agent trie les problèmes et ouvre des pull requests dans un seul dépôt. GitHub héberge un serveur MCP distant officiel, donc vous n'installez rien localement.

1. Enregistrer le serveur hébergé :

   claude mcp add --transport http github https://api.githubcopilot.com/mcp/
   

2. Tapez /mcp dans Claude Code, sélectionnez github, et complétez l'enregistrement OAuth dans votre navigateur. Le jeton reste chez GitHub ; vous ne le collez jamais dans un fichier.

3. Confirmez les outils chargés avec claude mcp list.

4. Demandez ensuite en langage simple :

   • "Lister les problèmes ouverts étiquetés bug et résumer les trois premiers."
   • "Ouvrir une PR brouillon de fix/login-redirect vers main avec une courte description."
   • "Lire la PR #214 et signaler tout ce qui touche à l'authentification."

L'agent lit les fils de problèmes, rédige le corps de la PR et lie le problème approprié, le tout sans que vous quittiez le terminal. Accordez d'abord un accès au GitHub app à un seul dépôt, révisez ce que propose l'agent, et élargissez l'accès uniquement lorsque vous faites confiance au flux. La liste complète des outils du serveur et l'option d'auto-hébergement sont documentées dans le repo du serveur MCP GitHub.

Est-ce sûr de connecter un serveur MCP ?

Un serveur MCP peut exécuter du code sur votre machine ou agir sur vos comptes, traitez donc chacun comme l'installation d'une dépendance : connectez uniquement les serveurs en qui vous avez confiance. Le risque est réel car un serveur malveillant ou bogué pourrait exfiltrer des fichiers ou effectuer des actions destructrices avec vos identifiants.

Suivez cette liste de contrôle avant d'ajouter un serveur :

• Confirmer la source. Préférez les serveurs officiels des fournisseurs (GitHub, Sentry) ou les serveurs de référence publiés plutôt qu'un package inconnu.
• Lire quels outils il expose. Un serveur "lire mes problèmes" ne devrait pas demander un accès d'écriture à tout votre disque.
• Scoper étroitement. Pointer les serveurs système de fichiers sur un seul dossier de projet et les serveurs de base de données sur une réplique de lecture.
• Garder les secrets hors de .mcp.json. Utiliser des variables d'environnement et ne jamais commiter un jeton réel.
• Accorder le moindre privilège sur OAuth. Donner à un GitHub app un dépôt, pas tout votre org, jusqu'à ce que vous ayez confiance.
• Réviser les actions avant d'approuver. Lire la PR ou interroger l'agent proposé ; ne pas approuver automatiquement les écritures provenant d'un nouveau serveur.

Anthropic signale le risque d'injection de prompts pour les serveurs qui récupèrent du contenu web non fiable, soyez donc extra-vigilant avec tout serveur qui extrait des pages arbitraires. Les directives de sécurité actuelles se trouvent dans les docs MCP de Claude Code.

Dépannage des connexions MCP

La plupart des échecs sont de configuration ou d'authentification, pas du protocole. Traitez-les dans cet ordre :

• Serveur non listé : réexécuter claude mcp list. S'il manque, la commande add a probablement échoué ; vérifiez s'il y a une faute de frappe dans le séparateur -- ou le nom du package.

• Statut affiche échec dans /mcp : le processus n'a pas pu démarrer. Pour les serveurs stdio, exécutez la commande brute (par exemple la ligne npx) dans votre terminal pour voir l'erreur réelle.

• Échec de l'authentification : ouvrir /mcp, sélectionner le serveur et refaire le flux OAuth. Pour les serveurs basés sur des jetons, confirmez que la variable d'environnement est définie dans le shell qui a lancé Claude Code.

• Outils non visibles : redémarrer la session Claude Code pour qu'elle recharge les capacités du serveur, puis vérifier que le scope est visible par le projet actuel.

• Scope incorrect : un serveur ajouté avec --scope local ne sera pas visible pour les coéquipiers ; réajoutez-le avec --scope project s'il doit être partagé.

Lorsqu'un serveur distant change son URL ou qu'un package est renommé, votre configuration enregistrée devient obsolète. Récupérez la valeur actuelle du README du serveur et réajoutez-la plutôt que de modifier à l'aveugle.

Conclusion

MCP transforme Claude Code d'un agent fichier/shell en un agent qui communique avec vos outils réels. Ajoutez des serveurs avec claude mcp add, choisissez stdio pour les données locales et HTTP/SSE pour les services hébergés, et définissez le scope par qui devrait voir le serveur. Connectez d'abord un serveur utile, le serveur GitHub est un excellent point de départ, et vérifiez la source et les permissions de chaque serveur avant de lui faire confiance. Gardez les jetons dans des variables d'environnement, limitez étroitement l'accès aux systèmes de fichiers et aux bases de données, et révisez les actions de l'agent jusqu'à ce qu'un nouveau serveur ait mérité votre confiance.