La plupart des configurations MCP cassées sont du JSON valide : c'est exactement pour cela que rien ne vous signale qu'elles sont fausses. Choisissez votre client et découvrez ce qu'il fera réellement de votre fichier.
Réparer une configuration est la moitié ennuyeuse. MCP Showcase prend le même serveur et en fait un playground en direct que vos clients peuvent essayer, avec une documentation pour chaque outil.
Les vérifications diffèrent selon le client, parce que ce qui compte comme faux diffère selon le client.
Analysée dans votre navigateur. Rien n'est envoyé, ce qui compte quand les configurations contiennent des jetons.
Chaque problème indique ce que ce client attend à la place.
MCP normalise le protocole, pas la configuration. Ces dix clients lisent des fichiers différents, dans trois formats différents, avec des noms de clés différents pour la même chose. Le tableau ci-dessous rassemble tout le problème — et explique pourquoi une configuration copiée d'un client vers un autre s'analyse généralement proprement et ne se connecte à rien.
| Client | Format | Clé racine | Endpoint distant |
|---|---|---|---|
| Claude Desktop | JSON | mcpServers |
via un pont local |
| Claude Code | JSON | mcpServers |
url |
| Cursor | JSON | mcpServers |
url |
| VS Code | JSON | servers |
url |
| Windsurf | JSON | mcpServers |
serverUrl |
| Codex CLI | TOML | mcp_servers |
url |
| Gemini CLI | JSON | mcpServers |
httpUrl |
| Cline | JSON | mcpServers |
url |
| Zed | JSON | context_servers |
url |
| Continue | YAML | mcpServers |
url |
mcpServers. VS Code
lit servers, Zed lit context_servers, Codex CLI lit
mcp_servers. Mauvaise clé, fichier valide, aucun serveur, aucune erreur.url chez la plupart, serverUrl
pour Windsurf, httpUrl pour Gemini CLI quand le transport est Streamable HTTP.mcp-remote, ce qui est
une forme de configuration complètement différente.Tout ici sert des gens qui ont déjà décidé d'utiliser votre serveur. MCP Showcase s'adresse à ceux qui ne l'ont pas fait : pointez-le sur la même URL et il produit un playground en direct avec une documentation pour chaque outil, pour qu'évaluer votre serveur prenne un clic plutôt qu'un fichier de configuration et un redémarrage.