Serveurs MCP pour Claude Code en 2026 : 7 intégrations et installation
MarkdownCe qu’est MCP et comment le connecter en 5 minutes avec la commande claude mcp add. 7 serveurs : GitHub, Postgres, Slack, Notion, Sentry, Playwright. Liste d’autorisation via des hooks.
Lire l’article complet
Des instructions supplémentaires pour travailler avec Ailoot sont disponibles dans la documentation.
Qu’est-ce qu’un serveur MCP et pourquoi Claude Code en a-t-il besoin ?
L’essentiel
MCP (Model Context Protocol) est un standard ouvert d’Anthropic qui donne à Claude Code accès à des outils et à des données externes via une interface unifiée. Un protocole au lieu de dix API différentes. Anthropic le décrit comme « l’USB-C des applications d’IA » : branchez le port, et Claude peut voir votre base de données, vos e-mails, votre messagerie ou votre dépôt.
Anthropic a annoncé MCP le 25 novembre 2024 en tant que standard ouvert. En un an, le protocole est devenu un standard du secteur : OpenAI, Google DeepMind et Microsoft le prennent en charge. Le dépôt officiel modelcontextprotocol/servers contient des serveurs de référence du projet MCP lui-même (Filesystem, Memory, Sequential Thinking, Fetch et autres) ; des fournisseurs — GitHub, Notion, Stripe, Linear, Cloudflare et Sentry — publient des serveurs MCP dans leurs propres dépôts. Les index communautaires en répertorient des milliers.
Techniquement, MCP fonctionne avec JSON-RPC 2.0. L’architecture est simple : votre Claude Code est le client, tout service est un serveur, et le serveur MCP qui les relie comprend trois entités : tools (ce que l’IA peut appeler), resources (ce que l’IA peut lire) et prompts (des modèles prêts à l’emploi).
Tout comme USB-C fournit un moyen standard de connecter des appareils à différents périphériques, MCP fournit un moyen standard de connecter des modèles d’IA à différentes sources de données et à différents outils.
Pourquoi est-ce important pour un vibe coder ? Avant MCP, chaque connexion entre Claude et un service tiers nécessitait une intégration distincte avec son propre wrapper. Avec MCP, connecter Postgres, Slack et GitHub se fait en trois commandes similaires, et les déconnecter est tout aussi simple quand vous n’avez plus besoin du service.
En quoi MCP diffère-t-il des Skills et des Subagents ?
L’essentiel
Ces trois mécanismes se ressemblent, mais répondent à des besoins différents. Les Skills sont vos workflows et prompts sous forme de code. Les Subagents sont des « collègues » spécialisés distincts, avec leur propre contexte. MCP fournit des outils externes grâce auxquels Claude peut accéder à des services et à des données. Leur coût en tokens diffère également : un Skill est le moins coûteux, tandis que MCP est généralement plus cher. Au départ, MCP ne place dans le contexte que les noms des outils et les instructions du serveur ; Claude charge les descriptions complètes à la demande. L’essentiel du coût vient des réponses des services : elles peuvent être volumineuses et rester dans la conversation.
Un tableau simple pour bien distinguer ces mécanismes :
| Mécanisme | De quoi s’agit-il ? | Quand l’utiliser ? | Coût en tokens |
|---|---|---|---|
| Skill | Un fichier contenant des instructions et des prompts dans .claude/skills/ | Un workflow se répète : écrire un e-mail, compiler un rapport, publier un article | Faible. Chargé lorsqu’un déclencheur est activé |
| Subagent | Un agent distinct avec son propre contexte et ses propres outils | Une longue tâche en parallèle : revue, audit, recherche | Moyen. Son propre contexte |
| Serveur MCP | Un service proposant des outils et des ressources via JSON-RPC | Un accès en direct aux données est nécessaire : base de données, e-mail, messagerie, dépôt | Moyen ou élevé. Seuls les noms des outils restent dans le contexte ; les descriptions sont chargées à la demande et les réponses des services peuvent être volumineuses |
En pratique : si une tâche a été définie une fois et se répète sous forme de texte, c’est un Skill. Si l’IA a besoin d’une réponse en direct d’un système externe, c’est MCP. Si la tâche est longue, comporte plusieurs ramifications et nécessite un cerveau distinct, c’est un Subagent.
Pour en savoir plus sur les deux mécanismes voisins : Claude Code Skills : comment créer votre propre bibliothèque et Claude Code Subagents : 5 exemples prêts à l’emploi.
Comment installer un serveur MCP : votre première commande en 5 minutes
L’essentiel
La même syntaxe fonctionne dans tous les cas : claude mcp add [name] -- [launch command]. Le serveur apparaîtra dans la liste affichée par claude mcp list. Claude découvrira alors ses outils et commencera à les utiliser dans la conversation. Pas besoin de modifier manuellement la configuration : tout passe par la CLI.
Syntaxe complète tirée de la documentation officielle :
claude mcp add <name> [options] -- <command> [args...]
Trois modes de transport sont pris en charge : --transport stdio (la valeur par défaut, un processus local), --transport http (HTTP distant) et --transport sse (indiqué comme obsolète ; à utiliser uniquement si le serveur n’a pas encore migré).
Trois portées sont prises en charge avec l’option --scope :
local— uniquement dans le dossier du projet actuel (par défaut).project— écrit dans.mcp.json, ajouté au dépôt et disponible pour toute l’équipe.user— global, pour tous les projets de la machine.
Exemple minimal avec le serveur Filesystem de référence du projet MCP. Il démarre en une demi-minute :
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
claude mcp list
Après list, vous verrez filesystem dans la liste si le dossier indiqué dans la commande existe ; sinon, le serveur ne démarrera pas. Il pourra voir les dossiers de travail de Claude Code, c’est-à-dire le dossier depuis lequel vous l’avez lancé. J’explique plus bas, en 5.2, pourquoi il en est ainsi et dans quels cas ce serveur est réellement utile.
Pour vérifier que MCP est connecté, exécutez /mcp dans une session Claude Code. Vous verrez tous les serveurs, leur état et leurs listes d’outils. Vous trouverez des instructions supplémentaires pour travailler avec Ailoot dans la documentation. Consultez le README du serveur MCP choisi pour connaître ses commandes spécifiques.
stdio ou HTTP : quel transport choisir ?
L’essentiel
stdio est un processus local sur votre machine ; tout fonctionne sans réseau et OAuth n’est pas nécessaire. HTTP est un service distant, accessible avec un jeton ou OAuth, qui peut être partagé entre plusieurs appareils. Si un serveur MCP s’installe via npx ou uvx, il utilise stdio. Si un service possède sa propre adresse publique, il utilise HTTP. SSE est officiellement indiqué comme obsolète : ne vous y fiez pas.
Comparaison selon les principaux critères :
| Critère | stdio | HTTP |
|---|---|---|
| Où il s’exécute | En local (un processus enfant de Claude Code) | Serveur distant |
| Autorisation | Aucune nécessaire | OAuth 2.1 ou jeton Bearer |
| Ports réseau | Aucun | Adresse publique |
| Cas d’usage | Filesystem, Postgres, utilitaires locaux | GitHub, Slack, Notion, Linear, Sentry |
| Reconnexion | Aucune nécessaire | Backoff exponentiel, jusqu’à 5 tentatives |
| Déploiement | Installation d’un package local | Service du fournisseur |
Règle générale : tout ce qui est stocké sur votre disque ou dans une base de données locale utilise stdio. Tout ce qui est dans le cloud utilise HTTP. SSE est officiellement obsolète : ne le choisissez pas.
7 serveurs MCP prêts à l’emploi pour les entrepreneurs
L’essentiel
Voici sept configurations qui couvrent 80% des tâches d’un vibe coder : le code (GitHub), les fichiers (Filesystem), la base de données (Postgres via DBHub), la communication d’équipe (Slack), la base de connaissances (Notion), le suivi des erreurs (Sentry) et les workflows dans le navigateur (Playwright). Pour chaque configuration, je donne ci-dessous une commande d’installation en une ligne et un exemple de demande concrète à adresser à Claude dans une vraie conversation.
5.1. GitHub MCP — le serveur officiel de GitHub
Ce qu’il fait : il donne à Claude Code accès aux issues, aux pull requests, aux fichiers du dépôt et aux exécutions d’actions. Le serveur est open source et compte plus de 30,000 étoiles sur GitHub.
Installation (HTTP, via OAuth) :
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
Vous pouvez aussi utiliser stdio via Docker si vous avez besoin d’un jeton PAT plutôt que d’OAuth.
Exemple : « Lis les issues ouvertes étiquetées bug, regroupe-les par composant et suggère dans quel ordre les résoudre. » Claude appellera GitHub MCP, lira toutes les issues et renverra une liste classée par priorité.
Dépôt : github/github-mcp-server.
5.2. Filesystem MCP — le serveur de référence du projet MCP
Ce qu’il fait : il donne à l’IA accès aux fichiers de l’ordinateur dans les dossiers autorisés. Il est publié par le projet MCP lui-même ; dans le registre npm, Model Context Protocol a Series of LF Projects, LLC est indiqué comme auteur.
Installation (stdio), avec une version figée :
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
Lorsque Claude Code se connecte, il transmet ses dossiers de travail au serveur, ce qui remplace tout ce qui est indiqué dans la commande. Les dossiers de travail de Claude Code comprennent celui depuis lequel vous l’avez lancé, ainsi que ceux ajoutés avec la commande /add-dir ou l’option --add-dir. Vous ne pouvez pas attribuer au serveur un dossier séparé contenant des maquettes au moyen de la commande. Le dossier indiqué dans la commande doit tout de même exister, sinon le serveur ne démarrera pas.
Dans Claude Code, cela fait donc en grande partie doublon avec les outils intégrés. Pour accéder aux fichiers d’un autre dossier, /add-dir suffit : ensuite, les outils propres à Claude Code peuvent eux aussi lire ce dossier. Le serveur est plus utile pour les programmes qui n’ont pas leur propre accès aux fichiers. Dans Claude Desktop, un autre problème peut survenir : les outils du serveur sont rejetés parce que leurs descriptions utilisent un ancien format de schéma ; ce problème n’est toujours pas résolu.
N’accordez l’accès qu’aux dossiers dont vous avez réellement besoin, à la fois dans la commande et via /add-dir. N’accordez pas l’accès à la racine du disque : c’est la première faille de sécurité.
Exemple : exécutez d’abord /add-dir ~/Documents/design, puis demandez : « Déplace toutes les maquettes de ~/Documents/design/landing-v3/ dans le projet actuel et renomme-les selon la convention hero-*.png. »
5.3. Postgres MCP — DBHub (Bytebase)
Ce qu’il fait : il connecte Claude à Postgres, MySQL, SQL Server, MariaDB ou SQLite. Il prend en charge le mode lecture seule, afin que l’agent IA ne puisse pas supprimer la base de données en une seule commande. Il est souvent utilisé pour remplacer le serveur de référence archivé d’Anthropic, server-postgres.
Installation (HTTP, en lecture seule) :
claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonly
Pour une base de données de production, utilisez toujours un utilisateur distinct disposant de droits en lecture seule et anonymisez les données personnelles au moyen d’une VIEW ou d’une route API intermédiaire. Ne connectez pas une base de production avec des droits d’écriture.
Exemple : « Interroge les clients dont le statut d’abonnement est expired et qui datent du mois dernier, puis donne les 20 premiers selon le montant total des paiements. »
Dépôt : bytebase/dbhub.
5.4. Slack MCP — communication d’équipe
Ce qu’il fait : il permet à Claude de lire les canaux Slack et d’envoyer des messages. Utile pour l’automatisation : « Quand le build réussit, publie un message dans #releases » ; « Rédige un résumé hebdomadaire de #engineering. »
Installation (stdio via un wrapper npx, par exemple @modelcontextprotocol/server-slack ou un équivalent proposé par un fournisseur) :
claude mcp add slack \
-e SLACK_BOT_TOKEN=xoxb-... \
-e SLACK_TEAM_ID=T0... \
-- npx -y @modelcontextprotocol/server-slack
L’autorisation utilise un jeton Slack Bot ; l’accès est restreint par les scopes définis dans Slack. Vous pouvez n’accorder à l’IA que chat:read et chat:write:user ; elle ne pourra alors pas modifier les paramètres de l’espace de travail. Consultez le README du serveur choisi pour connaître les commandes actuelles ; l’écosystème évolue rapidement.
Exemple : « Chaque matin à 9:00, envoie à #daily la liste des PR fusionnées la veille. »
5.5. Notion MCP — base de connaissances
Ce qu’il fait : il donne à Claude accès aux pages et aux bases de données Notion. C’est une base de connaissances en dehors de votre projet : si vous y conservez des notes, un registre de clients ou une politique éditoriale, l’IA peut les lire.
Installation (HTTP, via OAuth) :
claude mcp add --transport http notion https://mcp.notion.com/mcp
Vous pouvez également utiliser le plugin officiel d’Anthropic @makenotion/claude-code-notion-plugin.
Exemple : « Dans la base de données Notion “Customers”, trouve toutes les personnes dont le statut est “active” et qui n’ont pas eu d’appel depuis plus de deux semaines. Rédige un e-mail pour chacune. »
Guide de Notion : developers.notion.com/guides/mcp.
5.6. Sentry MCP — suivi des erreurs
Ce qu’il fait : il connecte Claude aux erreurs de votre système de production. Lorsqu’une page échoue avec une erreur 500, vous pouvez demander : « Affiche les 10 issues les plus récentes dans Sentry pour le projet et explique la cause première de chacune », et obtenir immédiatement une analyse.
Installation (HTTP) :
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
L’autorisation se fait via Sentry OAuth. L’accès peut être limité à un projet spécifique.
Exemple : « Prends les trois issues les plus fréquentes des dernières 24 heures. Explique en termes simples ce qui s’est passé et suggère comment le corriger. »
Dépôt : getsentry/sentry-mcp.
5.7. Playwright MCP — workflows dans le navigateur
Ce qu’il fait : il donne un navigateur à Claude. L’IA peut ouvrir une page, cliquer, remplir un formulaire et prendre une capture d’écran. Utile pour vérifier l’interface, effectuer des tests manuels après publication et analyser des workflows.
Installation (stdio) :
claude mcp add playwright -- npx -y @playwright/mcp@latest
La version v0.0.75, publiée le 7 mai 2026, est activement maintenue par Microsoft (plus de 32,000 étoiles).
Exemple : « Ouvre la page d’accueil de notre site web, vérifie que toutes les cartes s’affichent correctement et prends une capture d’écran sur ordinateur et sur mobile. »
Dépôt : microsoft/playwright-mcp.
Consultez le README de la version Playwright MCP choisie pour trouver la commande avec une version figée, l’option permettant plusieurs sessions simultanées et les erreurs d’installation courantes.
Comment contrôler la sécurité avec un hook PreToolUse
L’essentiel
MCP donne beaucoup de pouvoir à l’IA : elle peut écrire dans des bases de données, envoyer des messages et supprimer des fichiers. Un PreToolUse contrôle les appels correspondant à ses motifs ; une regex SQL n’est pas une autorisation de base et un motif Postgres ne couvre ni Slack ni les fichiers. Utilisez d’abord les vrais droits des services et fichiers, puis testez séparément la portée exacte du hook.
Une liste noire de préfixes SQL n’est pas une autorisation en lecture seule : minuscules, commentaires, UPDATE, INSERT, ALTER, instructions multiples et fonctions à effets de bord échappent aux trois préfixes majuscules. Donnez à la connexion un rôle distinct aux droits de lecture seule et vérifiez-les sur une base jetable. Un hook complète ces droits sans les remplacer.
Voici une quarantaine volontairement étroite : refuser tous les appels des trois familles MCP nommées jusqu’à revue et test d’une politique plus précise. Elle bloque lectures et écritures. Adaptez les noms réels ; serveur renommé, Bash intégré et autre connecteur restent hors de ces motifs.
Placez ces règles séparées dans .claude/settings.json :
{
"hooks": {
"PreToolUse": [
{
"matcher": "mcp__postgres__.*",
"hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
},
{
"matcher": "mcp__slack__.*",
"hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
},
{
"matcher": "mcp__filesystem__.*",
"hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
}
]
}
}
Enregistrez le script dans .claude/hooks/deny-unapproved-mcp.sh. Il utilise le contrat PreToolUse documenté, pas l’ancien decision: approve/block au premier niveau :
#!/bin/bash
printf '%s\n' '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"This MCP server family is quarantined pending a reviewed policy."}}'
Le script ne classe pas le SQL : il refuse toujours l’appel correspondant. Testez la correspondance et le résultat en session isolée avant les données précieuses : SELECT 1, delete en minuscules, UPDATE précédé d’un commentaire, lecture ou envoi Slack et lecture Filesystem de .env doivent tous être refusés si leur nom correspond. Un outil d’une autre famille doit rester hors de cet exemple ; vérifiez cette limite séparément.
Pour lire la base, utilisez des droits vérifiés et remplacez la quarantaine par une politique revue sur les vrais outils. Pour Slack, un accès sans droit d’envoi suffit aux lectures. Pour les fichiers, limitez les racines du serveur et les droits du processus. Ce hook ne prouve aucun blocage via d’autres outils, shell, pièces jointes ou fichier de politique modifiable par l’agent.
La même approche est présentée plus en détail dans le guide Plan Mode dans Claude Code, avec une logique similaire de « vérification avant exécution ».
Que faire si vous avez plus de 40 outils et que Claude s’y perd ?
L’essentiel
Sept serveurs peuvent facilement représenter 50–100 outils. Claude Code utilise Tool Search par défaut : au démarrage, seuls les noms des outils et les instructions des serveurs sont ajoutés au contexte, puis Claude charge la description complète lorsqu’il a besoin d’un outil. Si la recherche est désactivée, toutes les descriptions sont chargées d’un coup et, au-delà d’environ 40 outils, Claude commence à s’y perdre : il choisit le mauvais outil ou utilise MCP alors qu’une commande ordinaire suffirait.
Selon la documentation de Claude Code, la fonctionnalité est désormais activée par défaut et n’a pas besoin d’être activée manuellement.
Exceptions où Claude Code charge immédiatement tous les outils : utilisation d’un proxy tiers (lorsque ANTHROPIC_BASE_URL pointe vers une adresse autre que celle d’Anthropic), modèles antérieurs à la génération 4.5 dans Google Cloud et déploiements Microsoft Foundry sur Azure. La variable ENABLE_TOOL_SEARCH modifie le comportement :
- non définie — tous les outils MCP sont différés et chargés à la demande ;
true— même comportement, et Claude Code tente aussi d’activer la recherche via un proxy ;auto— mode seuil : tant que toutes les descriptions d’outils occupent moins de 10% de la fenêtre de contexte, elles sont chargées immédiatement ; au-delà, elles sont différées ;auto:N— même chose, mais avec un seuil personnalisé en pourcentage, par exempleauto:5;false— ancien comportement : tous les outils sont immédiatement dans le contexte.
Pour les outils critiques qui doivent toujours être visibles, un flag alwaysLoad: true est disponible dans .mcp.json, à côté de la description du serveur. Chaque outil de ce type occupe le contexte dès le départ ; ne l’utilisez donc que pour les outils dont Claude a besoin dans presque chaque réponse.
Si vous avez cinq serveurs MCP ou plus et que Claude ne sait plus quel outil appeler, vérifiez d’abord si la recherche est désactivée : cherchez ENABLE_TOOL_SEARCH=false dans les paramètres et vérifiez si vous utilisez un proxy.
Il peut aussi être utile de réduire le contexte avec /compact.
Quand n’avez-vous pas besoin de MCP : un Skill, un Subagent ou une CLI seraient-ils préférables ?
L’essentiel
En termes de tokens, MCP est la façon la plus coûteuse de donner à Claude des capacités externes. Si une tâche peut être réalisée avec un outil CLI prêt à l’emploi (gh issue list, psql, curl) ou un Skill d’une page, utilisez-les au lieu de créer des serveurs MCP. Règle : MCP n’est justifié que lorsque l’IA a besoin d’un échange bidirectionnel en direct avec un service, et non d’une réponse ponctuelle.
Hiérarchie selon le coût en tokens et la complexité :
- Commande CLI via Bash — presque gratuite. L’IA exécute
gh pr list,psql -coucurlet obtient une réponse comme un utilisateur ordinaire du terminal. - Skill — peu coûteux. Un modèle de prompt prêt à l’emploi, avec des instructions sur ce qu’il faut appeler et sur la façon de traiter le résultat. Chargé à partir d’un déclencheur dans le nom du dossier.
- Subagent — coût moyen. Un contexte séparé pour une longue tâche, avec sa propre session de tokens.
- Serveur MCP — coûteux. Seuls les noms des outils restent dans le contexte, mais la description de l’outil est chargée lorsque Claude la trouve avant un appel, et les réponses des services peuvent être volumineuses : Claude Code affiche un avertissement lorsqu’une réponse d’outil dépasse 10,000 tokens. Il faut aussi une session OAuth pour HTTP.
Conseil contre-intuitif : pour analyser des pages web, travailler avec git, ouvrir des PDF et utiliser des utilitaires open source, choisissez CLI, pas MCP. L’IA peut exécuter des commandes de terminal aussi bien qu’une personne, et les tokens ne sont consommés que par la commande et sa réponse, sans descriptions d’outils ni surcharge du serveur.
MCP est justifié dans deux cas :
- Le service est fermé : Slack, Notion, Sentry, Linear. Des outils CLI existent aussi, mais MCP fournit un accès plus fin via OAuth et le contrôle des scopes.
- Un échange bidirectionnel en direct est nécessaire : l’IA se connecte à Postgres, vérifie le schéma, pose une requête complémentaire, reçoit les données et passe à l’étape suivante. Avec la CLI, cela nécessiterait 10 commandes manuelles.
6 anti-patterns de connexion MCP
L’essentiel
Six erreurs précises qui piègent les vibe coders pendant leurs premières semaines avec MCP. Chaque anti-pattern peut être corrigé en une minute : ouvrez claude mcp list, examinez la liste et vérifiez les scopes et les hooks. La plupart des problèmes se résolvent en supprimant un serveur inutile, pas en en ajoutant un nouveau ; cette section est une courte liste de vérification à parcourir de haut en bas.
La collection de serveurs MCP. Vous avez connecté 10 serveurs « au cas où » ; Claude ne sait plus quel outil appeler et leurs réponses encombrent le contexte. Solution : gardez 3–5 serveurs pour le projet en cours et supprimez les autres avec
claude mcp remove.Accès en écriture à une base de production. Vous avez connecté Postgres MCP à une base de production sans
--readonly, sans utilisateur distinct ni hook de liste d’autorisation. Un prompt — « supprime les enregistrements de test » — et les données de production sont supprimées. Solution : rôle distinct aux droits de lecture seule vérifiés, mode lecture seule du serveur si applicable et contrôles d’appels testés. Une liste de préfixesDROP|TRUNCATE|DELETEne suffit pas à autoriser les opérations.Données personnelles sans anonymisation. Vous avez connecté directement une base contenant les adresses e-mail, numéros de téléphone et informations de passeport des clients. Claude voit les données, qui finissent dans les journaux d’Anthropic. Solution : une VIEW ou une route API intermédiaire qui renvoie des données masquées comme
j***@gmail.com.MCP à la place d’un Skill. Vous devez « créer un rapport commercial au format X » : une tâche routinière qu’un Skill peut résoudre avec un prompt prêt à l’emploi. Ne créez pas de serveur MCP.
MCP à la place d’une CLI open source. Vous devez convertir un PDF en texte. Il existe
pdftotext. Ne créez pas un « MCP PDF » : cela ne ferait que gaspiller des tokens.Ne pas suivre le coût des tokens. Vous voyez le serveur connecté dans
claude mcp list, mais pas combien il consomme dans chaque conversation. Au bout d’une semaine, vous n’avez aucune idée que « MCP a utilisé 40% du contexte et que je paie pour ça depuis tout ce temps ». Solution : désactivez régulièrement les serveurs inutilisés et observez l’évolution de l’utilisation grâce au suivi des limites d’utilisation de Claude Code.
Comment diagnostiquer une panne de connexion MCP
L’essentiel
Les problèmes les plus courants : le rappel OAuth ne fonctionne pas, le nom du serveur entre en conflit avec un nom existant ou l’outil n’apparaît pas dans claude mcp list après add. La procédure de dépannage habituelle permet de les résoudre : list indique ce qui est connecté, status vérifie l’indicateur d’état et, s’il est rouge, logs renvoie une trace de pile. Après avoir modifié --scope ou une variable ENV, redémarrez tout.
Liste de vérification étape par étape :
Le serveur apparaît-il dans la liste ?
claude mcp listSi ce n’est pas le cas,
claude mcp addne s’est pas terminé. La cause la plus courante est--scope: vous l’avez ajouté àlocalet vous vérifiez depuis un autre projet.L’état du serveur est-il vert ?
claude mcp status <name>Rouge signifie que le processus n’a pas démarré (pour stdio) ou que le serveur n’a pas répondu (pour HTTP).
Les journaux du serveur contiennent-ils des informations utiles ?
claude mcp logs <name>Si vous voyez une trace de pile, le problème vient généralement du package (
npxne l’a pas trouvé ou la version de Node est inférieure à 20).Le rappel OAuth ne revient-il pas ? Le problème vient généralement de
--callback-portou d’un filtre réseau. Transférez un port spécifique :claude mcp add --transport http --callback-port 8765 [name] [url]Conflit de noms d’outils ? Deux serveurs exposent un outil portant le même nom et Claude appelle le mauvais. Utilisez Tool Search (voir le H2 précédent) ou supprimez manuellement le serveur en trop avec
claude mcp remove.Vous ne voyez pas les extensions (connecteurs) de claude.ai ? C’est un problème connu : les extensions (connecteurs) de l’interface web claude.ai ne sont pas disponibles dans Claude Code lorsque celui-ci utilise une clé API. Solution : connectez MCP via la CLI, et non via l’interface web.
Et ensuite : OAuth, vos propres serveurs MCP et le Plugin Marketplace
L’essentiel
Après les sept serveurs prêts à l’emploi, les trois étapes suivantes sont l’utilisation d’OAuth pour vos propres serveurs HTTP (si vous souhaitez partager MCP avec votre équipe), la création de votre propre MCP pour un service spécifique et la connexion au Plugin Marketplace d’Anthropic. Le Marketplace a été lancé le 9 octobre 2025 et regroupe MCP dans des plugins installables en une seule commande.
Le Plugin Marketplace accélère les choses pour ceux qui ne veulent pas mémoriser les commandes d’installation. Le format est un manifeste .claude-plugin/marketplace.json qui décrit un ensemble de serveurs dans un seul package.
Installer un plugin depuis le marketplace :
claude plugin install <plugin-name>
Un plugin peut contenir plusieurs serveurs MCP, Skills et Subagents à la fois : une configuration groupée pour un scénario précis, comme le commerce électronique, le marketing ou un service juridique.
Écrivez votre propre serveur MCP conformément à la spécification modelcontextprotocol.io. Un modèle minimal utilise le SDK Python ou TypeScript d’Anthropic ; décrivez ensuite les outils et connectez un transport. La complexité est comparable à celle de l’écriture d’une API REST avec FastAPI.
Si votre projet dispose déjà d’un fichier CLAUDE.md configuré et que vous comprenez l’ingénierie du contexte, ajouter votre propre MCP prend une journée. Sans ces bases, mieux vaut commencer par les acquérir.
Sources
- Model Context Protocol — site officiel
- Anthropic présente MCP — 25 novembre 2024
- Documentation MCP de Claude Code
- Claude Code : MCP Tool Search
- Annonce des plugins Claude Code — 9 octobre 2025
- Code with Claude 2026
- modelcontextprotocol/servers — registre officiel
- github/github-mcp-server
- microsoft/playwright-mcp
- bytebase/dbhub — Postgres MCP
- getsentry/sentry-mcp
- makenotion/claude-code-notion-plugin
- Guide Notion MCP
- Dépôt Claude Code d’Anthropic — issues et journal des modifications
Pour continuer à travailler avec des modèles, rendez-vous sur Ailoot.
Plus de détails
Questions fréquentes : Serveurs MCP pour Claude Code en 2026 : 7 intégrations et installation
Ce hook rend-il la base de production accessible seulement en lecture ?
Non. Il met en quarantaine tous les appels des familles MCP nommées sans classer le SQL. La lecture seule vient d’un rôle distinct aux droits vérifiés ; les hooks apportent un contrôle supplémentaire.
Comment tester la portée du hook ?
En session isolée, vérifiez le refus des noms correspondants pour lectures et écritures, y compris SQL en minuscules ou précédé de commentaires. Vérifiez ensuite qu’un outil sans rapport est hors du motif ; ce chemin exige sa propre politique ou ses droits.