Configuración MCP en VS Code: usa servers en lugar de mcpServers
Copiaste una configuración MCP que funcionaba en Claude o Cursor, la pegaste en VS Code, reiniciaste y no pasó nada. Ningún error, ningún aviso, ningún servidor en la lista. El archivo es JSON válido y a VS Code le parece perfecto. El problema es una sola palabra, y es la más externa.
- VS Code agrupa los servidores MCP bajo servers. Claude, Cursor y la mayoría de los demás usan mcpServers.
- La clave equivocada no produce ningún error, y por eso a la gente le cuesta una hora de depuración.
- La definición interna del servidor es idéntica en todos los clientes. Solo cambia la clave envolvente.
La diferencia, lado a lado
Mismo servidor, mismo comando, mismos argumentos. Lo único que cambia es la clave envolvente.
| Cliente | Archivo de configuración | Clave envolvente |
|---|---|---|
| GitHub Copilot en VS Code | .vscode/mcp.json | servers |
| Cursor | ~/.cursor/mcp.json | mcpServers |
| Claude Desktop | claude_desktop_config.json | mcpServers |
| La mayoría de los demás clientes basados en configuración | varía | mcpServers |
Lo que quiere VS Code
En .vscode/mcp.json, en la raíz de tu espacio de trabajo. Con el conector de MyLinedChart como ejemplo:
{ "servers": { "mylinedchart": { "command": "npx", "args": ["-y", "@mylinedchart/mcp-chart-context"] } } }
Sustituye el comando y los argumentos por los de tu propio servidor. La forma del objeto interno no cambia entre clientes.
Lo que quiere todo lo demás
El mismo servidor, para Claude o Cursor:
{ "mcpServers": { "mylinedchart": { "command": "npx", "args": ["-y", "@mylinedchart/mcp-chart-context"] } } }
Si tienes los dos editores abiertos, necesitas de verdad los dos archivos. Los dos editores no pueden compartir una misma configuración.
Por qué falla sin ningún error
VS Code lee el archivo, comprueba que es JSON válido y busca una clave servers. El archivo no tiene ninguna clave servers, así que VS Code encuentra cero servidores que arrancar. Cero servidores no es una condición de error. Desde el punto de vista de VS Code no has configurado nada, algo perfectamente legítimo.
Por eso no hay subrayado rojo, ni notificación, ni una sola entrada en ningún registro que diga que la clave era incorrecta. El fallo se ve igual que un servidor que se cae al arrancar, y por eso la gente se pone a depurar el servidor.
- El archivo es JSON válido, así que no aparece ningún error de análisis.
- Una clave de primer nivel desconocida se ignora en lugar de rechazarse.
- Tener cero servidores configurados es un estado normal, así que VS Code no informa de ningún fallo.
Cómo confirmar qué problema tienes
Antes de dar por hecho que el servidor está roto, comprueba que VS Code llegó a intentar arrancarlo.
- Revisa primero la clave envolvente. Comprobarlo cuesta cinco segundos y casi siempre es la respuesta.
- Ejecuta a mano el comando del servidor en una terminal. Si el servidor arranca, el problema está en otra parte.
- Busca el servidor en la lista de servidores MCP de VS Code. Si no aparece, nunca se configuró; si aparece pero falla, hay un error real de arranque.
- Si lo instalaste con un enlace de un clic en lugar de a mano, toda esta clase de problema no te afecta.
Dos trampas relacionadas
Ya que estás aquí, hay otras dos cosas que fallan igual de en silencio.
Primera: los enlaces de instalación MCP de un clic llevan su carga como JSON codificado en URL, en texto plano. El analizador de URL acepta Base64 y después no hace nada, que es el peor fallo posible: un botón que parece haber funcionado.
Segunda: en VS Code el nombre del servidor viaja dentro de la carga, y no como un parámetro de consulta aparte como lo hace Cursor. Un enlace construido con la forma de Cursor no se instalará correctamente en VS Code aunque se abra.
Dónde encaja MyLinedChart
MyLinedChart incluye un conector MCP que da a un agente de IA tu gráfico en vivo: símbolos, tus dibujos, valores de indicadores y las barras que ves en pantalla. El conector se ejecuta en tu equipo y los datos no pasan por nuestros servidores.
La app tiene un botón de un clic, Add to VS Code, que escribe la clave correcta por ti, y ese es el motivo para usarlo en vez de editar a mano. Configuración y otros clientes: /resources/articles/ibkr-chart-data-github-copilot-vs-code.
Siguiente paso
Corrige la clave, reinicia VS Code y el servidor aparecerá. Si el servidor sigue sin aparecer, ya sabes que el problema está en el servidor y no en la configuración, y esa es una lista mucho más corta de causas por revisar.
Conecta tu IA en /mcp.
Preguntas frecuentes
- ¿Por qué usa VS Code servers en lugar de mcpServers?
- La clave servers es una decisión de nomenclatura del propio formato de configuración MCP de VS Code, tomada con independencia de la convención que estableció Claude Desktop. Ninguna es más correcta. La diferencia solo se convierte en problema porque ambas parecen intercambiables y una de ellas falla sin avisar.
- ¿Me avisará VS Code si uso la clave equivocada?
- No, y ahí está toda la dificultad. El archivo es JSON válido, una clave de primer nivel desconocida se ignora en lugar de rechazarse y tener cero servidores configurados es un estado normal. Nada de ello parece un fallo.
- ¿Puedo usar un solo archivo de configuración para VS Code y Cursor?
- No. Leen rutas distintas y esperan claves envolventes distintas, así que necesitas los dos archivos. La definición interna del servidor es idéntica, de modo que basta con copiarla y cambiar una palabra.
- ¿Esto también se aplica al Copilot de Windows?
- No. El Copilot de aquí es GitHub Copilot dentro de VS Code, que admite servidores MCP. El asistente de la barra de tareas de Windows es un producto distinto que comparte el nombre y no usa estos archivos de configuración.
Prueba MyLinedChart
MyLinedChart guarda tus dibujos, notas y valores de indicadores como datos que puedes exportar, revisar y reutilizar.
Descubrir MyLinedChart