View a markdown version of this page

使用 MCP 检查器 - Amazon Bedrock AgentCore
问题排查
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 MCP 检查器

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

有关 MCP 检查器的更多信息，请参阅 MCP 检查器文档。

将您的网关连接到检查器

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

    1. 安装检查器

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

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

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

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

    • 传输类型 — 选择可流式传输 HTTP

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

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

      • 密钥的名称应该是Authorization。

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

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

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

重要

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

问题排查

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

  • 连接问题：确保您的网关 URL 正确且可从您的网络访问

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

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

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