Ajouter un serveur MCP à Claude : Claude Desktop et Claude Code (guide 2026)

Publié le · Serveur MCP · 5 min de lecture

Par Amir N., éditeur de serveurmcp.com

Claude se connecte à vos outils grâce aux serveurs MCP. La méthode dépend de l’application : une commande dans Claude Code, un fichier de configuration dans Claude Desktop, ou un connecteur pour les serveurs distants.

Ce guide détaille chaque méthode, avec des commandes vérifiées sur Claude Code 2.1.293 et des exemples tirés de serveurs officiels.

L’essentiel en quatre points

  • Claude Code : claude mcp add dans le terminal, puis /mcp dans la session pour gérer les serveurs.
  • Claude Desktop : le fichier claude_desktop_config.json pour les serveurs locaux.
  • Serveurs distants : l’option --transport http dans Claude Code, un connecteur personnalisé dans Claude.
  • Passerelle : claude mcp add-from-claude-desktop importe dans Claude Code les serveurs déjà configurés dans Claude Desktop, sur Mac et sous WSL.

Ajouter un serveur MCP dans Claude Code

Toute la configuration passe par la commande claude mcp add, suivie d’un nom de votre choix, puis de l’URL ou de la commande du serveur.

Un serveur distant

Précisez le transport HTTP et l’adresse du serveur. Exemple avec le serveur officiel de Sentry :

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Si le serveur demande une connexion, lancez /mcp dans Claude Code ou claude mcp login sentry dans le terminal. Pour un serveur qui attend une clé dans un en-tête, ajoutez l’option --header :

claude mcp add --transport http mon-serveur https://exemple.com/mcp --header "Authorization: Bearer VOTRE_JETON"

Un serveur local

La commande qui lance le serveur se place après les deux tirets. Exemple avec Playwright :

claude mcp add playwright -- npx @playwright/mcp@latest

Les variables d’environnement passent par l’option -e. Exemple avec le serveur officiel de GitHub, lancé dans Docker :

claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=VOTRE_JETON -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Choisir la portée

L’option --scope décide qui profite du serveur :

Portée Pour qui Usage type
local (par défaut) Vous seul, dans ce projet Un essai, un serveur avec vos identifiants
user Vous seul, dans tous vos projets Vos outils de tous les jours, comme Context7
project Toute l’équipe, via le fichier .mcp.json du projet Les serveurs communs à un dépôt

Les serveurs déclarés dans un .mcp.json restent en attente tant que vous ne les avez pas approuvés. Ne placez jamais de jeton dans ce fichier partagé : utilisez des variables d’environnement.

Gérer ses serveurs

Commande Rôle
claude mcp list Lister les serveurs configurés et vérifier leur état
claude mcp get nom Afficher le détail d’un serveur
claude mcp remove nom Supprimer un serveur
claude mcp add-json nom 'json' Ajouter un serveur à partir d’une configuration JSON
claude mcp add-from-claude-desktop Importer les serveurs de Claude Desktop (Mac et WSL)
claude mcp login nom et logout Se connecter à un serveur, ou effacer ses identifiants OAuth
claude mcp reset-project-choices Réinitialiser les approbations des serveurs du projet
/mcp dans la session Parcourir les serveurs, se connecter, reconnecter, activer ou désactiver

Claude Code peut aussi jouer le rôle inverse : claude mcp serve le lance comme serveur MCP, utilisable par un autre client.

Ajouter un serveur MCP dans Claude Desktop

Un serveur local

Les serveurs locaux se déclarent dans le fichier claude_desktop_config.json :

  • sur Mac : ~/Library/Application Support/Claude/claude_desktop_config.json ;
  • sous Windows : %APPDATA%\Claude\claude_desktop_config.json.

Chaque serveur s’ajoute dans la section mcpServers, avec sa commande, ses arguments et, au besoin, ses variables d’environnement. Exemple avec Filesystem et GitHub :

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/vous/Documents"]
    },
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "VOTRE_JETON" }
    }
  }
}

Enregistrez, puis quittez complètement Claude Desktop et rouvrez-le pour qu’il charge les serveurs. Notre générateur de configuration écrit ce fichier pour vous, et le validateur détecte les erreurs avant le redémarrage.

Un serveur distant

Pour un serveur distant, comme Notion ou Figma, Claude propose d’ajouter un connecteur personnalisé à partir de son URL, selon votre offre. Vous vous connectez ensuite au service dans le navigateur. Claude Code sait lui aussi s’authentifier auprès des connecteurs de votre compte, avec claude mcp login.

Dépannage : les erreurs fréquentes

  • Le serveur n’apparaît pas dans Claude Desktop : le JSON est souvent invalide, une virgule en trop suffit. Passez le fichier au validateur, puis redémarrez complètement l’application.
  • Commande introuvable : npx exige Node.js, et les serveurs en conteneur exigent Docker. Vérifiez qu’ils sont installés et accessibles depuis le terminal.
  • Serveur en attente dans Claude Code : un serveur de projet doit être approuvé. claude mcp list l’indique, et claude mcp reset-project-choices remet les choix à zéro.
  • Erreur d’authentification : relancez la connexion avec /mcp ou claude mcp login nom, ou effacez les identifiants avec claude mcp logout nom.
  • Le serveur ne répond pas : testez-le seul avec MCP Inspector pour savoir si le problème vient du serveur ou de Claude.

Quels serveurs ajouter en premier ?

Commencez par un ou deux serveurs liés à votre usage réel. Quelques valeurs sûres, toutes officielles :

  • Context7, pour que Claude Code s’appuie sur une documentation à jour.
  • Playwright, pour piloter un navigateur.
  • Notion, pour travailler sur vos pages et bases.
  • Filesystem, pour donner accès à un dossier précis.

Notre sélection 2026 par usage et l’annuaire complètent cette liste.

Sécurité : les bons réflexes

Un serveur MCP agit avec vos droits. N’ajoutez que des serveurs dont vous connaissez l’éditeur, donnez-leur l’accès minimal, comme un seul dossier pour Filesystem, et relisez chaque action sensible avant de la valider. La checklist de sécurité détaille les points à vérifier.

Questions fréquentes

Comment ajouter un serveur MCP à Claude Code ?

Avec claude mcp add. Pour un serveur distant : claude mcp add --transport http nom URL. Pour un serveur local : claude mcp add nom -- commande.

Où se trouve le fichier claude_desktop_config.json ?

Dans ~/Library/Application Support/Claude/ sur Mac, et dans %APPDATA%\Claude\ sous Windows.

Claude Desktop accepte-t-il les serveurs MCP distants ?

Oui, sous forme de connecteurs personnalisés ajoutés à partir de l’URL du serveur, selon votre offre.

Comment voir les serveurs MCP installés dans Claude Code ?

Avec claude mcp list dans le terminal, ou la commande /mcp pendant une session.

Peut-on réutiliser la configuration de Claude Desktop dans Claude Code ?

Oui, sur Mac et sous WSL : claude mcp add-from-claude-desktop importe les serveurs déjà configurés.

Sources

Mis à jour le 8 octobre 2026.

Recevez gratuitement le guide complet du MCP

Une newsletter simple, sans spam. Désinscription en un clic.