调试MCP

费用说明

调用和调试MCP服务可能产生费用。

• 平台预置的第三方MCP服务（如高德地图）可能需要您在对应平台申请API Key并承担相关调用费用，请确保您的账户额度充足。
• 智能体调用MCP工具会产生大模型Token消耗。

调试前确认

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

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

调试MCP

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

   调试前先查看每个工具的名称、描述和参数定义是否完整且准确。这些信息直接影响智能体后续能否正确理解和调用该工具。

   如果发现工具描述缺失或参数定义不完整，需要在MCP服务端进行修正（或尝试重新部署MCP）。

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

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

   图2 调试MCP