MCP (Model Context Protocol) : Connectez Claude Code à Tous Vos Outils
Guide2026-03-1316 min de lecture

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 :

  • Node.js 22 LTS ou supérieur
  • Claude Code 1.0+ installé globalement
  • npm 9+ pour l'installation des serveurs
  • Une clé API pour les services que vous souhaitez connecter (GitHub, Brave, etc.)
  • 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 :

  • 1.Claude Code agit comme le client MCP — il découvre et appelle les outils
  • 2.Les serveurs MCP exposent des outils spécifiques (lecture de repos GitHub, recherche web, navigation browser, etc.)
  • 3.La communication se fait via trois modes de transport : stdio, SSE (Server-Sent Events) ou HTTP streamable
  • ┌─────────────┐     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-github

    Cas d'usage typiques :

  • Créer et assigner des issues depuis le terminal
  • Analyser les pull requests ouvertes
  • Rechercher du code dans des repos distants
  • Automatiser les workflows de review
  • 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-search

    Cas d'usage typiques :

  • Rechercher de la documentation à jour
  • Trouver des solutions à des erreurs spécifiques
  • Faire de la veille sur les nouvelles versions de bibliothèques
  • 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-playwright

    Cas d'usage typiques :

  • Tester des interfaces web automatiquement
  • Capturer des screenshots pour la documentation
  • Scraper des données structurées
  • Débugger des problèmes d'affichage
  • 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 list

    Vous 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 #42

    Claude 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 :

    ServeurUsageCommande d'installation
    NotionNotes et wikisnpx -y @anthropic/mcp-server-notion
    SlackMessages et canauxnpx -y @anthropic/mcp-server-slack
    PostgreSQLBases de donnéesnpx -y @anthropic/mcp-server-postgres
    FilesystemAccès fichiers étendunpx -y @modelcontextprotocol/server-filesystem
    MemoryMémoire persistantenpx -y @anthropic/mcp-server-memory
    Context7Documentation à journpx -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

  • Ne commitez jamais vos tokens dans le code source
  • Utilisez des variables d'environnement pour les clés API
  • Rotation des tokens tous les 90 jours (bonne pratique 2026)
  • Préférez les scopes minimaux pour chaque token (lecture seule quand possible)
  • Portée des serveurs

    Claude Code permet de configurer les serveurs MCP à trois niveaux :

  • 1.Projet (fichier .mcp.json à la racine du projet) — partagé avec l'équipe
  • 2.Utilisateur (~/.claude/settings.json) — personnel, tous les projets
  • 3.Entreprise — configuration centralisée pour les équipes
  • // .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-debug

    Cela 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 :

  • 1.Claude Code lit l'issue GitHub
  • 2.Recherche des solutions sur le web via Brave Search
  • 3.Applique le fix dans le code
  • 4.Crée une PR avec les modifications
  • 5.Laisse un commentaire sur l'issue avec la solution
  • 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èmeSolution
    Serveur disconnectedVérifiez le token et relancez claude mcp list
    Timeout sur les appelsAugmentez le timeout dans la config du serveur
    Outils non détectésRelancez Claude Code pour recharger les serveurs
    Erreur npm à l'installationMettez à 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