MCP Inspector: Server verbinden und Werkzeuge testen

Der Editor zeigt keinen brauchbaren Fehler, obwohl der MCP-Server eingerichtet ist? Mit einem separaten Protokollclient lässt sich prüfen, wie weit die Verbindung tatsächlich kommt. Der MCP Inspector eignet sich dafür als zusätzliche Prüfstation. Wichtig ist ein enger Vergleich: Verwenden Sie denselben Endpunkt oder Startbefehl und halten Sie Unterschiede bei Konto, Umgebung und Argumenten fest. Sonst testen Sie zwei verschiedene Einrichtungen und erhalten zwei Ergebnisse, die einander nur scheinbar widersprechen.

Inspector starten und die Version festhalten

Die aktuelle Inspector-Dokumentation nennt Node ab Version 22.19.0. Sie beschreibt einen Browserclient, einen Kommandozeilenclient und eine Terminaloberfläche. Prüfen Sie vor dem Start node --version und lesen Sie die Anforderungen der konkret gewählten Paketfassung. Der folgende Aufruf lädt beziehungsweise startet das Paket über npx; er ist kein auf dieser Seite ausgeführter Test.

npx @modelcontextprotocol/inspector

Öffnen Sie die vom Prozess ausgegebene Browseradresse auf Ihrem Rechner. Die aktuelle Dokumentation beschreibt dafür einen einmaligen Sitzungstoken. Teilen Sie diese Adresse nicht als öffentlichen Fehlerbeleg. Halten Sie die verwendete Inspector-Fassung fest: Die Herstellerquelle unterscheidet die aktuelle v2-Linie von v1; ältere Anleitungen können andere Schalter und Konfigurationsformen zeigen.

HTTP und stdio mit denselben Angaben wie im Client prüfen

Für einen öffentlichen HTTP-Test können Sie https://api.tracevero.com/mcp verwenden. Der Aufruf unten fragt die Werkzeugliste ab. Er führt noch keine der gelisteten Operationen aus. traceveros Schnittstellenbeschreibung nennt die angebotenen Funktionen. Verwenden Sie bei einem eigenen Server dessen dokumentierte Adresse und Anmeldung.

npx @modelcontextprotocol/inspector --cli https://api.tracevero.com/mcp --transport http --method tools/list

Bei einem lokalen Server ist der Inspector ein weiterer Prozessstarter. Ein erfolgreicher Aufruf aus Ihrem Terminal beweist deshalb nicht, dass der Editor denselben Programmpfad und dieselben Variablen sieht. Die ENOENT-Anleitung und der Transportvergleich helfen, diese Unterschiede zu protokollieren. Ändern Sie den Transport nicht allein deshalb, weil ein anderer in der Oberfläche auswählbar ist.

Von tools/list zu einem überprüften Ergebnis

1. Verbinden Sie den Server und halten Sie fest, ob die Initialisierung gelingt. Bei einem Abbruch sichern Sie die bereinigte Fehlermeldung und die letzte erfolgreiche Stufe.

2. Rufen Sie tools/list auf. Prüfen Sie die tatsächlichen Werkzeugnamen und deren Eingabeschema, statt Namen aus einem älteren Bildschirmfoto zu übernehmen.

3. Wählen Sie genau eine lesende Operation mit einem bekannten Ergebnis. Für tracevero eignet sich die Suche nach einem Begriff aus der Registersuche. Füllen Sie die im Schema genannten Argumente aus.

4. Vergleichen Sie das Ergebnis mit Ihrer Erwartung. Wiederholen Sie anschließend dieselbe Operation im ursprünglichen Client. Dokumentieren Sie beide Resultate einschließlich Endpunkt, Zeitpunkt und Fassungen.

Fehlerberichte so schreiben, dass sie weiterhelfen

Ein hilfreicher Bericht enthält die gewählte Operation, eine bereinigte Eingabe, die erwartete Antwort und die tatsächlich beobachtete Abweichung. „Server geht nicht“ lässt offen, ob die Verbindung scheitert oder nur ein bestimmtes Werkzeug. Notieren Sie ausdrücklich, wenn die Werkzeugliste sichtbar war. Das spart einen erneuten Test aller vorherigen Schritte und macht eine spätere Reparatur überprüfbar.

Wenn die Liste leer bleibt, gehen Sie zur Werkzeugdiagnose. Bei einer abgelehnten HTTP-Anfrage hilft die Anleitung für 401 und 403. Behalten Sie Tokens, persönliche Daten und lokale Sitzungsadressen aus dem Bericht heraus. Ein erfolgreicher Protokolltest ist kein Nachweis, dass alle angebotenen Operationen geeignet sind oder dass jede Clientversion dieselben Fähigkeiten unterstützt.

Ist eine sichtbare Werkzeugliste schon ein Funktionstest?

Sie bestätigt die erfolgreiche Abfrage dieser Liste. Ein einzelner Werkzeugaufruf und dessen fachliches Ergebnis müssen zusätzlich geprüft werden.

Muss ich dafür einen Server veröffentlichen?

Nein. Ein lokaler stdio-Prozess kann auf Ihrem Rechner geprüft werden. Die passende Startanleitung kommt vom jeweiligen Server.

Warum unterscheiden sich Inspector und Editor?

Vergleichen Sie zuerst die tatsächlichen Startbedingungen. Eine andere Umgebung oder Anmeldung kann den Unterschied erklären, bevor ein Clientfehler vorliegt.

Führt tracevero diese Tests automatisch für mich aus?

Nein. Diese Seite ist eine Anleitung. Registerangaben und veröffentlichte Prüfberichte haben eigene Quellen und ausdrücklich genannte Grenzen.

Herstellerquellen, abgerufen am 1. Oktober 2026. Die Testabläufe sind redaktionelle Vorschläge.

1. MCP: Inspector reference
   Abrufbefehl anzeigen

   curl -s https://modelcontextprotocol.io/docs/2026-07-28/tools/inspector
2. MCP Inspector: source and version information
   Abrufbefehl anzeigen

   curl -s https://github.com/modelcontextprotocol/inspector

Alle Beiträge