View a markdown version of this page

MCP Inspector を使用する - Amazon Bedrock AgentCore
トラブルシューティング

MCP Inspector を使用する

MCP Inspector は、Model Context Protocol (MCP) を通じて利用でき、インタラクティブインターフェイスを通じて によって MCP サーバーをテストおよびデバッグするのに役立つ開発者ツールです。AgentCore ゲートウェイを MCP インスペクターに接続して、ゲートウェイターゲットのデバッグに役立てることができます。

MCP Inspector の詳細については、MCP Inspector のドキュメントを参照してください。

ゲートウェイをインスペクターに接続するには

  1. ターミナルを開き、 npx @modelcontextprotocol/inspectorを実行して以下を実行します。

    1. インスペクターをインストールする

    2. localhost でインスペクターを起動します。

    3. 認証用のセッショントークンを生成します。

    4. ブラウザを開いてインスペクターインターフェイスを開きます。

  2. インスペクターインターフェイスで、次のフィールドを設定します。

    • トランスポートタイプ – ストリーミング可能な HTTP を選択する

    • URL – ゲートウェイの作成時に返されるゲートウェイエンドポイント URL を入力します。

    • 認証 を展開します。カスタムヘッダーセクションには、1 つのキーと値のペアが事前に入力されている必要があります。

  3. 接続 を選択します。ゲートウェイに接続されます。MCP Inspector をツールとして使用して、エージェントと統合する前にゲートウェイを調べてテストできます。

ゲートウェイが接続されている MCP サーバーを検査する方法の詳細については、MCP Inspector ドキュメントの「機能の概要」の「機能の概要」を参照してください。

重要

MCP Inspector は開発ツールであり、本番環境では使用しないでください。アクセストークンとゲートウェイ認証情報は常に保護してください。

トラブルシューティング

ゲートウェイで MCP Inspector を使用する際に問題が発生した場合は、以下を確認してください。

  • 接続の問題: ゲートウェイ URL が正しく、ネットワークからアクセス可能であることを確認します。

  • 認証の問題: アクセストークンが有効で、有効期限が切れていないことを確認する

  • ツール呼び出しエラー: レスポンスのエラーメッセージを確認し、入力パラメータがツールのスキーマと一致することを確認します。

  • プロキシエラー: プロキシ接続に関連するエラーが表示された場合は、MCP Inspector を再起動してみてください。