View a markdown version of this page

使用 MCP Inspector - Amazon Bedrock AgentCore
问题排查

使用 MCP Inspector

MCP Inspector 可通过模型上下文协议 (MCP) 获得，它是一种开发者工具，可通过交互式界面帮助您测试和调试 MCP 服务器。您可以将 AgentCore 网关连接到 MCP 检查器，以帮助您调试网关目标。

有关 MCP Inspector 的更多信息，请参阅 M CP Inspect or 文档。

将您的网关连接到检查器

  1. 打开终端并运行npx @modelcontextprotocol/inspector以执行以下操作：

    1. 安装检查器

    2. 在本地主机上启动检查器。

    3. 生成用于身份验证的会话令牌。

    4. 打开浏览器，进入检查器界面。

  2. 在检查器界面中，配置以下字段：

    • 传输类型-选择可流式传输的 HTTP

    • URL-输入创建网关时返回的网关终端节点 URL。

    • 展开 “身份验证”。“自定义标题” 部分应预先填充一个键值对。

      • 密钥的名字应该是Authorization。

      • 将该值替换为网关的入站授权凭证。

  3. 选择连接。您将连接到您的网关。在将网关与代理集成之前，您可以使用 MCP Inspector 作为检查和测试网关的工具。

有关如何检查网关所连接的 MCP 服务器的更多信息，请参阅 MCP Inspec tor 文档功能概述中的功能概述。

重要

MCP Inspector 是一种开发工具，不应在生产环境中使用。始终保护您的访问令牌和网关凭证。

问题排查

如果您在网关上使用 MCP Inspector 时遇到问题，请检查以下内容：

  • 连接问题：确保您的网关 URL 正确无误，并且可以从您的网络中访问

  • 身份验证问题：确认您的访问令牌有效且未过期

  • 工具调用错误：检查响应中的错误消息，并确保您的输入参数与工具的架构相匹配

  • 代理错误：如果您看到与代理连接相关的错误，请尝试重新启动 MCP Inspector