MCP (Model Context Protocol) : Connectez Claude Code à Tous Vos Outils
Guide complet du Model Context Protocol (MCP) pour Claude Code. Apprenez à connecter GitHub, Brave Search, Playwright et des centaines d'outils via des serveurs MCP.
Qu'est-ce que le Model Context Protocol (MCP) ?
Le Model Context Protocol (MCP) est un standard ouvert créé par Anthropic qui permet à Claude Code de communiquer avec des services externes via des serveurs d'outils standardisés. Pensez-y comme un USB-C pour l'IA : une interface universelle qui connecte votre assistant IA à n'importe quel outil, base de données ou API.
Avant MCP, chaque intégration nécessitait du code personnalisé. Avec MCP, une seule commande suffit pour connecter Claude Code à GitHub, Brave Search, Playwright, Notion, Slack, des bases de données et bien plus encore.
Pourquoi MCP est révolutionnaire
L'écosystème MCP compte désormais plus de 200 serveurs communautaires et le protocole a été confié à la Linux Foundation en 2026, confirmant son statut de standard industriel. En pratique, MCP réduit le code d'intégration nécessaire de 70% par rapport aux approches ad hoc.
Pour les développeurs qui utilisent déjà Claude Code (voir notre [guide complet](/blog/claude-code-guide-complet)), MCP représente la prochaine étape logique : transformer un assistant de code intelligent en un hub de productivité connecté à tout votre écosystème d'outils.
Prérequis
Avant de commencer, assurez-vous d'avoir :
Si vous n'avez pas encore installé Claude Code, consultez notre [guide pour débutants](/blog/claude-code-pour-debutants) qui couvre l'installation pas à pas.
Architecture de MCP
MCP fonctionne selon un modèle client-serveur :
┌─────────────┐ stdio/SSE/HTTP ┌──────────────┐
│ Claude Code │ ◄──────────────────► │ Serveur MCP │
│ (Client) │ │ (GitHub) │
└─────────────┘ └──────────────┘
│
│ stdio/SSE/HTTP ┌──────────────┐
└──────────────────────────► │ Serveur MCP │
│ (Brave) │
└──────────────┘Chaque serveur MCP tourne comme un processus séparé et expose un ensemble d'outils que Claude Code peut appeler de manière transparente pendant une session.
Les 3 serveurs MCP essentiels
GitHub, Brave Search et Playwright couvrent 80% des cas d'usage courants. Commencez par ces trois serveurs.
1. GitHub — Gestion de repos et issues
Le serveur GitHub officiel expose 15 outils couvrant les issues, pull requests, fichiers et la recherche. C'est le serveur le plus populaire : 92% des utilisateurs MCP l'activent en premier.
claude mcp add github \
-e GITHUB_TOKEN=ghp_votre_token \
-- npx -y @modelcontextprotocol/server-githubCas d'usage typiques :
2. Brave Search — Recherche web
Brave Search donne à Claude Code un accès au web en temps réel, idéal pour la recherche de documentation, la veille technologique ou la résolution de bugs.
claude mcp add brave-search \
-e BRAVE_API_KEY=BSA_votre_clé \
-- npx -y @anthropic/mcp-server-brave-searchCas d'usage typiques :
3. Playwright — Navigation et tests browser
Playwright transforme Claude Code en un outil de test automatisé capable de naviguer sur le web, prendre des captures d'écran et interagir avec des pages.
claude mcp add playwright \
-- npx -y @anthropic/mcp-server-playwrightCas d'usage typiques :
Installation et configuration pas à pas
Étape 1 : Ajouter un serveur MCP
La commande claude mcp add est votre point d'entrée. Elle prend un nom, des variables d'environnement optionnelles et la commande du serveur :
claude mcp add <nom> [-e VAR=valeur] -- <commande>Étape 2 : Vérifier l'installation
Après avoir ajouté vos serveurs, vérifiez qu'ils sont bien connectés :
claude mcp listVous devriez voir vos serveurs avec le statut connected. Si un serveur affiche disconnected, vérifiez vos tokens et la disponibilité du package npm.
Étape 3 : Utiliser les outils dans Claude Code
Une fois connecté, les outils MCP sont automatiquement disponibles dans votre session Claude Code. Par exemple, avec le serveur GitHub :
> Liste les 5 dernières issues ouvertes sur mon repo principal
> Crée une issue pour le bug de pagination avec le label "bug"
> Montre-moi les fichiers modifiés dans la PR #42Claude Code détecte automatiquement les outils pertinents et les appelle sans configuration supplémentaire.
Serveurs MCP populaires au-delà des essentiels
L'écosystème MCP grandit rapidement. Voici d'autres serveurs populaires :
| Serveur | Usage | Commande d'installation |
|---|---|---|
| Notion | Notes et wikis | npx -y @anthropic/mcp-server-notion |
| Slack | Messages et canaux | npx -y @anthropic/mcp-server-slack |
| PostgreSQL | Bases de données | npx -y @anthropic/mcp-server-postgres |
| Filesystem | Accès fichiers étendu | npx -y @modelcontextprotocol/server-filesystem |
| Memory | Mémoire persistante | npx -y @anthropic/mcp-server-memory |
| Context7 | Documentation à jour | npx -y @context7/mcp-server |
MCP Tool Search : optimisation du contexte
Une fonctionnalité clé de Claude Code est le MCP Tool Search, qui permet le lazy loading des outils MCP. Au lieu de charger tous les outils de tous les serveurs au démarrage (ce qui consomme beaucoup de contexte), Claude Code ne charge que les outils pertinents à la demande.
Résultat : une réduction de la consommation de contexte allant jusqu'à 95%. C'est crucial quand vous avez de nombreux serveurs MCP installés.
Sécurité et bonnes pratiques
Gestion des tokens
Portée des serveurs
Claude Code permet de configurer les serveurs MCP à trois niveaux :
.mcp.json à la racine du projet) — partagé avec l'équipe~/.claude/settings.json) — personnel, tous les projets// .mcp.json (niveau projet)
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}Audit et monitoring
Activez les logs de diagnostic pour surveiller les appels MCP :
claude --mcp-debugCela affiche les requêtes et réponses entre Claude Code et chaque serveur MCP, utile pour débugger des problèmes de connexion.
Créer votre propre serveur MCP
Pour les développeurs avancés (voir nos [meilleures pratiques](/blog/meilleures-pratiques-claude-code)), MCP permet de créer vos propres serveurs personnalisés. Le SDK est disponible en TypeScript et Python.
Exemple minimal en TypeScript
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new McpServer({
name: "mon-serveur",
version: "1.0.0",
});
server.tool("hello", "Dire bonjour", { name: { type: "string" } }, async ({ name }) => {
return { content: [{ type: "text", text: `Bonjour ${name} !` }] };
});
const transport = new StdioServerTransport();
await server.connect(transport);Publiez-le sur npm et n'importe quel utilisateur de Claude Code pourra l'installer avec claude mcp add.
Cas d'usage concrets
Workflow DevOps automatisé
Combinez GitHub + Brave Search pour un workflow de résolution de bugs :
Tests end-to-end avec Playwright
Après avoir écrit du code, demandez à Claude Code de le tester automatiquement :
> Lance Playwright et teste que la page de login fonctionne correctement.
> Vérifie que le formulaire d'inscription valide les emails.
> Prends un screenshot de la page d'accueil en version mobile.Documentation automatique avec Context7
Le serveur Context7 donne accès à la documentation à jour de n'importe quelle bibliothèque :
> Cherche dans la doc de Next.js 16 comment configurer les API routes.
> Montre-moi les derniers changements dans l'API de React 19.Dépannage courant
| Problème | Solution |
|---|---|
| Serveur disconnected | Vérifiez le token et relancez claude mcp list |
| Timeout sur les appels | Augmentez le timeout dans la config du serveur |
| Outils non détectés | Relancez Claude Code pour recharger les serveurs |
| Erreur npm à l'installation | Mettez à jour Node.js vers la version 22 LTS |
| Trop de contexte consommé | Activez le MCP Tool Search (lazy loading) |
Conclusion
Le Model Context Protocol transforme Claude Code d'un simple assistant de code en un centre de commande connecté à l'ensemble de votre écosystème d'outils de développement. Avec plus de 200 serveurs disponibles et un standard maintenu par la Linux Foundation, MCP est devenu incontournable en 2026.
Commencez par les trois serveurs essentiels (GitHub, Brave Search, Playwright), puis explorez l'écosystème selon vos besoins. Et si aucun serveur existant ne correspond à votre workflow, le SDK vous permet de créer le vôtre en quelques heures.
Pour aller plus loin dans la maîtrise de Claude Code et de MCP, découvrez notre [formation complète](/) qui couvre l'intégration MCP en détail avec des exercices pratiques et des projets guidés.
---
*Le Model Context Protocol (MCP) est un standard open source maintenu par la Linux Foundation. Les serveurs MCP sont compatibles avec Claude Code 1.0+ et nécessitent Node.js 22 LTS. Les clés API des services tiers sont requises pour chaque serveur.*
Envie de maîtriser Claude Code ?
Rejoignez notre formation complète et apprenez à utiliser Claude Code comme un pro.
Découvrir la formation