View a markdown version of this page

使用 MCP 检查器 - 亚马逊基岩 AgentCore
问题排查

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

使用 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 检查器