文档中心

AgentKit

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 服务的访问域名。如果该 MCP 服务同时支持公网域名和私网域名，选择任意一种。

API Key/Access Token：MCP 服务的入站身份认证。

Identity 鉴权 Token：仅配置了 Identity 鉴权插件的 MCP 服务，在调试时需配置 Token Header 和 Token Value。Token Value 获取方法如下：

前往用户管理页面，单击目标用户池名称。

在客户端页签中，单击任意一个“客户端类型”为 Web 应用的客户端名称。其他类型的客户端暂不支持获取 Token。

在详情页中，单击右上角“登录测试”按钮，选择任意一种有权限的方式登录。

登录成功后，在登录测试结果页面 Token 信息区域，复制id_token或access_token，作为 Token Value。

Step 2：在“选择需要调试的工具”区域，选择用于调试的工具。具体的工具介绍参见控制台中的工具说明。

Step 3：在“输入参数进行调试”区域，按照实际需要填写调试参数，填写完成后，单击“测试工具”按钮，完成操作。

查看测试结果。

如果返回测试成功，则表示 MCP 服务的工具连接正常。

如果返回测试失败，则表示 MCP 服务的工具连接存在问题，请根据错误原因进行排查后再次测试。

最近更新时间：2026.10.28 17:39:18

这个页面对您有帮助吗？

有用

有用

无用

无用