MCP verbunden, aber Werkzeuge fehlen: tools/list prüfen

Verbunden und nutzbar getrennt betrachten

Eine erfolgreiche Initialisierung bestätigt den Protokollkontakt. Sie verspricht nicht, dass der Server jedes gewünschte Werkzeug anbietet oder dass Ihr Konto jede Operation nutzen kann. Halten Sie zuerst fest, welcher Server in welcher Fassung verbunden wurde. Prüfen Sie dann, ob die Antwort die Fähigkeit tools deklariert. Ein Dienst kann andere MCP-Funktionen bereitstellen. Das Fehlen eines bestimmten Werkzeugs ist deshalb nicht automatisch ein Transportfehler.

Die vollständige Werkzeugliste lesen

Die Protokollmethode tools/list liefert die angebotenen Werkzeuge mit Namen, Beschreibung und Eingabeschema. Enthält die Antwort nextCursor, folgen weitere Ergebnisse, die mit diesem Cursor abgefragt werden. Vergleichen Sie nicht nur die erste Seite mit Ihrer Erwartung. Die Liste kann vom Autorisierungskontext abhängen. Notieren Sie daher auch das verwendete Konto. Falls Sie einen eigenen Client bauen, bewahren Sie den Cursor unverändert auf und beenden Sie die Abfrage, wenn kein weiterer Cursor geliefert wird.

Serverangebot und Clientanzeige vergleichen

Ist das Werkzeug in der vollständigen Serverantwort enthalten, aber in der Oberfläche unsichtbar, prüfen Sie die Auswahl und Filter des Clients. Manche Einrichtungen aktivieren nur einen Teil der angebotenen Funktionen. Fehlt es schon in der Serverantwort, vergleichen Sie Serverfassung, Anbieter-Dokumentation, Kontorechte und gegebenenfalls aktivierte Funktionsgruppen. Nutzen Sie für eine Gegenprüfung denselben Transport und dieselbe Kontozuordnung. Ein Test mit einem anderen Konto beantwortet eine andere Frage.

Ein sichtbares Werkzeug kontrolliert aufrufen

Lesen Sie vor dem Aufruf das Eingabeschema. Wählen Sie eine bekannte Testressource und eine begrenzte Leseoperation. Prüfen Sie anschließend den Inhalt des Ergebnisses: Eine technisch erfolgreiche Antwort kann mit isError einen fachlichen Werkzeugfehler melden. Dokumentieren Sie daher Werkzeugname, bereinigte Eingabe, erwartetes Ergebnis und tatsächlich erhaltenes Ergebnis. Der MCP Inspector kann bei der getrennten Untersuchung von Verbindung, Liste und Aufruf helfen; er führt die von Ihnen gewählten Aufrufe tatsächlich aus.

1. Notieren Sie Serverfassung, Konto und deklarierte Fähigkeiten.

2. Vergleichen Sie die vollständige Werkzeugliste mit der Clientanzeige.

3. Prüfen Sie einen begrenzten Leseaufruf und halten Sie auch fachliche Fehler fest.

Im Fehler-Navigator finden Sie weitere Fehlerbilder und passende nächste Schritte. Die Konfigurationsvorlage hilft beim Abgleich des Formats. Nutzen Sie den Registervergleich, wenn ähnlich benannte Einträge unterschiedliche Pakete oder Startwege führen. Eine Registerangabe beschreibt die Quelle; sie ersetzt Ihren Verbindungstest nicht.

Kann die Werkzeugliste sich ändern?

Ja. Der Server kann eine Listenänderung melden, wenn er diese Fähigkeit deklariert. Prüfen Sie, ob der Client die Liste danach neu lädt.

Beweist ein sichtbares Werkzeug die Zugriffsrechte?

Nein. Die konkrete Operation kann weiterhin an der Zielressource oder an fehlenden Rechten scheitern.

Warum unterscheiden sich zwei Werkzeuglisten?

Vergleichen Sie Serverfassung, Konto, vollständige Pagination und aktivierte Funktionsgruppen, bevor Sie einen Protokollfehler annehmen.

Wie kann ich den Server unabhängig vom Client prüfen?

Der MCP Inspector kann Liste und Aufruf getrennt untersuchen. Verwenden Sie dieselbe Kontozuordnung und einen begrenzten Test.

Quellen geprüft am 1. Oktober 2026. Die Prüfschritte sind redaktionelle Vorschläge für Ihre eigene Umgebung.

1. MCP 2025-11-25: Tools
   Abrufbefehl anzeigen

   curl -s https://modelcontextprotocol.io/specification/2025-11-25/server/tools
2. MCP 2025-11-25: Lifecycle
   Abrufbefehl anzeigen

   curl -s https://modelcontextprotocol.io/specification/2025-11-25/basic/lifecycle
3. MCP Inspector
   Abrufbefehl anzeigen

   curl -s https://modelcontextprotocol.io/docs/tools/inspector

Alle Beiträge