Générateur de configuration MCP
Créez la configuration du serveur MCP pour Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI ou Devin Desktop (anciennement Windsurf) : saisissez une commande ou l’URL d’un serveur, puis copiez le JSON ou le TOML ainsi que le nom du fichier où l’enregistrer.
Entrée
Sortie
| Emplacement | Fichier |
|---|---|
macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
Windows | %APPDATA%\Claude\claude_desktop_config.json |
Linux | ~/.config/Claude/claude_desktop_config.json |
Serveurs distants | Paramètres > Connecteurs > Ajouter un connecteur personnalisé |
Documentation
Qu’est-ce que MCP ?
Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA d’utiliser des outils et des données par l’intermédiaire de serveurs. Un serveur est soit un programme local que l’assistant lance sur votre ordinateur et avec lequel il communique via l’entrée et la sortie standard (stdio), soit un serveur distant que l’assistant joint via HTTP. Chaque assistant enregistre ses serveurs dans son propre fichier de configuration, et chaque fichier se présente un peu différemment.
Comment l’utiliser
- Choisissez votre client : l’assistant ou l’éditeur que vous utilisez.
- Donnez au serveur un nom composé de lettres, de chiffres, de tirets et de traits de soulignement.
- Pour un serveur local, saisissez la commande qui le lance (par exemple
npx,uvxoudocker), ses arguments, un par ligne, et les éventuelles variables d’environnement, comme des clés d’API, au formatKEY=value. Si vous avez collé une ligne de commande complète dans le champ de commande, le bouton de séparation situé à l’intérieur déplace tout ce qui suit le premier mot vers les arguments. - Pour un serveur distant, choisissez URL distante et saisissez l’URL du serveur ainsi que les éventuels en-têtes, comme
Authorization: Bearer <token>. - Copiez la configuration dans le fichier indiqué sous Où l’ajouter, ou téléchargez-la. Si le fichier contient déjà des serveurs, ajoutez la nouvelle entrée à la suite des autres dans
mcpServers([mcp_servers]dans Codex) plutôt que de remplacer tout le fichier. - Redémarrez l’application ou rechargez ses serveurs MCP.
Pour Claude Code, Codex CLI, Gemini CLI et VS Code, le champ Commande fournit aussi la commande de terminal qui ajoute le serveur à votre place.
Clients
| Client | Fichier de configuration | Bon à savoir |
|---|---|---|
| Claude Desktop | claude_desktop_config.json |
Ne contient que des serveurs locaux. Les serveurs distants s’ajoutent dans l’application, sous Paramètres > Connecteurs > Ajouter un connecteur personnalisé. |
| Claude Code | .mcp.json à la racine du projet |
claude mcp add enregistre plutôt les serveurs dans ~/.claude.json, pour vous seul. |
| Cursor | .cursor/mcp.json dans le projet, ou ~/.cursor/mcp.json |
|
| VS Code avec GitHub Copilot | .mcp.json à la racine de l’espace de travail, ou ~/.copilot/mcp-config.json |
L’ancien format servers de .vscode/mcp.json ne sert qu’à l’environnement local de VS Code, désormais obsolète. |
| Codex CLI | ~/.codex/config.toml |
Un fichier TOML. Les en-têtes d’un serveur distant ne peuvent être définis que dans le fichier, pas avec codex mcp add. |
| Gemini CLI | .gemini/settings.json dans le projet, ou ~/.gemini/settings.json |
Les serveurs distants utilisent httpUrl. |
| Devin Desktop (Windsurf) | ~/.config/devin/mcp_config.json, ou .devin/mcp_config.json |
Windsurf a été renommé Devin Desktop. Les clés personnelles vont dans .devin/mcp_config.local.json, qui reste en dehors du contrôle de version. |
Chrome enregistre un téléchargement nommé .mcp.json sous le nom mcp.json : rajoutez donc le point initial lorsque vous placez le fichier à son emplacement.
Protéger vos clés
Les fichiers de configuration stockent les clés d’API en texte clair. Ne versionnez pas un fichier de projet contenant de vraies clés dans un dépôt partagé. La plupart des clients peuvent lire une clé depuis votre environnement plutôt que depuis le fichier, chacun avec sa propre syntaxe, décrite dans sa documentation.
Tout est assemblé dans votre navigateur : les commandes, URL et clés que vous saisissez ne sont donc envoyées nulle part.