Pega tu configuración y mira qué hará Zed con ella en realidad. 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.
Acertar con la 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.
No se sube nada. La comprobación se ejecuta por completo en tu navegador.
Clave raíz, clave de endpoint, tipo de transporte y los campos específicos que Zed trata de forma distinta a todos los demás.
Cada problema viene con lo que Zed espera en su lugar, así que es un cambio que puedes hacer y no un síntoma que buscar.
Casi todas las configuraciones MCP rotas son JSON válido. Los clientes ignoran las claves que no reconocen, así que un archivo con la clave raíz equivocada o el campo de endpoint equivocado se analiza limpiamente, Zed arranca con normalidad y no aparece ningún servidor. No hay ningún error que buscar. Ese silencio es lo que hace que estos fallos sobrevivan tanto tiempo.
context_servers.
Cualquier otra cosa se analiza y se ignora.url.
La clave raíz de Zed es "context_servers", no "mcpServers", y ese nombre se mantiene en su interfaz y su documentación. Nada copiado de la configuración de otro cliente se leerá. Zed además fijó este nombre antes de que el ecosistema se estandarizara, así que las guías antiguas pueden no coincidir con lo que espera tu versión.
La comprobación se ejecuta por completo en tu navegador y no hace ninguna petición de red. Es deliberado y no accidental: las configuraciones MCP contienen tokens de API con frecuencia, y «pega tu configuración en esta web» es algo que es razonable rechazar. Puedes confirmarlo en la pestaña de red de tu navegador.
Entonces el problema ha salido del archivo. Un cliente que muestra el servidor pero ninguna herramienta está conectando y fallando en el handshake o en el transporte, no leyendo mal tu configuración. El MCP Inspector muestra en qué transporte responde el servidor y el registro de peticiones en bruto, y el MCP Server Tester reduce lo mismo a una lista de aprobado/fallo.
Una configuración que funciona es lo mínimo. Lo que no hace es ayudar a nadie a entender para qué sirve tu servidor, y si publicas un servidor MCP, eso es lo que decide si alguien llega a configurarlo. MCP Showcase convierte el mismo endpoint en un playground en vivo con documentación por herramienta, de modo que evaluarlo cueste un clic en lugar de un archivo de configuración y un reinicio.