La mayoría de configuraciones MCP rotas son JSON válido, que es justo por lo que nada te avisa de que están mal. Elige tu cliente y descubre qué hará en realidad con tu archivo.
Arreglar una configuración es la mitad aburrida. MCP Showcase toma el mismo servidor y produce un playground en vivo que tus clientes pueden probar, con documentación para cada herramienta.
Las comprobaciones cambian según el cliente, porque también cambia qué cuenta como incorrecto.
Se analiza en tu navegador. No se sube nada, algo que importa cuando las configuraciones llevan tokens.
Cada problema viene con lo que ese cliente espera en su lugar.
MCP estandariza el protocolo, no la configuración. Estos diez clientes leen archivos distintos, en tres formatos distintos, con nombres de clave distintos para lo mismo. La tabla de abajo reúne todo el problema en un sitio, y explica por qué una configuración copiada de un cliente a otro normalmente se analiza limpiamente y no conecta con nada.
| Cliente | Formato | Clave raíz | Endpoint remoto |
|---|---|---|---|
| Claude Desktop | JSON | mcpServers |
mediante un puente 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
lee servers, Zed lee context_servers, Codex CLI lee
mcp_servers. Clave equivocada, archivo válido, ningún servidor, ningún error.url en la mayoría, serverUrl
en Windsurf, httpUrl en Gemini CLI cuando el transporte es Streamable HTTP.mcp-remote,
que es una forma de configuración completamente distinta.Todo lo de aquí sirve a gente que ya decidió usar tu servidor. MCP Showcase es para quienes no lo han hecho: apúntalo a la misma URL y produce un playground en vivo con documentación para cada herramienta, de modo que evaluar tu servidor cueste un clic en lugar de un archivo de configuración y un reinicio.