MCP-Konfiguration: Struktur, Verbindung und Berechtigungen verstehen
Drei getrennte Schritte erleichtern die Fehlersuche bei MCP: Dateistruktur prüfen, Verbindung testen und anschließend Server sowie angeforderte Rechte bewerten. Die Strukturprüfung deckt den ersten Schritt ab; Verbindung und Vertrauenswürdigkeit brauchen eigene Prüfungen.
Es sind 3 verschiedene Fragen
Kann die Anwendung die Konfiguration lesen? Funktioniert die Verbindung? Passen Herkunft und Berechtigungen zu Ihren Daten? Ein Ja auf die erste Frage beantwortet die anderen nicht.
MCP verbindet einen Client mit einem Server, der Fähigkeiten bereitstellt. Das kann ein lokales Programm über stdio oder ein Dienst über HTTP sein. Der Transport beeinflusst, was geprüft werden muss.
Quellen: Model Context Protocol — Clients, servers and transports
Das Format des eigenen Clients prüfen
ToolRoof prüft eine definierte JSON-Teilmenge unter mcpServers: command mit optionalen args und env oder url mit optionalen headers. command und url im selben Eintrag sind ein Fehler; unbekannte Felder erzeugen Warnungen.
Das ist nicht das Konfigurationsformat aller MCP-Anwendungen. Lesen Sie die Client-Dokumentation, bevor Sie gültige, aber nicht abgedeckte Optionen entfernen. Das Werkzeug führt keine Befehle aus, besucht keine Adresse und testet keine Anmeldung.
Ein Warnhinweis findet nicht alle sensiblen Daten
Argumente, Umgebungsvariablen und Header können sensible Daten enthalten. Hinweise auf diese Stellen beweisen weder, dass jeder Wert geheim ist, noch dass eine warnungsfreie Datei keine Geheimnisse enthält.
Veröffentlichen Sie keine echte Konfiguration in einem öffentlichen Supportfall. Verwenden Sie ein bereinigtes Beispiel und prüfen Sie Herkunft sowie Rechte vor der Verbindung. HTTPS und gültiges JSON schaffen allein kein Vertrauen.
Beispiel: ein gültiges Ergebnis mit begrenzter Aussage
{"mcpServers":{"notes":{"url":"https://example.com/mcp","type":"http"}}} beschreibt einen Server der unterstützten Teilmenge. Bestehen bestätigt nur die Struktur; example.com ist eine Beispieladresse, kein getesteter MCP-Server.
Zusätzliches command im selben Eintrag führt wegen unklarem Transport zum Fehler. headers mit {"X-Mode":"demo"} lässt die Struktur dagegen gültig, erzeugt aber eine Prüfungswarnung. Das erklärt demo nicht zu geheimen Zugangsdaten.