前置准备

开始接入前，请先确认以下条件。

• 已开通云听 CEM 账号，并具备对应项目、数据和功能权限。
• 当前企业已开通 MCP 接入能力，并允许当前账号生成 API Key。
• 已准备好云听 MCP 服务地址：https://ytcem.cn/mcp。
• 已在云听管理后台获取 API Key。
• 使用的 AI 客户端支持远程 MCP 服务。Claude 需要支持自定义连接器，Codex、Cursor、VS Code、Dify、Coze 等按各自平台的 MCP 配置入口接入。
• 如果由企业统一管理 Claude Team 或 Enterprise，请先确认工作区管理员是否允许添加自定义连接器。

在云听系统获取 API Key

MCP API Key 是企业级接入凭证，由云听管理后台统一生成和管理。客户端接入时只需要填写本文档提供的 MCP 服务地址和 API Key，不需要填写项目 ID 或内部上下文参数。

请帮我在当前 AI 工具中添加以下云听 MCP 服务：
{
  "mcpServers": {
    "ytcem-mcp": {
      "type": "streamable-http",
      "url": "https://ytcem.cn/mcp",
      "headers": {
        "X-MCP-Api-Key": ""
      },
      "disabled": false
    }
  }
}

在 Claude 中配置云听 MCP

还没有 API Key？先获取 API Key →

为避免 AI 在未确认时新增外部工具或接触凭证，Claude 需要你在设置中手动添加连接器。

1. 名称填 ytcem-mcp，服务地址填 https://ytcem.cn/mcp。
2. 按界面提示填入云听 API Key，然后保存。
3. 在新对话中开启 ytcem-mcp 连接器。团队账号如看不到添加入口，请联系工作区管理员。

还是无法完成？查看 Claude 官方配置文档 ↗

在 Codex 中配置云听 MCP

还没有 API Key？先获取 API Key →

Codex 会让用户在设置中确认 MCP 服务和凭证来源，因此对话里不一定能直接完成配置。

1. 名称填 ytcem-mcp，类型选 Streamable HTTP，URL 填 https://ytcem.cn/mcp。
2. 将云听 API Key 作为 Bearer Token 配置，保存后重启 Codex。
3. 新建对话并输入 /mcp，确认 ytcem-mcp 已启用、已认证。

还是无法完成？查看 Codex 官方 MCP 文档 ↗

在 Cursor 中配置云听 MCP

还没有 API Key？先获取 API Key →

Cursor 可能会拒绝在对话中直接写入 MCP 配置或凭证。这是正常的安全提示，请在设置中手动确认。

1. 点击 Add Custom MCP，打开当前项目的 .cursor/mcp.json。
2. 粘贴下方配置，将高亮处替换为云听 API Key，然后保存。
3. 回到 MCP Tools，确认 ytcem-mcp 已出现并启用。

{
  "mcpServers": {
    "ytcem-mcp": {
      "url": "https://ytcem.cn/mcp",
      "headers": {
        "X-MCP-Api-Key": ""
      }
    }
  }
}

还是无法完成？查看 Cursor 官方 MCP 文档 ↗

在 WorkBuddy 中配置云听 MCP

还没有 API Key？先获取 API Key →

WorkBuddy 需要用户在连接器管理中确认外部服务，对话无法代替这一步。

1. 在侧边栏打开 连接器，点击右上角 自定义连接器。
2. 粘贴下方配置，将高亮处替换为云听 API Key，然后保存。
3. 返回连接器列表，确认 ytcem-mcp 已启用。

{
  "mcpServers": {
    "ytcem-mcp": {
      "type": "streamable-http",
      "url": "https://ytcem.cn/mcp",
      "headers": {
        "X-MCP-Api-Key": ""
      },
      "disabled": false
    }
  }
}

还是无法完成？查看 WorkBuddy 官方 MCP 文档 ↗

其他客户端配置

还没有 API Key？先获取 API Key →

VS Code、Dify、Coze 等客户端都只需要下面三项信息。

名称

ytcem-mcp

服务地址

https://ytcem.cn/mcp

认证方式

Bearer Token，填入云听 API Key

无需填写项目 ID 或其他上下文参数。

可用工具参考

下面按单个工具说明当前可开放给 AI 客户端调用的 MCP 能力。普通用户可以先看“作用”和“适用场景”，技术支持接入时重点看“入参”和“出参”。不同账号实际可用范围以开通配置为准。

重要使用说明

• 云听 MCP 只能访问当前账号授权范围内的数据和工具。
• 大批量数据查询通常会创建异步任务，结果准备完成后再返回到对话中继续分析。
• API Key 用于身份鉴权，请妥善保管，不要写入公开代码仓库、截图或共享文档。
• 当前文档覆盖项目授权、数据类型、主题标签和异步客户反馈查询。后续新增能力请以云听单独的产品说明为准。
• 企业 Agent 平台接入前，建议先用小范围项目和测试账号验证工具权限、返回内容和失败处理。

常见问题