La réponse courte
La plupart des applications d’IA gardent leurs serveurs MCP dans un fichier JSON, sous la clé mcpServers. VS Code utilise servers, Zed context_servers et Codex une table TOML. Trouvez votre application ci-dessous, modifiez son fichier, puis quittez-la et rouvrez-la. Les limites d’outils sont rares : VS Code en autorise 128 par requête et Windsurf 100.
Dans ce guide
Où est le fichier de configuration MCP de chaque application ?
La plupart des applications ont un fichier pour tous vos projets et un pour un seul projet. Le tableau donne les deux, comment les ouvrir, et la clé sous laquelle vont vos serveurs.
| Application | Fichier de configuration | Clé |
|---|---|---|
Claude Codeclaude mcp add, ou /mcp dans une session |
~/.claude.json. Le .mcp.json d’un projet est fait pour être partagé avec votre équipe. | mcpServers |
| Claude DesktopSettings (Paramètres), Developer (Développeur), Edit Config |
| mcpServers |
| Cursor |
| mcpServers |
VS CodeCommande : MCP: Open User Configuration |
| serversFormat propre à VS Code. Un .mcp.json portable à la racine du projet utilise mcpServers. |
| WindsurfLa documentation de Windsurf se trouve désormais sous Devin Desktop |
| mcpServers |
| Gemini CLI |
| mcpServers |
Codexcodex mcp add <name> -- <command> |
| [mcp_servers.<name>]Une table TOML par serveur. |
| LM StudioOnglet Program, Install, Edit mcp.json |
| mcpServers |
| ClineIcône MCP Servers, onglet Configure, Configure MCP Servers |
CLINE_MCP_SETTINGS_PATH pour déplacer le fichier. Dans VS Code, il se trouve dans le dossier des paramètres utilisateur. | mcpServers |
| Roo CodeMCP settings, Edit Global MCP ou Edit Project MCP |
| mcpServers |
| Amazon QPanneau de chat, icône des outils |
default.json. Les anciens ~/.aws/amazonq/mcp.json et .amazonq/mcp.json sont toujours lus par défaut. | mcpServersDans l’ancien mcp.json. |
ZedCommande : zed: open settings file |
| context_servers |
~ est votre dossier personnel : C:\Users\you sous Windows.
Comment configurer un serveur MCP distant dans chaque application ?
Un serveur distant (HTTP) a besoin d’une URL, mais chaque application nomme les champs différemment. La même entrée ne se copie pas d’une application à l’autre.
| Application | Champs | À savoir |
|---|---|---|
| Claude Code |
| |
| Claude Desktop | — | Non écrit dans ce fichier. Ajoutez-le comme connecteur personnalisé, sous Connecteurs dans les paramètres de l’app. |
| Cursor |
| |
| VS Code |
| |
| Windsurf |
| Les deux noms fonctionnent pour l’adresse. |
| Gemini CLI |
| httpUrl désigne le HTTP streamable, url le SSE. |
| Codex |
| Écrit dans la table TOML du serveur. |
| LM Studio |
| |
| Cline |
| Utilisez sse pour l’ancien transport. |
| Roo Code |
| Utilisez sse pour l’ancien transport. |
| Amazon Q | — | Défini dans le panneau MCP : choisissez http comme transport, puis l’URL et d’éventuels en-têtes. |
| Zed |
|
Quelle est la limite d’outils MCP dans chaque application ?
Les limites d’outils sont rares. Deux applications en annoncent une. Les autres gèrent les longues listes d’outils à leur façon.
| Application | Limite | Comment elle gère les longues listes d’outils |
|---|---|---|
| VS Code | 128 outils par requête | Au-delà, VS Code signale Cannot have more than 128 tools per request. Désélectionnez des outils ou des serveurs entiers dans le sélecteur d’outils, ou définissez github.copilot.chat.virtualTools.threshold pour que VS Code regroupe les outils similaires. |
| Windsurf | 100 outils à la fois | Désactivez les outils un par un avec disabledTools dans l’entrée du serveur. |
| Cursor | Aucune annoncée | On cite souvent 40 outils. La documentation de Cursor ne donne aucune limite, et son article de janvier 2026 décrit le chargement à la demande des descriptions d’outils MCP. |
| Claude Code | Aucune annoncée | Tool Search est activé par défaut : seuls les noms d’outils entrent dans votre contexte tant qu’un outil n’est pas utilisé. |
| Codex | Aucune annoncée | Chaque serveur accepte des listes enabled_tools et disabled_tools. |
| Amazon Q | Aucune annoncée | Chaque outil est réglé sur Ask, Always allow ou Deny. |
Claude Desktop, Gemini CLI, LM Studio, Cline, Roo Code et Zed n’annoncent aucune limite d’outils.
Une limite concerne le nombre d’outils qui tiennent. Le coût de ces outils en tokens est une autre question, à laquelle répond le guide ci-dessous. Pourquoi MCP consomme autant de tokens
Pourquoi votre serveur MCP n’apparaît-il pas ?
Parcourez cette liste dans l’ordre. Elle suit le guide de dépannage du projet MCP, écrit pour Claude Desktop. Les quatre premières étapes valent pour toute application.
- Quittez complètement l’application, puis rouvrez-la
Le guide de Claude Desktop dit de la quitter complètement et de la relancer après avoir modifié son fichier. D’autres applications peuvent se recharger seules : rouvrez la vôtre si le serveur n’apparaît pas.
- Vérifiez le JSON et la clé
Une erreur de syntaxe, comme un guillemet manquant ou une virgule en trop, peut empêcher l’application de lire le fichier. Vérifiez ensuite la clé :
mcpServersdans la plupart des applications,serversdans VS Code,context_serversdans Zed. - Utilisez des chemins absolus
Les chemins dans
argsdoivent être absolus, pas relatifs. - Lancez la commande vous-même
Collez la commande et les arguments du serveur dans un terminal. Si elle échoue là, l’application ne peut pas non plus la démarrer.
- Lisez les journaux
Claude Desktop écrit
mcp.loget unmcp-server-NAME.logpar serveur, dans~/Library/Logs/Claudesous macOS et%APPDATA%\Claude\logssous Windows. - Sous Windows, vérifiez APPDATA
Si un journal affiche
${APPDATA}dans un chemin, ajoutezAPPDATAà l’envdu serveur avec sa valeur complète, par exempleC:\Users\you\AppData\Roaming\.
Faut-il modifier ces fichiers à la main ?
Pas pour tous les voir au même endroit. Delta MCP lit les réglages MCP de douze applications d’IA, celles des tableaux ci-dessus, sans rien modifier, et liste chaque serveur qu’il trouve.
Pour utiliser ces serveurs via Delta MCP, il bascule une application en ajoutant une entrée nommée mcpdelta. Il désactive l’entrée directe de chaque serveur qu’il déplace et garde l’original, pour le remettre comme il était. Dix applications sont basculées pour vous ; Codex et Zed se configurent à la main pour l’instant. Avant chaque changement, il enregistre une copie datée du fichier.
Les applications prises en charge, en détail
Questions
Où se trouve claude_desktop_config.json ?
Sous macOS, c’est ~/Library/Application Support/Claude/claude_desktop_config.json, et sous Windows %APPDATA%\Claude\claude_desktop_config.json. Le plus rapide est Settings, Developer, Edit Config, qui crée le fichier s’il n’existe pas. Claude Desktop est proposé sur macOS et Windows.
Où se trouve le mcp.json de Cursor ?
~/.cursor/mcp.json contient les serveurs de tous vos projets, et .cursor/mcp.json dans un projet ceux de ce projet. Les deux utilisent la clé mcpServers.
Où se trouve le mcp.json de VS Code ?
Celui d’un projet est .vscode/mcp.json. Le vôtre est dans le dossier de votre profil utilisateur : lancez MCP: Open User Configuration pour l’ouvrir. VS Code écrit les serveurs sous servers, pas sous mcpServers.
Quelle est la limite d’outils MCP dans VS Code ?
Une requête de chat peut avoir au plus 128 outils activés à la fois, et VS Code signale Cannot have more than 128 tools per request quand vous la dépassez. Désélectionnez des outils ou des serveurs dans le sélecteur d’outils, ou définissez github.copilot.chat.virtualTools.threshold pour que VS Code regroupe les outils similaires.
Cursor a-t-il une limite d’outils MCP ?
Sa documentation n’en annonce aucune ; le chiffre souvent cité est de 40 outils. En janvier 2026, Cursor a décrit le chargement à la demande des descriptions d’outils MCP.
Pourquoi ma config MCP ne marche-t-elle pas dans une autre application ?
La clé et les champs des serveurs distants diffèrent. La plupart des applications utilisent mcpServers ; VS Code utilise servers, Zed context_servers et Codex une table TOML. Un serveur distant s’écrit url dans Cursor, serverUrl ou url dans Windsurf, httpUrl ou url dans Gemini CLI, et type plus url dans Claude Code et VS Code.
Claude Desktop peut-il utiliser des serveurs MCP distants depuis son fichier de configuration ?
Non. Les serveurs distants s’ajoutent comme connecteurs personnalisés dans les paramètres de l’app. Les serveurs de claude_desktop_config.json relèvent d’un mécanisme distinct, et ils ne sont pas disponibles dans Cowork ni sur claude.ai.
Où Claude Code stocke-t-il les serveurs MCP ?
Vos propres serveurs, et ceux de chaque projet, sont dans ~/.claude.json. Le .mcp.json d’un projet, à sa racine, est fait pour être partagé avec votre équipe. Ajoutez un serveur avec claude mcp add, ou avec /mcp dans une session. Les deux fichiers utilisent la clé mcpServers.
Où se trouve le mcp_config.json de Windsurf ?
La documentation de Windsurf se trouve désormais sous Devin Desktop et indique ~/.config/devin/mcp_config.json sous macOS et Linux, et %APPDATA%\devin\mcp_config.json sous Windows. Les versions antérieures de Windsurf utilisent ~/.codeium/windsurf/mcp_config.json. Les serveurs vont sous mcpServers, et Windsurf autorise 100 outils à la fois.
Sources
- Claude Code, Connect Claude Code to tools via MCP (documentation) Les fichiers ~/.claude.json et .mcp.json, la clé mcpServers, le type http, Tool Search activé par défaut.
- Model Context Protocol, Connect to local MCP servers Les chemins de fichiers de Claude Desktop, Edit Config, le redémarrage, les étapes de dépannage et les dossiers de journaux.
- Claude Help Center, Get started with custom connectors using remote MCP Les serveurs distants sont des connecteurs personnalisés, distincts de claude_desktop_config.json.
- Cursor, Model Context Protocol (documentation) Les fichiers mcp.json global et de projet, mcpServers, url et headers ; aucune limite d’outils annoncée.
- Cursor, Dynamic context discovery (6 janv. 2026) Les descriptions d’outils MCP chargées à la demande.
- Cursor forum, About limitation of the number of MCP tools Le signalement d’une limite de 40 outils par un utilisateur.
- VS Code, Add and manage MCP servers in VS Code (documentation) Les fichiers mcp.json de l’espace de travail et de l’utilisateur, la clé servers, le .mcp.json portable, le type http.
- VS Code, Use tools with agents (documentation) La limite de 128 outils et son erreur, le sélecteur d’outils, les outils virtuels.
- Windsurf, Cascade MCP Configuration (documentation, now on Devin Desktop’s site) Le chemin de configuration, mcpServers, serverUrl ou url, la limite de 100 outils, disabledTools.
- Gemini CLI, MCP servers with Gemini CLI (documentation) Les fichiers settings.json, mcpServers, httpUrl et url.
- OpenAI Codex, Model Context Protocol (documentation) config.toml, la table mcp_servers, url, enabled_tools et disabled_tools, codex mcp add.
- LM Studio, Use MCP Servers (documentation) Edit mcp.json, mcpServers, url et headers.
- Cline, MCP (documentation) cline_mcp_settings.json et son dossier, l’onglet Configure, streamableHttp.
- Roo Code, Using MCP in Roo Code (documentation) Le mcp_settings.json global et le .roo/mcp.json du projet, streamable-http.
- AWS, MCP configuration for Q Developer in the IDE default.json et l’ancien mcp.json, le transport http, les autorisations d’outils.
- Zed, Model Context Protocol (documentation) Les chemins de settings.json, context_servers, url et headers.
- Delta MCP, Supported AI apps (documentation) Les douze applications que Delta MCP reconnaît, les fichiers qu’il lit, et comment il bascule chacune.
À lire ensuite
- Comment réduire la consommation de tokens MCP, et pourquoiMesurez votre consommation de tokens MCP avec /context, voyez les deux coûts (liste d’outils, allers-retours) et comparez les solutions, Tool Search compris.
- MCP ou CLI pour les agents IA : d’où vient la facture ?MCP ou CLI pour votre agent IA ? Ce que chacun coûte en tokens, ce que montrent les mesures, quand une CLI l’emporte, quand MCP l’emporte, et où le code gagne.
