听云 Network MCP 设置
国内客户端
| 千问 / Qwen Code | Kimi Code | MiniMax Code |
|---|---|---|
| 百度 Comate | 字节跳动 TRAE | 腾讯 CodeBuddy |
国外客户端
开始前先确认 已取得听云管理员提供的 MCP URL、 X-Mcp-Client和authKey。客户端能够访问目标 HTTPS 地址，并支持远程 Streamable HTTP。 先验证只读工具；创建任务、启停任务或发起即时监测前必须明确确认。
支持状态与准备工作
| 客户端 | 本文结论 | 接入方式 |
|---|---|---|
| 千问（Qwen Code） | 直接支持 | 本文“千问”特指 Qwen Code；支持远程 HTTP、请求头与分级配置 |
| Kimi Code | 直接支持 | 远程 HTTP、mcp.json、状态与连接测试 |
| 百度 Comate | 直接支持 | Streamable HTTP、远程请求头、用户级/项目级 mcp.json |
| TRAE | 直接支持 | 在 Settings > MCP 手动配置，并把 MCP 加入 Builder/自定义 Agent |
| 腾讯 CodeBuddy | 直接支持 | CodeBuddy Settings > MCP；支持 URL、headers 与连接状态验证 |
| Codex | 直接支持 | Streamable HTTP、config.toml、静态或环境变量请求头 |
边界说明： “直接支持”仅表示客户端的公开配置格式能够承载听云当前远程 HTTP 与请求头方式，不代表当前租户、网络、权限、套餐和全部工具已经验证。
通用连接信息
准备以下信息
X-Mcp-Client：客户端标识，由听云管理员提供。authKey：租户凭据；不得写入提示词、截图、工单或公开仓库。通用端点
| 模块 | 路径 | 用途 |
|---|---|---|
| 告警 | /network-report-data/mcp/synthetic/alert | 告警列表、汇总与节点明细 |
| 即时监测 | /network-report-data/mcp/synthetic/instant | 在线节点、即时监测创建与结果 |
| 任务管理 | /network-report-data/mcp/synthetic/task | 任务、套餐、用量、原始数据与创建 |
千问 / Qwen Code
直接支持： 本文“千问”特指 Qwen Code；其支持远程 HTTP MCP、请求头以及用户级/项目级配置。
配置文件方式
~/.qwen 或者 qwen-agent/mcp.json；项目级配置位于 .qwen/settings.json。项目级文件可能进入版本控制，不应写入真实凭据。{
"mcpServers": {
"tingyun-network": {
"httpUrl": "https://<Tingyun-host>/<MCP_ENDPOINT_PATH>",
"headers": {
"X-Mcp-Client": "<CLIENT_ID>",
"authKey": "<AUTH_KEY>"
},
"timeout": 60000
}
}
}验证
1.
2.
3.
4.
Kimi Code
直接支持： Kimi Code 支持 HTTP MCP、请求头、启停与超时配置。
配置 mcp.json
~/.kimi-code/mcp.json；项目级配置为 .kimi-code/mcp.json。也可以在 Kimi Code 中使用 /mcp-config 管理服务器。{
"mcpServers": {
"tingyun-network": {
"url": "https://<Tingyun-host>/<MCP_ENDPOINT_PATH>",
"transport": "http",
"headers": {
"X-Mcp-Client": "<CLIENT_ID>",
"authKey": "<AUTH_KEY>"
},
"enabled": true,
"startupTimeoutMs": 20000,
"toolTimeoutMs": 60000
}
}
}验证
1.
2.
kimi mcp list 或 kimi mcp test tingyun-network。3.
4.
项目配置： 团队可以共享不含凭据的项目级配置骨架；真实 X-Mcp-Client和authKey应通过本机安全配置注入，避免提交到 Git。
MiniMax Code
平台构建 / 宿主兼容： MiniMax Agent 提供预置 MCP 与 MCP Builder；也可在第三方 MCP Agent 宿主中使用 MiniMax 模型。
能力边界： MiniMax 官方资料确认 MiniMax Agent 支持预置 MCP、定制 MCP 和 MCP Builder，但没有给出可直接照抄的听云远程 URL 配置字段。本文不虚构该字段。
1.
2.
3.
4.
~/.minimax/mcp.json；项目级配置为 .minimax/mcp.json。{
"mcpServers": {
"tingyun-network": {
"type": "streamable-http",
"enabled": true,
"configured": true,
"builtin": false,
"url": "https://<Tingyun-host>/通用端点路径获取路径",
"headers": {
"X-Mcp-Client": "<CLIENT_ID>",
"authKey": "<AUTH_KEY>"
}
}
}
}验证
1.
/mcp 查看连接状态和已加载工具。2.
百度 Comate
直接支持： Comate 可作为 MCP 客户端，支持 Streamable HTTP、远程请求头和用户级/项目级配置。
配置入口
~/.comate/mcp.json；项目级配置位于 <workspace>/.comate/mcp.json。项目文件不要保存真实凭据。mcp.json 示例
{
"mcpServers": {
"tingyun-network": {
"url": "https://<Tingyun-host>/<MCP_ENDPOINT_PATH>",
"headers": {
"X-Mcp-Client": "<CLIENT_ID>",
"authKey": "<AUTH_KEY>"
},
"timeout": 60
}
}
}验证
版本条件： Comate 官方资料中的 MCP 使用条件和模式名称可能随版本变化。若当前界面没有 MCP 或 Agent 入口，先升级 Comate IDE/插件并核对账号权 限。
TRAE（字节跳动）
直接支持： TRAE 的 Agent/Builder 支持 MCP；可在 Settings > MCP 中手动配置并加入目标 Agent。
设置步骤
1.
2.
3.
4.
远程 MCP 配置示例
{
"mcpServers": {
"tingyun-network": {
"url": "https://<Tingyun-host>/<MCP_ENDPOINT_PATH>",
"headers": {
"X-Mcp-Client": "<CLIENT_ID>",
"authKey": "<AUTH_KEY>"
}
}
}
}版本核对： TRAE 已公开 MCP 集成与手动 Raw Config 入口，但不同版本对远程 HTTP 字段的校验可能不同。若配置未识别，先升级客户端并查看 MCP 输出；不要自行改成错误的 stdio 命令。
验证
authKey。TRAE 会扫描敏感信息，但不能替代凭据治理。腾讯 CodeBuddy
直接支持： CodeBuddy IDE 支持 MCP Market、自定义 MCP Server、URL/headers 配置与状态验证。
设置步骤
1.
2.
3.
4.
~/.codebuddy/mcp.json 示例
{
"mcpServers": {
"tingyun-network": {
"type": "http",
"url": "https://<Tingyun-host>/<MCP_ENDPOINT_PATH>",
"headers": {
"X-Mcp-Client": "<CLIENT_ID>",
"authKey": "<AUTH_KEY>"
}
}
}
}验证与注意事项
npx/uvx。authKey 后，再测试需要确认的写操作。Codex
直接支持： Codex CLI、桌面端与 IDE 扩展共享 ~/.codex/config.toml中的 MCP 配置。
推荐：环境变量请求头
[mcp_servers.tingyun_network]
url = "https://<Tingyun-host>/<MCP_ENDPOINT_PATH>"
enabled = true
startup_timeout_sec = 20
tool_timeout_sec = 60
env_http_headers = { "X-Mcp-Client" = "TINGYUN_MCP_CLIENT_ID", "authKey" = "TINGYUN_AUTH_KEY" }TINGYUN_MCP_CLIENT_ID 与 TINGYUN_AUTH_KEY。不要把真实值提交到仓库。备选：静态请求头
[mcp_servers.tingyun_network]
url = "https://<Tingyun-host>/<MCP_ENDPOINT_PATH>"
enabled = true
startup_timeout_sec = 20
tool_timeout_sec = 60
http_headers = { "X-Mcp-Client" = "<CLIENT_ID>", "authKey" = "<AUTH_KEY>" }保护配置： 如果必须使用静态请求头，将 ~/.codex/config.toml权限限制为仅当前用户可读写；项目内不要再复制一份真实凭据。
验证
enabled: true、transport: streamable_http、URL 和超时正确。验证、权限与排障
最小验证流程
1.
2.
tools/list，确认目标模块的方法可见。3.
4.
authKey、完整请求头或不必要的客户敏感数据。5.
建议测试提示词
| 场景 | 提示词 |
|---|---|
| 只读 | 列出当前有效套餐和剩余额度，不创建任务。 |
| 告警 | 查看过去 24 小时仍处于告警状态的任务，并展开影响最大的一条；不要修改任务。 |
| 即时监测准备 | 列出北京移动的在线节点，仅生成即时监测配置并说明预计影响，不要发起监测。 |
| 变更 | 查找“官网首页”任务，展示当前状态和目标状态，等我确认后再停用。 |
操作分级
| 级别 | 典型操作 | 规则 |
|---|---|---|
| 只读 | 查询列表、详情、套餐、额度、节点和原始数据 | 可直接调用；仍需最小化返回数据 |
| 变更 | 启用/停用任务 | 展示任务、当前状态和目标状态，明确确认后执行 |
| 创建/消耗 | 创建任务、发起即时监测 | 校验套餐、额度和节点，展示参数及影响，确认后执行并回读 |
强制确认： 查询节点不等于允许发起监测；生成配置不等于允许创建任务。任何会修改线上状态、向目标发起探测或消耗额度的操作，都要单独确认。
常见问题与参考资料
| 现象 | 常见原因 | 处理与验证 |
|---|---|---|
| 看不到工具 | 客户端未重新加载、端点/上下文路径错误、鉴权失败、协议版本或工具白名单不匹配 | 重启/新建会话；确认 URL 为部署上下文 + /mcp/端点；携带 authKey；执行 tools/list；检查 MCP-Protocol-Version、Origin、MCP-Session-Id 及 includeTools 工具白名单。 |
| 鉴权失败 | 缺少或使用了无效的 authKey，或缺少接入所需的 X-Mcp-Client | 重新获取凭据并检查 authKey、X-Mcp-Client 请求头；不要把凭据写入提示词、截图或日志。 |
| 403 / 无权限 | authKey 无效，或当前账号的 MCP、租户、套餐或业务权限不足 | 区分鉴权失败与业务权限失败；确认当前账号具备所需的租户、套餐和任务权限；不要通过重复重试绕过权限。 |
| TLS/连接失败或浏览器预检失败 | 代理、VPN、证书、域名入口、Origin 或 CORS 请求头不符合接入要求 | 检查 DNS、代理、证书链、远程环境网络及 Origin；浏览器调用还要确认预检允许 MCP-Protocol-Version、MCP-Session-Id 等请求头。 |
| 调用超时 | 客户端超时、下游接口慢、查询范围过大或分页不足 | 按客户端配置合理设置超时；缩小时间范围、分页或拆分时段；确认请求是否已受理，再查询最终状态。 |
| 写操作未生效或结果不确定 | 参数、权限、套餐、额度或下游受理状态异常 | 调用前展示工具、参数和影响并取得明确确认；读取返回的任务或即时监测 ID，使用查询工具回读最终状态。 |