Configurer le MCP dans Claude Code

Ce que le MCP vous apporte dans Claude Code

Connectez un serveur quand vous vous surprenez a copier des donnees d'un autre outil dans le chat, comme un issue tracker, une base de donnees ou un dashboard de monitoring. Une fois connecte, Claude peut lire et agir directement sur ce systeme. Un serveur MCP expose des tools (des actions que l'agent peut executer), des resources (des donnees read-only qu'il peut recuperer) et des prompts (des templates reutilisables), et comme le MCP est un standard commun, une integration s'ecrit une fois par outil et fonctionne sur tout client compatible MCP. C'est pourquoi le support s'est repandu si vite et pourquoi il existe maintenant un serveur MCP pour presque tout ce que vous voudriez connecter.

• Implementer depuis un issue tracker: "Construis la fonctionnalite decrite dans JIRA ENG-4521 et ouvre une PR."
• Interroger une base de donnees directement, plutot que de copier des lignes dans le chat.
• Integrer des designs, des donnees de monitoring et d'autres services que l'agent ne pourrait pas voir autrement.
• Tools, resources et prompts: des actions a executer, des donnees a lire, des templates reutilisables.

Ajouter un serveur avec claude mcp add

Le moyen le plus rapide de connecter un serveur est la commande claude mcp add. Il y a trois transports. HTTP est le choix recommande pour les serveurs distants, bases sur le cloud. Stdio execute un serveur comme processus local sur votre machine, ideal pour les tools qui ont besoin d'un acces systeme direct. SSE existe aussi mais est deprecated au profit de HTTP. Pour les serveurs stdio, le double tiret separe les options propres a Claude de la commande qui lance le serveur, et tout ce qui suit est passe tel quel au serveur.

# Remote HTTP server (recommended for cloud services)
claude mcp add --transport http notion https://mcp.notion.com/mcp

# HTTP server with a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# Local stdio server (note the -- before the command)
claude mcp add --transport stdio airtable \
  --env AIRTABLE_API_KEY=YOUR_KEY -- npx -y airtable-mcp-server

Choisir un scope

Le flag --scope decide qui peut utiliser le serveur et ou la config est stockee. Local (le defaut) le limite a vous dans le projet courant. Project le partage avec tout le monde via un fichier .mcp.json committe a la racine du repo, donc un serveur project-scoped est le bon choix pour les connexions dont toute votre equipe a besoin. User le rend disponible sur tous vos projets. Les serveurs qui ont besoin de credentials devraient les recevoir via des variables d'environnement (le flag --env), jamais comme des cles codees en dur, de sorte que la meme discipline .env s'applique et que les secrets restent hors de la config committee.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./data"]
    },
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

Les serveurs project-scoped depuis .mcp.json ne sont pas approuves automatiquement: ils apparaissent comme "pending approval" jusqu'a ce que vous les verifiiez et les approuviez quand vous lancez Claude interactivement, ce qui vous protege d'executer du code de serveur non fiable qu'un coequipier aurait ajoute.

Verifier et authentifier

Apres avoir ajoute un serveur, confirmez qu'il fonctionne. Depuis le shell, "claude mcp list" montre tous les serveurs configures et leur statut, "claude mcp get <nom>" montre les details de l'un d'eux, et "claude mcp remove <nom>" le supprime. A l'interieur d'une session Claude Code, le panneau /mcp montre chaque serveur connecte, son nombre de tools, et vous laisse authentifier avec les serveurs qui exigent OAuth 2.0 en vous guidant dans le login navigateur. Si une requete a besoin d'un serveur encore en cours de connexion, Claude l'attend avant de continuer.

# List all configured servers and their status
claude mcp list

# Details for one server
claude mcp get notion

# Remove a server
claude mcp remove notion

# Inside a session: check status and authenticate (OAuth)
/mcp

Serveurs courants et connecter avec discernement

De bonnes premieres connexions sont le serveur filesystem (limite a un dossier), le serveur Playwright (pour que l'agent puisse piloter un vrai navigateur) et un serveur de base de donnees pour votre stack. Mais connectez avec discernement: chaque serveur ajoute ses definitions de tools a votre context window, donc chacun a un cout reel et continu. Un serveur MCP est aussi du code tiers avec acces a vos systemes, donc verifiez ce que vous connectez comme une dependance. Souvent, un outil CLI que vous avez deja et que vous nommez dans votre CLAUDE.md fait le job avec moins de surcharge qu'un serveur dedie. Trois serveurs que vous utilisez battent quinze qui gonflent votre contexte.

Pas à pas

1. 01

   Choisir un serveur a connecter

   Decidez ce que l'agent doit atteindre et ne peut pas actuellement, comme une base de donnees, un navigateur ou un issue tracker, et trouvez son serveur MCP (HTTP pour les services cloud, stdio pour les tools locaux).

2. 02

   Ajouter avec claude mcp add

   Executez claude mcp add avec le bon transport: --transport http <nom> <url> pour du distant ou --transport stdio <nom> -- <command> pour du local. Passez les credentials avec --env, jamais codes en dur.

3. 03

   Choisir le scope

   Utilisez --scope project pour partager via un .mcp.json committe, --scope user pour tous vos propres projets, ou laissez le scope par defaut local pour ce projet uniquement. Approuvez les serveurs project en attente quand on vous le demande.

4. 04

   Verifier la connexion

   Executez "claude mcp list" pour confirmer le serveur et son statut, puis ouvrez /mcp dans une session pour voir son nombre de tools et authentifier via OAuth si le serveur l'exige.

5. 05

   Utiliser, et elaguer ce dont vous n'avez pas besoin

   Demandez a l'agent d'utiliser les tools du serveur. Supprimez les serveurs que vous n'utilisez pas avec "claude mcp remove" pour garder votre contexte leger, et preferez un CLI nomme dans CLAUDE.md si un CLI ferait le job.

Questions fréquemment posées

Continuez à apprendre