Configuración MCP en VS Code: usa servers en lugar de mcpServers

La diferencia, lado a lado

El mismo servidor, el mismo comando, los mismos argumentos. Lo único que cambia es la clave exterior.

Lo que quiere VS Code

En .vscode/mcp.json, en la raíz de tu espacio de trabajo. Usando 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 abiertos ambos editores, de verdad necesitas los dos archivos. Los dos editores no pueden compartir una sola configuración.

Por qué falla sin mostrar un error

VS Code lee el archivo, encuentra JSON válido y busca una clave servers. El archivo no tiene una clave servers, así que VS Code encuentra cero servidores para iniciar. Cero servidores no es una condición de error. Desde el punto de vista de VS Code no has configurado nada, algo perfectamente legal.

Así que no hay subrayado rojo, ni notificación, ni ninguna entrada en un registro que diga que la clave estaba mal. La falla se ve idéntica a 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 nivel superior no reconocida se ignora en lugar de rechazarse.
• Cero servidores configurados es un estado normal, así que VS Code no reporta ninguna falla.

Cómo confirmar qué problema tienes

Antes de suponer que el servidor está roto, comprueba que VS Code haya intentado iniciarlo alguna vez.

• Revisa primero la clave exterior. La revisión toma cinco segundos y casi siempre es la respuesta.
• Ejecuta a mano en una terminal el comando del servidor. Si el servidor arranca, el problema está en otro lado.
• 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 de arranque real.
• Si lo instalaste con un enlace de un clic en lugar de hacerlo a mano, toda esta clase de problema no aplica.

Dos trampas relacionadas

Mientras estás aquí, otras dos cosas fallan de la misma manera silenciosa.

Primero, los enlaces de instalación MCP de un clic llevan su contenido como JSON simple codificado en URL. El analizador de URL acepta Base64 y luego no hace nada, que es la peor falla posible: un botón que parece haber funcionado.

Segundo, en VS Code el nombre del servidor viaja dentro del contenido, en lugar de ir como un parámetro de consulta aparte, como lo hace Cursor. Un enlace armado con la forma de Cursor no se instalará correctamente en VS Code aunque se abra.

Dónde entra MyLinedChart

MyLinedChart incluye un conector MCP que le da a un agente de IA tu gráfico en vivo: símbolos, tus dibujos, valores de indicadores y las barras en pantalla. El conector se ejecuta en tu equipo y los datos no pasan por nuestros servidores.

La app tiene un botón Add to VS Code de un clic que escribe la clave correcta por ti, y esa es la razón para usarlo en lugar de editar a mano. La configuración y los demás clientes: /resources/articles/ibkr-chart-data-github-copilot-vs-code.

Siguiente paso

Corrige la clave, reinicia VS Code y el servidor aparece. Si aun así no aparece, ahora sabes que el problema es el servidor y no la configuración, que es una lista mucho más corta por revisar.

Conecta tu IA en /mcp.

Preguntas frecuentes

¿Por qué VS Code usa servers en lugar de mcpServers?

La clave servers es una decisión de nombre del propio formato de configuración MCP de VS Code, tomada de forma independiente a la convención que estableció Claude Desktop. Ninguna es más correcta. La diferencia solo se vuelve un problema porque las dos parecen intercambiables y una de ellas falla sin avisar.

¿VS Code me avisará si uso la clave equivocada?

No, y ahí está toda la dificultad. El archivo es JSON válido, una clave de nivel superior desconocida se ignora en lugar de rechazarse y tener cero servidores configurados es un estado normal. Nada de eso parece una falla.

¿Puedo usar un solo archivo de configuración para VS Code y Cursor?

No. Leen rutas distintas y esperan claves exteriores diferentes, así que necesitas ambos archivos. La definición interna del servidor es idéntica, por lo que basta con una copia con una palabra cambiada.

¿Esto aplica también a 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.