View a markdown version of this page

Verwenden Sie den MCP Inspector - Amazon Grundgestein AgentCore
Fehlerbehebung

Verwenden Sie den MCP Inspector

Der MCP Inspector, der über das Model Context Protocol (MCP) verfügbar ist, ist ein Entwicklertool, mit dem Sie MCP-Server über eine interaktive Oberfläche testen und debuggen können. Sie können Ihr AgentCore Gateway mit dem MCP Inspector verbinden, um Sie beim Debuggen Ihrer Gateway-Ziele zu unterstützen.

Weitere Informationen zum MCP Inspector finden Sie in der MCP Inspector-Dokumentation.

Um Ihr Gateway mit dem Inspector zu verbinden

  1. Öffnen Sie ein Terminal und npx @modelcontextprotocol/inspector führen Sie Folgendes aus:

    1. Installieren Sie den Inspektor

    2. Starten Sie den Inspektor auf localhost.

    3. Generieren Sie ein Sitzungstoken für die Authentifizierung.

    4. Öffnen Sie Ihren Browser für die Inspector-Oberfläche.

  2. Konfigurieren Sie in der Inspector-Oberfläche die folgenden Felder:

    • Transporttyp — Wählen Sie Streamable HTTP

    • URL — Geben Sie die Gateway-Endpunkt-URL ein, die bei der Erstellung Ihres Gateways zurückgegeben wurde.

    • Erweitern Sie Authentifizierung. Der Abschnitt Benutzerdefinierte Header sollte vorab mit einem Schlüssel-Wert-Paar gefüllt sein.

  3. Wählen Sie Connect aus. Sie werden mit Ihrem Gateway verbunden. Sie können den MCP Inspector als Tool verwenden, um Ihr Gateway zu untersuchen und zu testen, bevor Sie es in Ihren Agenten integrieren.

Weitere Informationen darüber, wie Sie den MCP-Server überprüfen können, mit dem Ihr Gateway verbunden ist, finden Sie unter Funktionsübersicht in der Funktionsübersicht in der MCP Inspector-Dokumentation.

Wichtig

Der MCP Inspector ist ein Entwicklungstool und sollte nicht in Produktionsumgebungen verwendet werden. Schützen Sie immer Ihre Zugriffstoken und Gateway-Anmeldeinformationen.

Fehlerbehebung

Wenn Sie bei der Verwendung des MCP Inspector mit Ihrem Gateway auf Probleme stoßen, überprüfen Sie Folgendes:

  • Verbindungsprobleme: Stellen Sie sicher, dass Ihre Gateway-URL korrekt ist und von Ihrem Netzwerk aus zugänglich ist

  • Authentifizierungsprobleme: Stellen Sie sicher, dass Ihr Zugriffstoken gültig und nicht abgelaufen ist

  • Fehler beim Aufrufen des Tools: Überprüfen Sie die Fehlermeldungen in der Antwort und stellen Sie sicher, dass Ihre Eingabeparameter mit dem Schema des Tools übereinstimmen

  • Proxyfehler: Wenn Sie Fehler im Zusammenhang mit der Proxyverbindung sehen, versuchen Sie, den MCP Inspector neu zu starten