MCP : connecter Claude Code à tes outils

Claude Code sait lire tes fichiers, écrire du code et lancer des commandes. Mais il y a une limite : par défaut, il ne voit rien en dehors de ton système de fichiers local. MCP change ça. C'est le mécanisme qui permet à Claude Code de parler à une base de données, à GitHub, à Notion ou à n'importe quel autre outil externe, tout en restant dans ton terminal.

Qu'est-ce que MCP ?

MCP (Model Context Protocol) est un protocole open-source standardisé, créé par Anthropic et adopté par la communauté. Son rôle : définir un langage commun entre un agent IA (le client) et des outils externes (les serveurs).

Pense-y comme un connecteur universel. Avant MCP, chaque intégration IA-outil était un câble propriétaire sur mesure. Avec MCP, c'est un port unique que n'importe quel outil peut implémenter.

Concrètement, un serveur MCP expose trois types de primitives :

• Tools : des fonctions que Claude peut appeler (requête SQL, lecture de fichier, appel API).
• Resources : des données contextuelles que Claude peut lire (schéma d'une base, contenu d'un fichier distant).
• Prompts : des templates réutilisables pour structurer les interactions.

Claude Code joue le rôle de client MCP. Il découvre les outils disponibles, les expose au modèle, et relaie les appels vers les serveurs concernés.

Ajouter un serveur MCP avec claude mcp add

Claude Code propose une commande dédiée pour brancher un serveur MCP. Il existe deux modes principaux : les serveurs distants (HTTP) et les serveurs locaux (stdio).

Serveur distant (HTTP)

La plupart des services grand public proposent aujourd'hui un endpoint MCP hébergé. Par exemple, pour Notion :

$claude mcp add --transport http notion https://mcp.notion.com/mcp

Ou pour GitHub (avec un token d'authentification) :

$claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer TON_TOKEN"

Serveur local (stdio)

Certains serveurs tournent en local sur ta machine, via un process lancé par Claude Code lui-même. C'est souvent le cas pour les serveurs de bases de données ou les outils en ligne de commande :

$claude mcp add --transport stdio --env MA_CLE_API=ta_valeur mon-outil -- npx -y nom-du-paquet-mcp

La partie après -- est la commande exacte que Claude Code va executer pour démarrer le serveur.

Vérifier les serveurs connectés avec /mcp

Une fois un serveur ajouté, tu peux vérifier son état directement dans la session Claude Code avec la slash command /mcp.

$/mcp

Cette commande ouvre un panneau qui liste tous tes serveurs MCP configurés, leur statut (connecté, erreur, en attente d'auth), et te permet de gérer les autorisations par projet.

Tu peux aussi lister tes serveurs depuis le terminal, en dehors d'une session :

$claude mcp list

Stocker la config dans .mcp.json

La commande claude mcp add enregistre le serveur pour toi seul, en local. Pour partager la configuration avec ton équipe ou la versionner dans le projet, crée un fichier .mcp.json à la racine du dépôt.

{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    },
    "ma-base": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "nom-du-paquet-mcp"],
      "env": {
        "MA_CLE_API": "${MA_CLE_API}"
      }
    }
  }
}

Les variables d'environnement entre ${} sont résolues depuis ton shell au moment du lancement. Les secrets ne sont donc jamais écrits en clair dans le fichier versionné.

Quelques serveurs MCP à connaître

La spec MCP est portée par Anthropic, mais l'écosystème est ouvert. Voici trois serveurs qui illustrent bien la diversité des cas d'usage :

Filesystem - Accès sécurisé au système de fichiers, avec contrôle fin des dossiers accessibles. Utile pour donner à Claude Code un périmètre explicite sur ton arborescence.

GitHub - Lire les PR, créer des issues, poster des reviews sans quitter le terminal. Claude peut parcourir l'historique et commenter directement.

Supabase - Brancher Claude Code sur ta base PostgreSQL et tes fonctions Edge. C'est l'exemple développé dans la prochaine étape de ce pont, côté Supabase.