Ajouter des serveurs MCP à Claude Code

Claude Code récupère les serveurs via la commande claude mcp add ou dans un fichier .mcp.json à la racine du dépôt.

macOS

~/.claude.json

Windows

~/.claude.json

Linux

~/.claude.json

Fichier de projet

.mcp.json

Clé de premier niveau

mcpServers

Format

json

OAuth pour les serveurs distants

●Oui

Exemple de configuration

Cet exemple ajoute le serveur hébergé de GitHub et Playwright en tant que serveur local, selon le format attendu par ce client.

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

Notes et particularités

• La portée locale, utilisée par défaut, et la portée utilisateur sont enregistrées dans ~/.claude.json ; la portée du projet se trouve dans .mcp.json.
• Chaque entrée contenant url doit aussi préciser un type, par exemple http ; une url seule provoque une erreur.
• Dans le fichier, les valeurs ${VAR} et ${VAR:-default} sont développées.
• Exécutez /mcp dans une session pour vous connecter aux serveurs OAuth. Pour les applications OAuth préenregistrées, transmettez --client-id, --client-secret et --callback-port.

Créer une configuration pour Claude Code →

Autres clients