MCP : connecter Claude Code à vos outils — Claude Code 101

Une partie de ce dont Claude a besoin ne se trouve pas dans votre dépôt : le ticket qui décrit la fonctionnalité, le tableau de bord des erreurs, la maquette posée dans un outil de design. Le Model Context Protocol (MCP) est le standard ouvert qui permet de brancher Claude Code sur ces sources externes. Un serveur MCP expose des outils ; une fois connecté, Claude s’en sert comme de ses outils intégrés.

Ce que MCP rend possible

La documentation donne des exemples de demandes qui deviennent possibles avec les bons serveurs connectés :

« Ajoute la fonctionnalité décrite dans le ticket JIRA ENG-4521 et crée une PR sur GitHub. »
« Vérifie dans Sentry et Statsig l’usage de la fonctionnalité décrite dans ENG-4521. »
« Trouve dans notre base PostgreSQL les e-mails de 10 utilisateurs qui ont utilisé ENG-4521. »
« Mets à jour notre modèle d’e-mail d’après les nouvelles maquettes Figma postées dans Slack. »

D’abord : y a-t-il une CLI ?

Avant d’ajouter un serveur MCP, posez-vous la question que posent les bonnes pratiques officielles : le système a-t-il une interface en ligne de commande ? Si oui, c’est en général le chemin le plus simple. Avec gh installé et connecté, Claude ouvre des pull requests et lit les commentaires de revue sans explication ; pour une CLI qu’il ne connaît pas, lui indiquer --help suffit. MCP sert aux systèmes qui n’en ont pas.

Ajouter un serveur

Un serveur distant en HTTP est l’option recommandée pour les services en ligne :

# Syntaxe
claude mcp add --transport http <nom> <url>

# Exemple : Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

Un serveur local (stdio) tourne comme un processus sur votre machine. Le double tiret -- sépare les options de Claude Code de la commande qui lance le serveur :

claude mcp add --env AIRTABLE_API_KEY=VOTRE_CLE --transport stdio airtable \
  -- npx -y airtable-mcp-server

L’ancien transport SSE est déprécié : préférez HTTP quand le serveur le propose. Depuis la version 2.1.265, --transport http bascule seul sur SSE quand le serveur n’accepte que ce transport ; sur une version plus ancienne, passez --transport sse.

Trois portées

Portée	Disponible	Partagée avec l’équipe	Stockée dans
Local (par défaut)	Ce projet seulement	Non	`~/.claude.json`
Projet	Ce projet	Oui, par git	`.mcp.json` à la racine du projet
Utilisateur	Tous vos projets	Non	`~/.claude.json`

Ajoutez --scope project pour écrire le serveur dans .mcp.json et le partager. Par sécurité, un serveur déclaré dans un .mcp.json doit être approuvé : un dépôt cloné ne peut pas approuver ses propres serveurs, il faut lancer claude et accepter la boîte de dialogue de confiance.

Gérer vos serveurs

claude mcp list          # lister les serveurs configurés
claude mcp get notion    # détails d'un serveur
claude mcp remove notion # supprimer un serveur

Dans une session, /mcp affiche l’état des serveurs (une coche pour un serveur connecté, une croix sinon) et sert à s’authentifier auprès de ceux qui le demandent.

Un exemple complet : GitHub

Le serveur MCP distant de GitHub s’authentifie avec un jeton d’accès personnel. Créez un jeton à granularité fine limité aux dépôts voulus, puis :

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

claude mcp add enregistre la configuration sans vérifier le jeton : contrôlez la connexion avec /mcp. Vous pouvez ensuite demander « Relis la PR n° 456 et propose des améliorations » ou « Montre-moi toutes les PR ouvertes qui me sont assignées ». Un serveur peut aussi exposer des ressources que vous citez avec @, sous la forme @serveur:ressource.

Ce que coûte un serveur, et le risque à connaître

Au démarrage, Claude Code ne charge que les noms des outils MCP ; leurs définitions complètes ne sont chargées qu’à la demande. Brancher plusieurs serveurs pèse donc peu tant que leurs outils ne servent pas.

Le risque est ailleurs. La documentation l’écrit en avertissement : vérifiez que vous faites confiance à chaque serveur avant de le connecter. Un serveur qui récupère du contenu externe peut vous exposer à une injection de prompt : un texte piégé qui tente de détourner Claude. Pour trouver des serveurs, l’Anthropic Directory (claude.ai/directory) recense des connecteurs examinés, que vous ajoutez avec claude mcp add.

D'après la leçon « MCP » (Claude Academy, Claude Code 101) et la page Connect Claude Code to tools via MCP (documentation Claude Code).

À vous de jouer

Un premier serveur. Ajoutez un serveur MCP distant que votre équipe utilise, avec claude mcp add --transport http, puis vérifiez sa connexion avec /mcp. Posez une question qui l’oblige à s’en servir, et regardez dans la réponse quel outil MCP Claude a appelé.

Sources officielles : MCP (Claude Academy) · Connect Claude Code to tools via MCP · Best practices

Points clés à retenir

MCP est un standard ouvert qui branche Claude Code sur des services externes ; les outils d’un serveur s’utilisent comme les outils intégrés
Préférez une CLI quand elle existe ; MCP sert aux systèmes qui n’en ont pas
claude mcp add --transport http <nom> <url> pour un serveur distant, -- <commande> pour un serveur local
Portées : locale par défaut, projet (.mcp.json, partagé), utilisateur (tous vos projets) ; /mcp montre l’état
Ne connectez que des serveurs de confiance : risque d’injection de prompt