Six serveurs MCP à conserver dans Claude Code et ceux à supprimer
Simplifier une configuration MCP surchargée : Context7, GitHub, Postgres MCP Pro, Playwright, Sentry et Brave Search, en définissant le périmètre du projet et en effectuant un audit du nombre d’outils inférieur à 50.
Sources: *I Tested 8 MCP Servers With Claude Code. These Were Actually Worth Keeping*
Un agent de codage qui demande de rechercher dans un dossier local src une fonction d’authentification obsolète peut se retrouver dans des endroits étranges. Dans un cas réel, l’agent ignore le système de fichiers, appelle un serveur Jira MCP installé une semaine plus tôt et commence à chercher le nom de la fonction dans la liste des tickets en attente. La saisie de /mcp explique pourquoi : 14 serveurs étaient en cours d’exécution et offraient 73 outils. Aux alentours de 50 outils visibles, c’est à peu près là que le modèle cesse de distinguer les outils similaires et commence à deviner. De plus, environ 18 000 tokens par tour étaient consacrés aux schémas JSON d’outils que personne n’utilisait, avant même que le premier mot ne soit saisi.
Quel que soit le serveur auquel on se connecte, sa liste d’outils finit dans le prompt du système. Si l’objectif est d’avoir un agent qui choisit correctement dès la première tentative, ces slots représentent un budget limité.
Context7 pour les documents actuels
Les agents écrivent souvent du code en s’appuyant sur des API qui ont depuis changé. Si l’on demande un flux d’authentification Supabase, le résultat peut utiliser des méthodes dépréciées dès 2025. Context7 remédie à cela en intégrant dans la demande des documents de bibliothèque liés à une version spécifique.
# Add --scope project (or -s project) to write the entry into
# a committable .mcp.json instead of your personal ~/.claude.json.
# Context7 provides current, version-pinned library docs
# Canonical path is the installer (OAuth + generates an API key):
npx ctx7 setup
# Or wire the remote server manually (key from context7.com/dashboard):
claude mcp add --transport http context7 https://mcp.context7.com/mcp \
--header "CONTEXT7_API_KEY: <YOUR_KEY>"
Lorsqu’il est installé, l’agent récupère du Markdown en temps réel et enregistre l’implémentation actuelle. Il faut bien sûr faire confiance à son index, mais pour les frameworks web courants, c’est le premier serveur qui vaut la peine d’être installé.
GitHub pour les problèmes et les demandes de fusion
Si vous demandez à un agent de corriger le problème n°8009, il s’arrêtera généralement et demandera une description, car il ne peut pas voir le répertoire distant. Le serveur MCP officiel de GitHub expose le suivi des problèmes, les demandes de fusion ainsi que la recherche de code distant.
# GitHub — OFFICIAL server (issues, PRs, repo search).
# For Claude Code 2.1.1+:
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer <YOUR_GITHUB_PAT>"}}'
# For Claude Code 2.1.0 or earlier (legacy flag form):
# claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer <YOUR_GITHUB_PAT>"
Par la suite, une demande du type « review PR #8042 » fonctionne : l’agent télécharge la différence, lit les commentaires des reviewers, les associe aux fichiers locaux et applique les modifications. Préférez l’serveur propre à GitHub aux anciens outils tiers.
Postgres MCP Pro pour des schémas réels
Un agent qui devine un schéma de base de données génère des erreurs telles que column 'created_at' does not exist. Postgres MCP Pro lui fournit des outils comme list_schemas et get_object_details, lui permettant ainsi de mapper la base de données réelle avant d’écrire des requêtes SQL.
# Postgres MCP Pro — schema-aware SQL, READ-ONLY restricted mode
pipx install postgres-mcp
# Add the server with the restricted access flag
claude mcp add postgres --env DATABASE_URI="postgresql://user:pass@localhost:5432/db" \
-- postgres-mcp --access-mode=restricted
Pour le staging ou la production, le paramètre --access-mode=restricted n’est pas optionnel. Il désactive les opérations INSERT, UPDATE et DELETE au niveau du serveur, de sorte que l’agent ne peut pas supprimer de tables lors de son exploration.
Playwright MCP pour la vérification
Les agents affirmeront volontiers qu’une classe CSS a corrigé un bug de mise en page sans jamais afficher la page. Playwright MCP permet à l’agent de vérifier son propre travail en utilisant un navigateur sans interface graphique.
# Playwright (Microsoft) — agent drives a real browser to verify its own change
claude mcp add playwright npx @playwright/mcp@latest
Plutôt que d’interpréter une capture d’écran brute, l’agent lit l’arbre d’accessibilité, ce qui lui permet de savoir où se trouve un bouton dans le DOM et si un utilisateur peut le voir.
Playwright pilote le navigateur et teste le DOM. Chrome DevTools MCP est un outil distinct destiné à l’analyse du réseau et des performances. N’ajoutez le serveur DevTools que lorsque vous traitez activement des problèmes de réseau, car Playwright est plus adapté à la vérification visuelle.
Sentry pour les erreurs en production
Un traceback de React minifié collé dans une terminal est rarement utile, car les versions en production suppriment les cartes de source. Le serveur MCP officiel de Sentry permet d’afficher le traceback non minifié, les pistes d’analyse et les données d’environnement dans la fenêtre de contexte.
# Sentry — OFFICIAL remote server; pulls live stack traces
# Triggers OAuth on first launch
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
Lorsqu’un utilisateur signale une panne, on peut demander à l’agent d’examiner le dernier problème du frontend dans Sentry, ce qui lui permet de déboguer en utilisant la ligne exacte ainsi que l’état des variables au moment de la panne.
Brave Search pour des réponses fraîches
Vingt minutes peuvent s’envoler à cause d’une erreur obscure d’esbuild, alors que la solution se trouve dans un problème GitHub ouvert deux jours plus tôt. Les données d’entraînement de l’agent étaient trop anciennes pour le savoir, ce qui oblige le développeur à quitter la console et à effectuer des recherches manuellement.
# Brave Search — OFFICIAL server from Brave (the @modelcontextprotocol/*
# package was archived May 2025)
# Requires a free API key from api-dashboard.search.brave.com
claude mcp add brave-search --env BRAVE_API_KEY="<YOUR_KEY>" \
-- npx -y @brave/brave-search-mcp-server --transport stdio
Cela fournit à l’agent un outil de recherche web en temps réel. Face à une erreur peu courante, il affiche des réponses récentes de StackOverflow ou des pages d’état du fournisseur sans quitter la terminal.
Sécuriser la configuration
Avant d’ajouter d’autres éléments, corrigez la configuration et auditez ce qui est en cours d’exécution. L’ajout de --scope project à n’importe quelle commande d’installation écrit l’entrée dans un .mcp.json du répertoire de travail plutôt que dans le ~/.claude.json global, de sorte que toute l’équipe partage le même ensemble d’outils.
Un fichier de référence pour les serveurs mentionnés ci-dessus, ainsi que deux emplacements flexibles, a l’aspect suivant. Les emplacements flexibles sont le serveur Filesystem géré, permettant un accès ciblé aux dossiers en dehors du projet actuel, et Sequential-thinking, qui aide l’agent à suivre sa propre logique lors de gros refacteurs.
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp",
"headers": { "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY}" }
},
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp",
"headers": { "Authorization": "Bearer ${GITHUB_PAT}" }
},
"sentry": {
"type": "http",
"url": "https://mcp.sentry.dev/mcp"
},
"postgres": {
"command": "postgres-mcp",
"args": ["--access-mode=restricted"],
"env": { "DATABASE_URI": "${DATABASE_URI}" }
},
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp@latest"]
},
"brave-search": {
"command": "npx",
"args": ["-y", "@brave/brave-search-mcp-server", "--transport", "stdio"],
"env": { "BRAVE_API_KEY": "${BRAVE_API_KEY}" }
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "${HOME}/projects"]
},
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}
Ces entrées utilisent deux modes de transport. Avec http, le serveur est une API distante et toute sa logique s’exécute du côté du fournisseur. Avec stdio, comme pour Playwright ou Postgres, un processus local est lancé à partir du tableau command ; par conséquent, les binaires correspondants doivent d’abord être installés sur la machine. Les secrets sont transmis via l’interpolation d’environnement, comme ${DATABASE_URI}, ce qui permet de conserver le fichier en sécurité pour son enregistrement.
Pour connaître le nombre d’outils nécessaires pour cette configuration, consultez la session en direct :
# List every configured server and its connection status
claude mcp list
# Inside a Claude Code session, inspect connected servers and their tools:
# Type /mcp
# This shows each server, its tool count, and lets you toggle tools.
Le compteur d’outils affiché sur l’interface indique le total. Il y a près de cinquante outils visibles ; désactivez ceux qui ne sont pas nécessaires pour cette session.
Éliminer le poids inutile
Une fois une base de référence établie, retirez ce qui n’appartient pas.
- Serveurs de référence archivés. L’ancienne implémentation Postgres (
@modelcontextprotocol/server-postgres) apparaît encore dans des tutoriels obsolètes, mais n’est plus maintenue. Remplacez-la par Postgres MCP Pro. - Enveloppes de tiers. Des enveloppes communautaires pour GitHub, Sentry et des services similaires sont apparues en 2025 en tant que solutions provisoires pour suivre les changements des API officielles. Lorsqu’un serveur fourni par le fournisseur officiel existe, abandonnez la version communautaire.
- Tout ce qui duplique les capacités intégrées. C’est là que surviennent les conflits entre outils. Un serveur d’exécution de shell dédié offre à l’agent deux moyens d’exécuter bash. Une panne documentée a vu un agent utiliser un outil tiers
execute_scriptpour un simplenpm install, rencontrer une erreur de chemin, puis écrire un script Python personnalisé pour déclencher l’installation, en ignorant le shell natif. Si le client peut déjà récupérer des URLs ou lire des fichiers, ne gaspillez pas de ressources dans un serveur qui fait la même chose.
Poursuivez les audits
Vérifiez à nouveau .mcp.json chaque fois que la session semble lente. Une configuration optimale maintient les six serveurs principaux mentionnés ci-dessus et laisse de la marge en dessous du seuil des 50 outils. Un serveur Slack MCP est souvent touché : l’agent continue de lire l’historique des canaux lorsqu’on lui demande de rechercher dans les journaux locaux, ce qui ralentit les performances. Un candidat pour la huitième place, comme le MCP de Linear permettant d’insérer des critères d’acceptation dans l’éditeur, doit prouver sa valeur ; s’il augmente trop le nombre d’outils, un autre doit être supprimé.
Lorsqu’un agent semble ralenti récemment, sauvegardez la configuration actuelle, puis essayez uniquement ces serveurs principaux pendant quelques jours. Exécutez /mcp pour observer l’impact et vérifier si le modèle sélectionne les outils plus efficacement. Ne réintégrez pas les autres serveurs avant d’avoir atteint une limite que les fonctionnalités intégrées de Claude Code ne peuvent pas dépasser.
Lectures complémentaires
- Explication des subagents Claude Code : ce qu’ils sont et quand les utiliser — En quoi les subagents Claude Code diffèrent des compétences et des équipes d’agents : isolation du contexte, création d’un premier subagent personnalisé, bonnes pratiques de description et d’utilisation des outils, ainsi que les cas où il convient de les éviter.
- Pourquoi les agents de programmation ont encore du mal avec le code des entreprises privées — Real-SWE teste huit agents de programmation sur des bases de code privées licenciées. Le meilleur résout 38,8 % des cas, et les cinq catégories d’échec révèlent où les agents se trompent.