~/tools / MCP Config Checker
MCP Config Checker — MCP-Konfigurationsdatei auf Fehler prüfen
Prüft die Konfigurationsdatei eines MCP-Servers (.mcp.json oder claude_desktop_config.json) auf Fehler: fehlendes type, falscher Schlüssel auf oberster Ebene, reservierte oder ungültige Namen, relative Pfade, nicht gesetzte Variablen und Geheimnisse, die direkt in der Datei stehen. Nichts verlässt Ihren Browser.
Regeln geprüft anhand der Dokumentation am 2026-10-23.
Dokumentation: Claude Code / Model Context Protocol / VS Code
Nicht geprüft: ob ein Befehl existiert, ob sich ein Paket installieren lässt, ob ein entfernter Server antwortet, und Einstellungen, die andere Anwendungen anders lesen.
Alles läuft in Ihrem Browser. Die Konfiguration wird nicht hochgeladen.
MCP-Server werden in einer JSON-Datei eingerichtet, und schon ein kleiner Fehler kann dazu führen, dass ein Server stillschweigend nicht auftaucht. Ein Server-Eintrag mit url, aber ohne type wird übersprungen, eine Datei mit dem VS-Code-Schlüssel servers wird weder von Claude Code noch von Claude Desktop gelesen, und eine nicht gesetzte Umgebungsvariable wird als einfacher Text weitergereicht. Dieses Tool liest eine eingefügte Konfiguration und listet auf, was laut Dokumentation nicht funktioniert, was einen Blick wert ist und was nur ein Hinweis ist. Außerdem warnt es, wenn ein Token offenbar direkt in der Datei steht, wo er in der Versionsverwaltung landen kann. Die Regeln stammen aus der Dokumentation von Claude Code, dem Model Context Protocol und VS Code und wurden an dem Datum geprüft, das unter dem Tool steht.
Anwendungsfälle
- Herausfinden, warum ein MCP-Server nach dem Bearbeiten von .mcp.json oder claude_desktop_config.json nicht erscheint
- Eine aus einer README kopierte Konfiguration prüfen, bevor man sie in ein gemeinsames Projekt übernimmt
- Tokens und Passwörter in einer Konfigurationsdatei erkennen, bevor sie committet wird
Verwendung
- Fügen Sie den Inhalt Ihrer MCP-Konfigurationsdatei ein oder laden Sie das Beispiel.
- Lesen Sie die gefundenen Server und ihre jeweilige Art, danach die Liste der Befunde. Fehler bedeutet, dass der Eintrag laut Dokumentation nicht funktioniert, Prüfen bedeutet, dass er einen Blick wert ist, und Hinweis dient nur der Information.
- Bearbeiten Sie die Datei, fügen Sie sie erneut ein und starten Sie die Anwendung neu, die sie liest.
FAQ
Welche Dateien und Anwendungen werden abgedeckt?
Das mcpServers-Format, das die Projektdatei .mcp.json in Claude Code und claude_desktop_config.json in Claude Desktop verwenden. Andere Anwendungen lesen möglicherweise andere Felder oder einen anderen Schlüssel auf oberster Ebene, prüfen Sie daher deren eigene Dokumentation. VS Code verwendet zum Beispiel einen Schlüssel namens servers.
Mein Eintrag hat eine url, aber kein type. Warum ist das ein Problem?
Claude Code liest einen Eintrag ohne type als stdio-Server. Ein Eintrag mit url, aber ohne type ist daher ein Konfigurationsfehler, und der Server wird übersprungen. Ergänzen Sie ein type von http, sse oder ws.
Was passiert mit einer Variable wie ${API_KEY}, die nicht gesetzt ist?
Claude Code expandiert ${VAR} und ${VAR:-default} in command, args, env, url und headers. Ist eine Variable nicht gesetzt und hat keinen Standardwert, wird die Konfiguration trotzdem geladen, Claude Code zeigt eine Warnung an und verwendet den Text ${VAR} unverändert. Ergänzen Sie mit ${VAR:-default} einen Standardwert, wo das unbedenklich ist.
Warum warnt das Tool vor einem Token in der Datei?
Ein direkt in eine Konfigurationsdatei geschriebener Token kann weitergegeben werden, wenn die Datei committet oder an jemanden geschickt wird. Die Prüfung ist eine Heuristik auf Grundlage bekannter Token-Formate und von Namen wie api-key, token und password. Sie kann daher ein Geheimnis übersehen oder einen harmlosen Wert markieren. Mit ${VAR} bleibt der Wert aus der Datei heraus.
Startet das Tool den Server oder testet es die Verbindung?
Nein. Es liest nur den Text. Es kann nicht feststellen, ob ein Befehl existiert, ob sich ein Paket installieren lässt oder ob ein entfernter Server erreichbar ist. Testen Sie den Server daher in der Anwendung, nachdem die Datei die Prüfung bestanden hat.
Wird meine Konfiguration an einen Server gesendet?
Nein. Die Prüfung läuft in Ihrem Browser.