MCP : Model Context Protocol - Aide-memoire

Le Model Context Protocol (MCP) connecte Claude Code à des outils externes - GitHub, navigateurs, bases de données - via un standard ouvert. Cette fiche pratique MCP rassemble toutes les commandes essentielles pour configurer, sécuriser et exploiter vos serveurs MCP au quotidien. Consultez-la comme référence rapide chaque fois que vous ajoutez ou dépannez un serveur.

MCP (Model Context Protocol) est un protocole standardisé créé par Anthropic qui permet aux modèles d'IA d'interagir avec des outils, des API et des sources de données externes via une interface unifiée. MCP est devenu le standard d'intégration adopté par Claude Code v1.0.52, Cursor, Windsurf et plus de 40 éditeurs compatibles. le protocole gère plus de 3 000 serveurs référencés dans le registre communautaire officiel.

Pour maîtriser les fondamentaux avant d'aborder MCP, consultez le guide d'installation et premier lancement qui couvre la configuration initiale de Claude Code.

Quels sont les concepts fondamentaux du Model Context Protocol ?

MCP repose sur une architecture client-serveur légère. Claude Code agit comme client MCP et se connecte à un ou plusieurs serveurs MCP qui exposent des outils.

Un serveur MCP est un processus indépendant qui communique avec Claude Code via l'un des trois transports supportés. En pratique, 90 % des serveurs locaux utilisent le transport stdio pour sa simplicité.

Le guide complet sur MCP détaille l'architecture interne du protocole et ses cas d'usage avancés.

À retenir : MCP est un standard ouvert client-serveur qui unifie la connexion entre Claude Code et n'importe quel outil externe.

Comment ajouter un serveur MCP à Claude Code ?

Utilisez la commande /mcp dans une session Claude Code ou modifiez directement le fichier de configuration JSON. Voici comment procéder selon le transport choisi.

Transport stdio (serveurs locaux)

Le transport stdio lance un processus local. C'est le mode par défaut pour les serveurs npm et Python.

# Ajouter un serveur stdio via la commande slash
claude /mcp add github -- npx -y @modelcontextprotocol/server-github

# Ajouter un serveur Python
claude /mcp add my-server -- python3 -m my_mcp_server

# Ajouter avec des variables d'environnement
claude /mcp add github -e GITHUB_TOKEN=ghp_xxx -- npx -y @modelcontextprotocol/server-github

Transport SSE (Server-Sent Events)

Le transport SSE convient aux serveurs distants accessibles via HTTP. Spécifiez l'URL du endpoint SSE.

# Ajouter un serveur SSE distant
claude /mcp add my-remote-server -t sse -- https://mcp.example.com/sse

# Ajouter avec en-tête d'authentification
claude /mcp add secure-server -t sse -h "Authorization: Bearer token123" -- https://api.example.com/sse

Transport streamable-http

Depuis la spécification MCP v2025-03-26, le transport streamable-http remplace progressivement SSE. Privilégiez ce mode pour les nouveaux déploiements.

# Ajouter un serveur streamable-http
claude /mcp add api-server -t http -- https://mcp.example.com/mcp

Concrètement, le fichier de configuration se trouve dans ~/.claude/settings.json pour une portée globale ou dans .claude/settings.json pour un projet. Consultez le tutoriel MCP pas à pas pour un guide détaillé avec captures d'écran.

À retenir : trois transports existent (stdio, SSE, streamable-http) - choisissez stdio pour le local, streamable-http pour le distant.

Quelles sont les commandes slash MCP essentielles ?

Voici le tableau de référence rapide des commandes MCP les plus utilisées dans Claude Code. Chaque entrée est autonome et citable.

En pratique, la commande /mcp list est la première à exécuter pour diagnostiquer un problème de connexion. Si un serveur affiche le statut error, lancez /mcp reset pour forcer un redémarrage.

Pour découvrir toutes les commandes slash disponibles, référez-vous au répertoire des commandes slash essentielles.

À retenir : /mcp add, /mcp list et /mcp reset couvrent 80 % des interactions quotidiennes avec les serveurs MCP.

Comment configurer les serveurs MCP dans le fichier JSON ?

Ouvrez le fichier ~/.claude/settings.json (portée utilisateur) ou .claude/settings.json (portée projet). La section mcpServers contient la déclaration de chaque serveur.

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_votre_token"
      }
    },
    "brave-search": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "BSA_votre_clé"
      }
    },
    "remote-api": {
      "type": "http",
      "url": "https://mcp.example.com/mcp"
    }
  }
}

La portée projet (.claude/settings.json) permet de partager la configuration MCP avec votre équipe via Git. En pratique, 65 % des équipes utilisent cette approche pour standardiser les outils disponibles. Vérifiez que les tokens ne sont jamais commités - utilisez des variables d'environnement.

Pour approfondir la gestion du contexte partagé entre équipiers, explorez le guide sur la gestion du contexte.

À retenir : le fichier JSON supporte trois types de transport et accepte des variables d'environnement pour les secrets.

Comment sécuriser vos serveurs MCP ?

La sécurité MCP repose sur le système de permissions de Claude Code. Par défaut, chaque outil MCP déclenche une demande d'approbation lors du premier appel.

Niveaux de permission

Bonnes pratiques de sécurité

Appliquez ces règles pour protéger votre environnement :

1. Stockez les tokens dans des variables d'environnement, jamais en clair dans le JSON
2. Limitez la portée des tokens GitHub au minimum requis (scope repo uniquement si nécessaire)
3. Auditez les outils exposés avec /mcp list avant chaque session sensible
4. Utilisez la portée projet pour restreindre les serveurs disponibles par dépôt
5. Vérifiez la provenance des serveurs MCP - privilégiez les packages du registre officiel @modelcontextprotocol

les serveurs MCP stdio s'exécutent avec les permissions de l'utilisateur système local. Un serveur malveillant peut accéder à tout fichier lisible par votre compte. Validez systématiquement le code source des serveurs tiers.

Le système de permissions de Claude Code s'applique uniformément aux outils MCP et aux outils natifs. Pour configurer finement ces autorisations, consultez le guide des permissions et de la sécurité.

À retenir : ne faites confiance qu'aux serveurs MCP du registre officiel et stockez vos secrets dans des variables d'environnement.

Quels sont les serveurs MCP les plus populaires en 2026 ?

Voici les serveurs MCP les plus utilisés avec Claude Code. Chaque serveur est un package npm ou Python installable en une commande.

Installation rapide des 3 serveurs essentiels

# GitHub - gestion de dépôts et issues
claude /mcp add github -e GITHUB_TOKEN=ghp_xxx -- npx -y @modelcontextprotocol/server-github

# Brave Search - recherche web
claude /mcp add brave -e BRAVE_API_KEY=BSA_xxx -- npx -y @anthropic/mcp-server-brave-search

# Playwright - navigation et tests web
claude /mcp add playwright -- npx -y @anthropic/mcp-server-playwright

le registre officiel MCP référence plus de 3 000 serveurs communautaires compatibles avec la spécification MCP v2025-03-26. le serveur GitHub cumule plus de 2 millions de téléchargements npm.

SFEIR Institute propose la formation Claude Code d'une journée qui inclut des labs pratiques sur la configuration de serveurs MCP, la gestion des permissions et l'intégration GitHub. Vous y configurez votre environnement de bout en bout avec un formateur expert.

Le guide de dépannage MCP couvre les erreurs courantes d'installation de ces serveurs.

À retenir : GitHub, Brave Search et Playwright couvrent les trois cas d'usage les plus fréquents - code, recherche et navigation.

Comment utiliser les outils MCP pendant une session ?

Une fois un serveur connecté, ses outils sont automatiquement disponibles dans votre session Claude Code. Vérifiez la disponibilité avec /mcp list, puis utilisez les outils en langage naturel.

Exemples d'utilisation en conversation

# Utiliser GitHub MCP
> Crée une issue sur le repo sfeir/claude-demo avec le titre "Bug: timeout API"

# Utiliser Brave Search MCP
> Recherche les dernières nouveautés de Next.js 15

# Utiliser Playwright MCP
> Ouvre https://example.com et fais une capture d'écran

Flux d'approbation des outils

Quand Claude Code invoque un outil MCP pour la première fois, une demande de permission apparaît dans le terminal. Vous avez trois options :

1. Accepter une fois - autorise cet appel uniquement
2. Toujours accepter - autorise cet outil pour la session en cours
3. Refuser - bloque l'appel et continue la conversation

Claude Code exécute les outils MCP avec un timeout par défaut de 60 secondes par appel. En pratique, les requêtes Brave Search répondent en 800 ms en moyenne, tandis que Playwright peut nécessiter 5 à 15 secondes pour le rendu d'une page complète.

Concrètement, vous pouvez chaîner plusieurs outils MCP dans une même conversation. Par exemple : rechercher avec Brave, ouvrir le résultat avec Playwright, puis créer une issue GitHub avec les informations collectées.

Explorez le guide de vos premières conversations pour découvrir comment structurer vos prompts avec les outils MCP.

À retenir : les outils MCP s'utilisent en langage naturel - Claude Code gère les appels techniques de manière transparente.

Comment dépanner un serveur MCP qui ne répond pas ?

Les problèmes de connexion MCP suivent des schémas prévisibles. Suivez cette procédure de diagnostic en 5 étapes.

Erreurs fréquentes et solutions

# Erreur : "spawn npx ENOENT"
# Solution : vérifier que Node.js 22+ est installé
node --version  # doit afficher v22.x ou supérieur

# Erreur : "GITHUB_TOKEN is not set"
# Solution : passer le token via -e
claude /mcp add github -e GITHUB_TOKEN=$(gh auth token) -- npx -y @modelcontextprotocol/server-github

# Erreur : "Connection timeout"
# Solution : vérifier la connectivité réseau pour les serveurs SSE/HTTP
curl -I https://mcp.example.com/sse

70 % des erreurs MCP proviennent d'un token manquant ou expiré. Vérifiez vos variables d'environnement en priorité.

Pour un diagnostic approfondi, le guide de dépannage MCP référence les 15 erreurs les plus courantes avec leurs solutions. Vous pouvez également consulter la checklist MCP pour valider votre configuration point par point.

À retenir : 70 % des erreurs MCP viennent de tokens manquants - vérifiez env en premier.

Peut-on créer son propre serveur MCP personnalisé ?

Oui. Le SDK MCP est disponible en TypeScript (Node.js 22+) et Python (3.12+). Créez un serveur minimal en moins de 50 lignes de code.

// server.ts - Serveur MCP minimal avec Node.js 22
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", "Saluer l'utilisateur", { name: { type: "string" } },
  async ({ name }) => ({
    content: [{ type: "text", text: `Bonjour ${name} !` }]
  })
);

const transport = new StdioServerTransport();
await server.connect(transport);

# Enregistrer votre serveur personnalisé dans Claude Code
claude /mcp add mon-serveur -- npx tsx server.ts

Le SDK TypeScript @modelcontextprotocol/sdk v1.12.0 pèse 45 KB minifié. Le SDK Python mcp v1.8.0 s'installe via pip et supporte asyncio nativement.

Pour aller plus loin dans la création de serveurs MCP, la formation Développeur Augmenté par l'IA – Avancé de SFEIR Institute consacre un module entier à la création de serveurs MCP personnalisés avec des labs guidés sur une journée. La formation Développeur Augmenté par l'IA couvre quant à elle les fondamentaux de l'intégration IA sur 2 jours, avec des exercices pratiques d'utilisation de MCP dans des workflows réels.

Retrouvez les bonnes pratiques Git pour versionner vos serveurs MCP dans le guide d'intégration Git.

À retenir : le SDK MCP TypeScript et Python permet de créer un serveur fonctionnel en moins de 50 lignes de code.

Quels raccourcis et astuces accélèrent le travail avec MCP ?

Optimisez votre flux de travail MCP avec ces techniques avancées.

Configuration recommandée pour un projet type

{
  "permissions": {
    "allow": [
      "mcp__github__search_repositories",
      "mcp__github__get_file_contents",
      "mcp__brave__brave_web_search"
    ],
    "deny": [
      "mcp__github__delete_repository"
    ]
  }
}

Cette configuration autorise automatiquement les outils de lecture GitHub et Brave Search tout en bloquant les opérations destructives. Concrètement, vous réduisez de 40 % le nombre de confirmations manuelles par session.

Pour maîtriser l'ensemble des outils de productivité Claude Code, le guide complet MCP constitue la référence centrale du silo.

À retenir : combinez portée projet, auto-approve sélectif et alias courts pour un workflow MCP fluide.

---