Generador de configuración MCP para VS Code

Dónde vive la configuración MCP de VS Code

.vscode/mcp.json (per workspace) or user settings.json

Acertar con la ubicación importa tanto como el contenido. Una configuración correcta en el archivo equivocado no hace absolutamente nada, y ningún cliente informa de un error por un archivo que nunca miró: por eso el síntoma habitual es «simplemente no aparece» y no un mensaje que puedas buscar.

Qué espera VS Code

• Formato: JSON.
• Clave raíz: servers.
• Endpoint remoto: url, con conexión directa.

La clave raíz es servers, no mcpServers

Este es el que pilla a casi todo el mundo: VS Code usa "servers", mientras que Claude, Cursor y Windsurf usan todos "mcpServers". Una configuración copiada de cualquiera de ellos es JSON válido y no hace absolutamente nada. VS Code también admite un array "inputs" para que se pida un token y se guarde en el llavero del sistema en lugar de acabar versionado en el repositorio.

Por qué un generador y no la documentación

Porque los diez clientes que la gente usa de verdad discrepan en los cuatro puntos de arriba, y cada discrepancia falla en silencio. La clave raíz es mcpServers en la mayoría, pero servers en VS Code y context_servers en Zed. El endpoint remoto es url en la mayoría, serverUrl en Windsurf y httpUrl en Gemini CLI. Dos clientes no usan JSON en absoluto. Una configuración copiada entre dos cualesquiera de ellos normalmente se analizará y no conectará con nada.

Después de la configuración

Reinicia VS Code: la mayoría de clientes leen su configuración MCP solo al arrancar. Si el servidor aparece pero no lista herramientas, el problema ha pasado del archivo de configuración al servidor, y el MCP Inspector mostrará si completa un handshake y en qué transporte responde.

Herramientas relacionadas

• Validar una configuración de VS Code existente — comprobar un archivo que ya tienes frente a lo que espera VS Code.
• Convertir una configuración a VS Code — portarla desde otro cliente.
• Generadores para todos los demás clientes
• MCP Inspector — confirmar que el servidor en sí funciona.
• MCP Security Scanner — vale la pena mirarlo antes de apuntar un agente a un servidor que no escribiste tú.

Una configuración te conecta. No explica nada.

Todo en esta página existe para que una máquina hable con un servidor. No hace nada por la persona que decide si tu servidor merece conectarse: ella tampoco puede leer un archivo de configuración. MCP Showcase convierte la misma URL en un playground en vivo con documentación generada para cada herramienta, de modo que evaluar tu servidor cueste un clic en lugar de un archivo de configuración y un reinicio.