VS Code MCP-config: gebruik servers in plaats van mcpServers

Het verschil, naast elkaar

Dezelfde server, hetzelfde commando, dezelfde argumenten. Het enige dat verandert, is de sleutel van de omhulling.

Wat VS Code wil

In .vscode/mcp.json, in de hoofdmap van je werkruimte. Met de connector van MyLinedChart als voorbeeld:

{ "servers": { "mylinedchart": { "command": "npx", "args": ["-y", "@mylinedchart/mcp-chart-context"] } } }

Vervang dit door het commando en de argumenten van je eigen server. De vorm van het binnenste object verandert niet tussen clients.

Wat al het andere wil

Dezelfde server, voor Claude of Cursor:

{ "mcpServers": { "mylinedchart": { "command": "npx", "args": ["-y", "@mylinedchart/mcp-chart-context"] } } }

Heb je beide editors open, dan heb je echt beide bestanden nodig. De twee editors kunnen geen configuratie delen.

Waarom het zonder foutmelding faalt

VS Code leest het bestand, vindt geldige JSON en zoekt naar een sleutel servers. Het bestand heeft geen sleutel servers, dus VS Code vindt nul servers om te starten. Nul servers is geen foutsituatie. Vanuit VS Code gezien heb je niets geconfigureerd, en dat is een volkomen geoorloofde keuze.

Er is dus geen rode kronkellijn, geen melding en geen regel in een log die zegt dat de sleutel fout was. De storing ziet er precies uit als een server die bij het opstarten crasht, en daarom gaan mensen de server debuggen.

• Het bestand is geldige JSON, dus er verschijnt geen parsefout.
• Een onbekende sleutel op het hoogste niveau wordt genegeerd en niet afgewezen.
• Nul geconfigureerde servers is een normale toestand, dus VS Code meldt geen fout.

Zo bevestig je welk probleem je hebt

Bewijs eerst dat VS Code ooit heeft geprobeerd de server te starten, voordat je aanneemt dat de server kapot is.

• Controleer eerst de sleutel van de omhulling. De check kost vijf seconden en is meestal het antwoord.
• Voer het commando van de server met de hand uit in een terminal. Start de server, dan zit het probleem elders.
• Zoek de server in de MCP-serverlijst van VS Code. Afwezig betekent nooit geconfigureerd; aanwezig maar falend betekent een echte opstartfout.
• Heb je geïnstalleerd via een link met één klik in plaats van met de hand, dan geldt deze hele klasse van problemen niet.

Twee verwante valkuilen

Terwijl je hier toch bent: twee andere dingen falen op dezelfde stille manier.

Ten eerste dragen installatielinks voor MCP met één klik hun inhoud als gewone URL-gecodeerde JSON. Base64 wordt door de URL-parser geaccepteerd en doet daarna stilletjes niets, wat de ergst denkbare storing is: een knop die lijkt te hebben gewerkt.

Ten tweede reist de servernaam bij VS Code mee in de inhoud, en niet als aparte queryparameter zoals Cursor het doet. Een link in de vorm van Cursor installeert niet goed in VS Code, ook al opent hij.

Waar MyLinedChart past

MyLinedChart levert een connector mee die een AI-agent je live grafiek geeft: symbolen, je tekeningen, indicatorwaarden en de bars op het scherm. De connector draait op je machine en de data loopt niet via onze servers.

De app heeft een knop Add to VS Code met één klik die de juiste sleutel voor je schrijft, en dat is de reden om hem te gebruiken in plaats van met de hand te bewerken. Installatie en de andere clients: /resources/articles/ibkr-chart-data-github-copilot-vs-code.

Volgende stap

Herstel de sleutel, start VS Code opnieuw op en de server verschijnt. Verschijnt de server nog steeds niet, dan weet je nu dat het probleem bij de server ligt en niet bij de config, een veel kortere lijst om door te werken.

Verbind je AI op /mcp.

Veelgestelde vragen

Waarom gebruikt VS Code servers in plaats van mcpServers?

De sleutel servers is een naamkeuze in het eigen configuratieformaat van VS Code voor MCP, onafhankelijk gemaakt van de conventie die Claude Desktop vestigde. Geen van beide is juister. Het verschil wordt pas een probleem omdat de twee uitwisselbaar lijken en een van beide faalt zonder het te zeggen.

Waarschuwt VS Code me als ik de verkeerde sleutel gebruik?

Nee, en dat is precies de moeilijkheid. Het bestand is geldige JSON, een onbekende sleutel op het hoogste niveau wordt genegeerd en niet afgewezen, en nul geconfigureerde servers is een normale toestand. Niets eraan ziet eruit als een fout.

Kan ik één configuratiebestand gebruiken voor zowel VS Code als Cursor?

Nee. Ze lezen verschillende paden en verwachten verschillende sleutels voor de omhulling, dus je hebt beide bestanden nodig. De binnenste serverdefinitie is identiek, dus het is een kopie waarin één woord is veranderd.

Geldt dit ook voor Windows Copilot?

Nee. De Copilot hier is GitHub Copilot in VS Code, dat MCP-servers ondersteunt. De assistent in de Windows-taakbalk is een los product dat dezelfde naam deelt en deze configuratiebestanden niet gebruikt.