Générateur de configuration MCP — Claude, Cursor, VS Code, Windsurf et Codex
Définissez un serveur MCP une seule fois et obtenez le fichier de configuration ou la commande exacts pour Claude Desktop, Claude Code, Cursor, VS Code, Windsurf et Codex.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/you/projects"
]
},
"github": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.githubcopilot.com/mcp/",
"--header",
"Authorization:${MCP_HEADER_1}"
],
"env": {
"MCP_HEADER_1": "Bearer ${GITHUB_PAT}"
}
}
}
}
- Fichier : macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json (ouvrez-le depuis Settings > Developer > Edit Config). Quittez complètement Claude puis rouvrez-le après l’enregistrement.
- Les serveurs distants passent par un pont mcp-remote (nécessite Node.js). Avec une offre payante, vous pouvez plutôt ajouter l’URL dans Settings > Connectors, qui gère OAuth pour vous.
- Claude Desktop ne développe pas ${VAR} dans ce fichier ; remplacez ces espaces réservés par les vraies valeurs.
Tout se passe dans votre navigateur. Les configurations contiennent souvent des jetons d’API : rien de ce que vous tapez ou collez n’est envoyé ni conservé. Parcourir tous les outils gratuits.
Un problème, ou quelque chose à améliorer ? Nous lisons chaque message et corrigeons vite.
Ce générateur de configuration MCP rédige les réglages de serveur Model Context Protocol pour tous les grands clients d’IA à partir d’un seul formulaire. Chaque client attend un fichier légèrement différent : Claude Desktop et Cursor utilisent un objet "mcpServers", VS Code utilise "servers" avec un "type" obligatoire, Windsurf appelle l’URL distante "serverUrl", Claude Code exige "type" sur les entrées distantes, et Codex utilise des tables TOML. Saisissez la commande ou l’URL une fois et copiez la bonne version pour votre outil.
Le validateur fait l’inverse : collez une configuration qui ne se charge pas et il désigne l’erreur JSON, le champ manquant ou la clé que le client ne lit pas, puis charge les serveurs dans le formulaire pour que vous puissiez les convertir. Il vérifie la structure, pas l’existence du paquet du serveur ni la validité du jeton ; si un serveur échoue encore, consultez le journal MCP du client.
Mode d’emploi
- Cliquez sur un préréglage comme Filesystem ou GitHub, ou ajoutez un serveur vierge.
- Pour un serveur local, indiquez la commande (npx, uvx, docker) et mettez chaque argument sur sa propre ligne. Pour un serveur distant, indiquez l’URL et les éventuels en-têtes.
- Cochez si vous le souhaitez l’option qui sort les secrets du fichier et remplace les valeurs par des références ${VAR}.
- Choisissez votre client, puis copiez ou téléchargez le résultat et enregistrez-le à l’emplacement indiqué en dessous.
- Redémarrez le client (quittez complètement Claude Desktop) pour qu’il recharge la configuration. Pour corriger un fichier existant, collez-le dans Valider et convertir.
Questions fréquentes
Où se trouve claude_desktop_config.json ?
Sous macOS, dans ~/Library/Application Support/Claude/claude_desktop_config.json, et sous Windows dans %APPDATA%\Claude\claude_desktop_config.json. Le plus simple pour l’ouvrir est de passer par Settings > Developer > Edit Config dans Claude Desktop. Quittez complètement Claude puis rouvrez-le après l’enregistrement, car le fichier n’est lu qu’au démarrage.
Quelle est la différence entre le .mcp.json de Claude Code et claude mcp add ?
claude mcp add enregistre un serveur depuis le terminal. Avec la portée local par défaut, il est stocké dans ~/.claude.json pour vous et le projet en cours uniquement ; --scope user le rend disponible dans tous vos projets ; --scope project l’écrit dans .mcp.json à la racine du projet pour que l’équipe le partage via le contrôle de version. Chaque entrée de .mcp.json doit porter un "type" (stdio, http ou sse) ; une entrée avec une url mais sans type est lue comme stdio et échoue.
Pourquoi VS Code ignore-t-il ma configuration mcpServers ?
VS Code lit .vscode/mcp.json avec une clé de premier niveau "servers", et non "mcpServers", et chaque serveur exige "type": "stdio", "http" ou "sse". Un fichier copié d’un README pour Claude ou Cursor ne charge donc rien. Collez-le dans le validateur et convertissez-le au format VS Code.
Comment garder les clés d’API hors de ma configuration MCP ?
Référencez des variables d’environnement au lieu de coller les valeurs. Claude Code développe ${VAR} et ${VAR:-default} ; Cursor et Windsurf utilisent ${env:VAR} ; VS Code prend en charge ${env:VAR} et les invites ${input:id} qui stockent le secret de façon sécurisée ; Codex transmet les variables avec env_vars, env_http_headers et bearer_token_env_var. Claude Desktop ne développe pas les variables dans sa configuration : les valeurs doivent y être écrites en clair.
Comment ajouter un serveur MCP distant à Claude Desktop ?
Le fichier de configuration de Claude Desktop ne lance que des commandes locales. Avec les offres payantes, vous pouvez ajouter l’URL d’un serveur distant dans Settings > Connectors, qui gère aussi la connexion OAuth. Sinon, faites le pont avec mcp-remote : la commande est npx avec les arguments -y, mcp-remote et l’URL du serveur, plus des options --header pour l’authentification. Le générateur écrit ce pont pour vous quand vous choisissez Claude Desktop.
Quelle est la différence entre les transports stdio, HTTP et SSE ?
Les serveurs stdio tournent en tant que processus local que le client lance et avec lequel il communique via l’entrée et la sortie standard, ce qui convient aux outils qui lisent des fichiers ou s’exécutent sur votre machine. Les serveurs Streamable HTTP tournent à distance à une URL et sont la norme actuelle pour les serveurs hébergés. SSE est l’ancien transport distant ; Claude Code le marque comme obsolète et Codex ne prend en charge que le streamable HTTP : préférez donc HTTP quand un serveur propose les deux.
Emplacements et formats des fichiers de configuration MCP
• Claude Desktop : claude_desktop_config.json dans ~/Library/Application Support/Claude (macOS) ou %APPDATA%\Claude (Windows). Clé de premier niveau "mcpServers" ; les entrées ont command, args et env.
• Claude Code : .mcp.json à la racine du projet (portée project) ou ~/.claude.json (portées local et user, gérées par claude mcp add). Clé "mcpServers" avec "type" sur chaque entrée.
• Cursor : .cursor/mcp.json dans le projet ou ~/.cursor/mcp.json au niveau global. "mcpServers" ; les entrées distantes utilisent "url" et "headers".
• VS Code : .vscode/mcp.json dans l’espace de travail, ou le fichier utilisateur ouvert avec "MCP: Open User Configuration". Clé "servers" plus "inputs" facultatif.
• Windsurf : ~/.codeium/windsurf/mcp_config.json. La documentation de Windsurf se trouve désormais sous Devin Desktop, qui utilise ~/.config/devin/mcp_config.json (macOS/Linux) ou %APPDATA%\devin\mcp_config.json. Les entrées distantes utilisent "serverUrl".
• Codex : ~/.codex/config.toml, ou .codex/config.toml dans un projet approuvé. Une table [mcp_servers.<name>] par serveur, avec command/args/env ou url plus bearer_token_env_var et http_headers.
Raisons courantes pour lesquelles un serveur MCP ne se charge pas
• Toute la commande est dans "command" ("npx -y @scope/server"). Le client cherche alors un exécutable portant ce nom complet. Mettez npx dans command et le reste dans args, un élément par argument.
• Une virgule finale ou un commentaire // dans le JSON. Seul le mcp.json de VS Code accepte les commentaires ; les autres clients exigent du JSON strict.
• npx ou uvx introuvable. Sous macOS, les applications graphiques n’héritent pas toujours du PATH de votre shell ; utilisez comme commande le chemin complet donné par `which npx`.
• La mauvaise clé de premier niveau : "servers" dans un fichier Claude ou Cursor, ou "mcpServers" dans VS Code.
• Une entrée distante sans "type" dans le .mcp.json de Claude Code, qui est alors traitée comme une commande locale.
• Le client n’a pas été redémarré. Claude Desktop ne lit le fichier qu’au démarrage ; Cursor et VS Code affichent l’état des serveurs dans leurs panneaux de réglages MCP.
Points de sécurité avant d’ajouter un serveur
Un serveur MCP s’exécute avec vos permissions : un serveur de fichiers peut lire et modifier chaque dossier que vous listez, et un serveur de base de données peut lancer des requêtes avec les identifiants que vous lui donnez. Accordez la portée la plus étroite possible : un seul dossier de projet, un utilisateur de base de données en lecture seule ou un jeton GitHub à granularité fine limité aux dépôts nécessaires.
Installez les serveurs depuis leur éditeur officiel, figez les versions de tout ce qui touche la production, et préférez les serveurs distants avec OAuth aux jetons à longue durée de vie collés dans un fichier. Traitez la sortie des outils comme une entrée non fiable : une page web ou une issue récupérée par un serveur peut contenir des instructions destinées au modèle.
Outils gratuits similaires
- Formateur JSON — Indentez, minifiez et validez du JSON, avec les erreurs d’analyse localisées par ligne et colonne. Dans votre navigateur, sans envoi.
- Générateur de modèles de prompt — Rédigez un prompt avec des {{variables}}, remplissez-le depuis un formulaire ou un CSV, et exportez un prompt par ligne en texte, CSV ou fichiers batch OpenAI et Anthropic.
- Calculateur de coût d’API LLM — Comparez le coût de votre charge de travail sur plus de 40 modèles, avec cache, remises batch, paliers de contexte long et tokens de raisonnement. Prix sourcés et datés.
- Générateur llms.txt — Créez un llms.txt conforme à la spécification à partir d’un formulaire, d’une liste d’URL ou de votre sitemap, validez un fichier existant et générez des règles robots.txt pour les robots d’IA.