AgentKit
AgentKit
文档指南
请输入
- 文档首页
AgentKitAgentKit用户指南网关MCP 接入MCP 工具集调试 MCP 工具集
复制全文
下载 pdf调试 MCP 工具集
文档反馈
问问助手当您已经完成 MCP 工具集创建，希望在正式接入前确认域名连通性、身份认证和工具参数是否正确时，可以使用控制台提供的在线调试能力，帮助您提前发现工具筛选错误、参数填写错误或认证配置异常，避免智能体在真实调用时因为工具不可用而中断任务。本文介绍 MCP 工具集的调试方法。
注意
- 网络说明：公网域名调试对所有用户开放；私网域名调试目前为邀测状态，开通后方可使用。如需开通，请联系客户经理。
- 费用提示：调试页面的连接测试、工具检索、工具调用等操作，与通过代码调用 MCP 服务 / MCP 工具集的逻辑相同，均会经过网关并计入对应的计费项用量。请注意控制调试频次，避免产生非预期费用。详细计费规则请参见计费说明。
- 调用说明：MCP 工具集创建成功后，对 MCP 工具集发起请求，MCP 工具集会访问关联的 MCP 服务进行工具调用，产生的请求次数将同时计入 MCP 工具集与 MCP 服务的用量统计。详细说明请参见 MCP 请求次数说明。
背景信息
MCP 工具集支持不同的调用模式。调试前，建议先确认当前工具集使用的是哪一种模式，这会直接影响您选择调试工具的方式。
调用模式 | 选择调试工具的方式 |
全量返回 | 系统会直接全量返回 MCP 工具集内所有的工具，您只需从中选项目标工具，即可进行调试。 |
语义检索 | 需要先输入与工具用途匹配的自然语言，系统会根据描述返回候选工具。适合工具较多、由通用类智能体调用的场景。 |
标签检索 | 需要先按标签筛选工具，再选择目标工具。适合工具较多且已经按领域或用途做好标签分类的场景。 |
前提条件
- 已创建 MCP 工具集，操作详见创建MCP工具集。
- （可选）若使用私网域名进行 MCP 调试，请确保本机已通过专线连接、VPN 等方式连通目标 VPC，并能够正常解析该私网域名，否则连接测试将失败。如果本机未配置将 DNS 请求转发至火山引擎私网 DNS，可为该私网域名开启公网解析。
- 私网连通配置操作请参考：中转路由器 TR - 搭建云上VPC网络与云下IDC的独立互通、专线连接-最佳实践。
- 为私网域名开启公网解析：根据 MCP 服务所属网关模式进行配置，详细操作请参见开启/关闭私网域名公网解析。
操作步骤
- 登录 AgentKit控制台。
- 在左侧导航树中选择“网关 > MCP 接入”，单击“MCP 工具集”页签。
- 在列表中单击目标工具集名称，在“调试”页签，根据导航提示验证 MCP 工具集中的工具。
- Step 1：在“选择域名并连接测试”区域，单击“连接测试"。系统会自动带出工具集的公网访问域名，以及入站身份认证所需的 API Key 或 Access Token，不需要手动补填。
- 域名：MCP 工具集的公网访问域名。
- API Key/Access Token：MCP 工具集的入站身份认证。
- Step 2：（可选）调用方式为“标签检索”或“语义检索”的工具集，需要通过标签或自然语言筛选用于调试的工具。
- 标签检索：选择需要调式工具的标签。
- 语义检索：输入用于筛选工具的自然语言，然后单击“检索工具”按钮。
- Step 3：在“选择需要调试的工具”区域，选择用于调试的工具。
- Step 4：在“输入参数进行调试”区域，按照实际需要填写调试参数，填写完成后，单击“测试工具”按钮，完成操作。
-
- 如果返回测试成功，则表示 MCP 工具集连接正常。
-
最近更新时间：2026.10.09 15:55:07
这个页面对您有帮助吗？
有用
有用
无用
无用