Gérer et partager les MCP server

Organiser les server avec des scopes, les partager avec l'équipe

⏱ Estim. ~5 min

01 · Lire

Quand tu ajoutes un MCP server, tu choisis un scope qui détermine qui le voit et où il est stocké.

Local (par défaut) — privé, uniquement dans le projet actuel. Stocké dans ~/.claude.json sous le chemin de ton projet. À utiliser pour les server de développement personnel ou ceux avec des credentials sensibles.

Project — partagé avec ton équipe via un .mcp.json à la racine du repo. Tu le commits dans git, et toute personne qui clone le repo récupère les mêmes server. À utiliser pour les outils standards de l'équipe.

User — disponible sur tous tes projets. Stocké dans ~/.claude.json. Idéal pour tes outils personnels que tu utilises partout (comme GitHub ou ta base de données personnelle).

Points clés

Local (par défaut) : privé, uniquement le projet actuel
Project : partagé avec l'équipe via .mcp.json dans le repo, commit dans git
User : personnel, disponible sur tous tes projets
Choisis avec --scope local|project|user

02 · Exemple de code

Le flag --scope contrôle l'endroit où la configuration du server est stockée.

Scope local (par défaut — juste toi, ce projet)

claude mcp add --transport http stripe https://mcp.stripe.com

Scope project (partagé avec l'équipe via git)

claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp

Scope user (toi, tous tes projets)

claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp/

Local est la valeur par défaut — tu n'as pas besoin de --scope local. Le scope project crée un fichier .mcp.json dans ton repo, que tes collègues récupèrent lors d'un pull. Le scope user vit dans la configuration de ton répertoire personnel et te suit partout.

03 · Exemple de code

Quand tu utilises --scope project, Claude Code crée un fichier .mcp.json à la racine de ton repo. Voilà à quoi il ressemble — tu peux le commiter dans git.

.mcp.json (commit dans le repo)

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "db": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

Remarque la syntaxe ${DATABASE_URL} — les variables d'environnement sont résolues à l'exécution, ce qui te permet de partager la configuration sans exposer tes secrets. Chaque collègue définit DATABASE_URL dans son propre environnement. La structure du fichier suit le format standard que Claude Code lit automatiquement.

04 · Lire

Une fois les server configurés, tu les gères avec quelques commandes simples.

claude mcp list affiche tous les server. claude mcp get <name> montre les détails d'un server. claude mcp remove <name> supprime un server.

Dans Claude Code, tape /mcp pour voir le statut des server, t'authentifier auprès des server OAuth ou résoudre des problèmes de connexion. Quand un server ne répond pas, /mcp est le premier endroit à diagnostiquer.

Points clés

claude mcp list — voir tous les server configurés
claude mcp get <name> — détails d'un server
claude mcp remove <name> — supprimer un server
/mcp dans Claude Code — statut, auth, résolution de problèmes

05 · Quiz

Toute ton équipe doit utiliser le même MCP server Sentry. Tu veux que la configuration soit commitée dans git et que les nouveaux membres la récupèrent automatiquement. Quel scope choisir ?

Local (par défaut)
Project
User
Global

06 · Glisser pour trier

Tu as trois MCP server différents à configurer. Associe chacun au bon scope selon qui doit y accéder.

(Cette section est interactive — active JavaScript pour l'utiliser.)

Autres leçons de ce chapitre

⚠ L'expérience interactive complète nécessite JavaScript. Active-le et recharge la page.

※ Ce site est un projet éducatif indépendant — pas un produit officiel d'Anthropic. Claude™ est une marque déposée d'Anthropic, PBC.