# 调试MCP
MCP创建完成后，建议先进行调试验证，确认MCP服务连接正常、工具已正确识别、调用结果符合预期后，再将其关联到智能体中使用。调试阶段是发现和排查问题的最佳时机，直接跳过调试，将问题带入智能体运行环节，会大幅增加排查难度。
#### 费用说明
调用和调试MCP服务可能产生费用。
- 平台预置的第三方MCP服务（如高德地图）可能需要您在对应平台申请API Key并承担相关调用费用，请确保您的账户额度充足。
- 智能体调用MCP工具会产生大模型Token消耗。
 
#### 调试前确认
在开始调试之前，请先检查以下几项：
- **工具是否已识别：** 进入MCP详情页，在"工具列表"中确认工具已正确加载。如果工具列表为空，通常是MCP配置填写错误，或MCP服务本身异常（如开源社区的MCP维护不及时或后端服务失效）。遇到失败的情况，请尝试更换MCP来源。
  图1工具识别异常示例   
  ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790510.png "点击放大") 
- **鉴权信息是否已配置：**如果MCP服务需要鉴权，请确认已在创建时正确填写鉴权参数，否则调试时会返回鉴权失败的错误。
- **服务是否可正常访问：**对于Streamable HTTP、SSE类型的MCP，请确认服务地址可通过公网正常访问。
 
#### 调试MCP
1. MCP部署成功后，单击MCP名称并进入详情页，可以查看MCP具有的工具，并进行调试。 
   调试前先查看每个工具的名称、描述和参数定义是否完整且准确。这些信息直接影响智能体后续能否正确理解和调用该工具。
   如果发现工具描述缺失或参数定义不完整，需要在MCP服务端进行修正（或尝试重新部署MCP）。
   参数格式不正确是调试中最常见的报错原因。调试时请仔细查看每个参数的类型和格式说明，按照要求填写。详细格式问题请参考[MCP调试故障](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0323.html#agentarts_05_0323__section1319432192015)，常见格式问题示例：
   ```
   错误写法：
   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   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549949.png "点击放大")