~/tools / MCP Config Checker
MCP Config Checker — Sprawdź plik konfiguracji MCP pod kątem błędów
Sprawdź plik konfiguracyjny serwerów MCP (.mcp.json lub claude_desktop_config.json) pod kątem błędów: brakującego type, złego klucza najwyższego poziomu, zarezerwowanych lub nieprawidłowych nazw, ścieżek względnych, nieustawionych zmiennych i sekretów wpisanych wprost do pliku. Nic nie opuszcza twojej przeglądarki.
Reguły sprawdzone z dokumentacją w dniu 2026-10-23.
Dokumentacja: Claude Code / Model Context Protocol / VS Code
Nie sprawdzono: czy polecenie istnieje, czy pakiet się instaluje, czy zdalny serwer odpowiada oraz ustawień, które inne aplikacje odczytują inaczej.
Wszystko działa w twojej przeglądarce. Konfiguracja nie jest wysyłana.
Serwery MCP konfiguruje się w pliku JSON, a drobny błąd może sprawić, że serwer po cichu się nie pojawi. Wpis serwera z url, ale bez type jest pomijany, plik używający klucza servers z VS Code nie jest odczytywany ani przez Claude Code, ani przez Claude Desktop, a nieustawiona zmienna środowiskowa jest przekazywana dalej jako zwykły tekst. To narzędzie czyta wklejoną konfigurację i wypisuje, co według dokumentacji nie zadziała, co warto sprawdzić, a co jest tylko informacją. Ostrzega też, gdy token wygląda na wpisany prosto do pliku, gdzie może trafić do kontroli wersji. Reguły pochodzą z dokumentacji Claude Code, Model Context Protocol i VS Code i były sprawdzone w dniu podanym pod narzędziem.
Zastosowania
- Ustalenie, dlaczego serwer MCP nie pojawia się po edycji .mcp.json lub claude_desktop_config.json
- Sprawdzenie konfiguracji skopiowanej z README, zanim dodasz ją do wspólnego projektu
- Wychwycenie tokenów i haseł wpisanych do pliku konfiguracyjnego, zanim trafi do commita
Jak używać
- Wklej zawartość pliku konfiguracyjnego MCP albo wczytaj przykład.
- Przeczytaj znalezione serwery i rodzaj każdego z nich, a potem listę uwag. Napraw oznacza, że według dokumentacji wpis nie zadziała, Sprawdź – że warto na niego spojrzeć, a Info służy tylko do informacji.
- Popraw plik, wklej go ponownie i zrestartuj aplikację, która go czyta.
FAQ
Jakie pliki i aplikacje obejmuje narzędzie?
Format mcpServers używany w pliku projektu .mcp.json w Claude Code oraz w claude_desktop_config.json w Claude Desktop. Inne aplikacje mogą czytać inne pola albo inny klucz najwyższego poziomu, więc zajrzyj do ich dokumentacji. VS Code używa na przykład klucza najwyższego poziomu o nazwie servers.
Mój wpis ma url, ale nie ma type. Dlaczego to problem?
Claude Code traktuje wpis bez type jako serwer stdio, więc wpis z url, ale bez type, jest błędem konfiguracji i serwer zostaje pominięty. Dodaj type o wartości http, sse lub ws.
Co się dzieje ze zmienną taką jak ${API_KEY}, która nie jest ustawiona?
Claude Code rozwija ${VAR} i ${VAR:-default} w command, args, env, url i headers. Jeśli zmienna nie jest ustawiona i nie ma wartości domyślnej, konfiguracja nadal się wczytuje, Claude Code pokazuje ostrzeżenie i używa tekstu ${VAR} bez zmian. Tam, gdzie to bezpieczne, dodaj wartość domyślną przez ${VAR:-default}.
Dlaczego narzędzie ostrzega o tokenie w pliku?
Token wpisany bezpośrednio do pliku konfiguracyjnego może zostać udostępniony, gdy plik trafi do commita albo zostanie komuś wysłany. Kontrola to heurystyka oparta na znanych formatach tokenów i na nazwach takich jak api-key, token i password, więc może przeoczyć sekret albo oznaczyć nieszkodliwą wartość. Użycie ${VAR} pozwala trzymać wartość poza plikiem.
Czy narzędzie uruchamia serwer lub testuje połączenie?
Nie. Czyta tylko tekst. Nie wie, czy polecenie istnieje, czy pakiet da się zainstalować ani czy zdalny serwer jest osiągalny, dlatego po przejściu kontroli przetestuj serwer w samej aplikacji.
Czy moja konfiguracja jest wysyłana na serwer?
Nie. Kontrola działa w twojej przeglądarce.