Konfiguracja MCP w VS Code: użyj servers zamiast mcpServers

Różnica obok siebie

Ten sam serwer, to samo polecenie, te same argumenty. Zmienia się tylko klucz opakowujący.

Czego chce VS Code

W .vscode/mcp.json, w katalogu głównym Twojego obszaru roboczego. Na przykładzie konektora MyLinedChart:

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

Podstaw polecenie i argumenty własnego serwera. Kształt wewnętrznego obiektu nie zmienia się między klientami.

Czego chce cała reszta

Ten sam serwer, dla Claude lub Cursora:

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

Jeśli masz otwarte oba edytory, naprawdę potrzebujesz obu plików. Te dwa edytory nie mogą dzielić jednej konfiguracji.

Dlaczego zawodzi bez błędu

VS Code czyta plik, znajduje poprawny JSON i szuka klucza servers. W pliku nie ma klucza servers, więc VS Code znajduje zero serwerów do uruchomienia. Zero serwerów nie jest stanem błędu. Z punktu widzenia VS Code nic nie skonfigurowałeś, a to w pełni dozwolone.

Nie ma więc czerwonego podkreślenia, powiadomienia ani wpisu w żadnym logu mówiącego, że klucz był zły. Awaria wygląda dokładnie jak wysypanie się serwera przy starcie, dlatego ludzie idą debugować serwer.

• Plik to poprawny JSON, więc nie pojawia się błąd parsowania.
• Nierozpoznany klucz najwyższego poziomu jest ignorowany, a nie odrzucany.
• Zero skonfigurowanych serwerów to normalny stan, więc VS Code nie zgłasza usterki.

Jak potwierdzić, który problem masz

Zanim uznasz, że serwer jest zepsuty, udowodnij, że VS Code w ogóle próbował go uruchomić.

• Najpierw sprawdź klucz opakowujący. Kontrola zajmuje pięć sekund i najczęściej to jest odpowiedź.
• Uruchom polecenie serwera ręcznie w terminalu. Jeśli serwer startuje, problem leży gdzie indziej.
• Poszukaj serwera na liście serwerów MCP w VS Code. Brak oznacza, że nigdy nie został skonfigurowany; obecny, ale niedziałający oznacza faktyczny błąd startu.
• Jeśli instalowałeś przez link jednym kliknięciem, a nie ręcznie, cała ta klasa problemów Cię nie dotyczy.

Dwie powiązane pułapki

Skoro już tu jesteś, dwie inne rzeczy zawodzą w ten sam cichy sposób.

Po pierwsze, linki instalacyjne MCP jednym kliknięciem niosą ładunek jako zwykły JSON zakodowany w URL. Base64 jest akceptowane przez parser URL, a potem po cichu nic nie robi, co jest najgorszą możliwą awarią: przycisk, który wygląda, jakby zadziałał.

Po drugie, nazwa serwera w VS Code podróżuje wewnątrz ładunku, a nie jako osobny parametr zapytania, jak robi to Cursor. Link zbudowany w kształcie dla Cursora nie zainstaluje się poprawnie w VS Code, choć się otworzy.

Gdzie pasuje MyLinedChart

MyLinedChart dostarcza konektor MCP, który daje agentowi AI Twój wykres na żywo: symbole, Twoje rysunki, wartości wskaźników i świece na ekranie. Konektor działa na Twoim komputerze, a dane nie przechodzą przez nasze serwery.

Aplikacja ma przycisk Add to VS Code jednym kliknięciem, który zapisuje właściwy klucz za Ciebie, i to jest powód, by używać go zamiast ręcznej edycji. Konfigurację i innych klientów opisuje /resources/articles/ibkr-chart-data-github-copilot-vs-code.

Następny krok

Popraw klucz, zrestartuj VS Code, a serwer się pojawi. Jeśli serwer nadal się nie pojawia, wiesz już, że problem leży w serwerze, a nie w konfiguracji, co oznacza znacznie krótszą listę rzeczy do sprawdzenia.

Połącz swoje AI na /mcp.

Najczęstsze pytania

Dlaczego VS Code używa servers zamiast mcpServers?

Klucz servers to wybór nazewniczy we własnym formacie konfiguracji MCP w VS Code, dokonany niezależnie od konwencji ustanowionej przez Claude Desktop. Żaden nie jest bardziej poprawny. Różnica staje się problemem tylko dlatego, że oba wyglądają na wymienne, a jeden z nich zawodzi bez ostrzeżenia.

Czy VS Code ostrzeże mnie, jeśli użyję złego klucza?

Nie i na tym polega cała trudność. Plik to poprawny JSON, nieznany klucz najwyższego poziomu jest ignorowany, a nie odrzucany, a brak skonfigurowanych serwerów to normalny stan. Nic w tym nie wygląda na usterkę.

Czy mogę użyć jednego pliku konfiguracji dla VS Code i Cursora?

Nie. Czytają różne ścieżki i oczekują różnych kluczy opakowujących, więc potrzebujesz obu plików. Wewnętrzna definicja serwera jest identyczna, więc to kopia ze zmienionym jednym słowem.

Czy to dotyczy też Copilota w Windows?

Nie. Copilot, o którym tu mowa, to GitHub Copilot w VS Code, który wspiera serwery MCP. Asystent na pasku zadań Windows to odrębny produkt o tej samej nazwie i nie używa tych plików konfiguracji.