调试MCP

调试前确认

在开始调试之前，请先检查以下几项：

• 工具是否已识别：进入MCP详情页，确认工具列表已正确加载。如果工具列表为空，通常是MCP配置填写错误，或MCP服务本身异常。如开源社区的MCP维护不及时或后端服务失效。遇到失败的情况，请尝试更换MCP来源。
  图1 工具识别异常示例
  
• 鉴权信息是否已配置：如果MCP服务需要鉴权，请确认已在创建时正确填写鉴权参数，否则调试时会返回鉴权失败的错误。
• 服务是否可正常访问：对于Streamable HTTP / SSE类型的MCP，请确认服务地址可通过公网正常访问。

调试MCP

1. MCP部署成功后，单击MCP名称并进入“工具”页签，可以查看MCP具有的工具，并进行调测。

   调试前先查看每个工具的名称、描述和参数定义是否完整且准确。这些信息直接影响智能体后续能否正确理解和调用该工具。如果发现工具描述缺失或参数定义不完整，需要在MCP服务端进行修正（或尝试重新部署MCP）。

   参数格式不正确是调试中最常见的报错原因。调试时请仔细查看每个参数的类型和格式说明，按照要求填写。详细格式问题请参考MCP调试故障，常见格式问题示例：

   ❌ url: example.com                    → ✅ url: https://www.example.com
   ❌ date: 2025年1月15日                  → ✅ date: 2025-01-15
   ❌ tags: 科技,金融                      → ✅ tags: ["科技", "金融"]
   ❌ age: "25"                           → ✅ age: 25
   ❌ enabled: "true"                     → ✅ enabled: true
   ❌ filter: {name: "张三"}               → ✅ filter: {"name": "张三"}
   ❌ language: ZH（可选值为 zh/en/ja）     → ✅ language: zh

   图2 调试MCP