帮你快速理解、总结文档立即下载
文档中心>实时音视频>AI Coding>MCP

MCP

最近更新时间：2026-08-31 09:56:16
我的收藏

本页目录：

MCP 提供了 TRTC 知识咨询和功能集成的 AI 解决方案。您可以在 AI 编辑器里配置 MCP，帮您快速准确的查询实时音视频相关文档内容和实现功能集成。以上能力覆盖 Web / Android / iOS / Flutter / uni-app（打包 App） 等平台。
说明：
MCP 1.6.0 起覆盖了 Live、Call 、Room 组件和 Core SDK API 以及 WebRTC 插件、Native TRTC API 相关的查询能力。

能力清单

能力场景
能力说明
示例
知识咨询
查询 Live/Room/Call 组件和 API 的使用方式。
“Vue3 TUIRoomKit 无 UI 和含 UI 方案怎么选？”
查询 Live/Room/Call 无 UI SDK 的使用方式。
“语聊房管理员怎么上麦到 0 号麦位？”
查询 WebRTC SDK 和插件以及 Native TRTC API 相关能力。
“TRTC Web SDK 美颜插件 BasicBeauty 磨皮美白红润使用方法？”
代码集成
MCP 根据上下文识别 Vue3/Android/iOS/Flutter/uni-app 框架，生成开播页、观看页、连麦入口。
“帮我在 iOS 项目里集成 LiveKit 语聊房”
MCP 根据上下文识别 Vue3 框架，生成会议入口页、会议房间页、路由注册，支持屏幕共享。
“帮我在 Vue3 项目里集成视频会议 RoomKit”
MCP 根据上下文识别 Vue3/React/Android/iOS/Flutter 框架，生成发起通话和来电处理页面。
“帮我在 Flutter 项目里集成音视频通话 CallKit 组件”
错误排查
诊断初始化失败、麦上用户无声、错误码等常见问题。
“iOS AtomicXCore 语聊房观众 joinLive 后听不到主播声音，怎么排查？”

准备账号与凭证

您需要先在腾讯云控制台创建应用，并获取以下凭证：
凭证
用途
获取位置
SDKAppID
MCP 环境变量，基础查询时配置。
SecretKey
MCP 环境变量，需要 MCP 生成测试 userSig 时配置。
知识咨询/错误排查：配置 SDKAppID 即可；功能集成如需通过 MCP 获取测试 userSig 需要配置 SecretKey。

配置 MCP

配置方式

在您的 AI 编辑器（CodeBuddy / Trae / Cursor / Codex / Claude Code CLI / Claude Desktop 等）配置 MCP。
CodeBuddy
Trae
Cursor
Codex
Claude Code CLI
Claude Desktop
单击设置 > 选择 MCP > 配置 MCP > 打开 mcp.json 文件，配置以下内容：
{
  "mcpServers": {
    "tencentcloud-sdk-mcp": {
      "command": "npx",
      "args": ["-y", "@tencentcloud/sdk-mcp@latest"],
      "env": {
        "SDKAPPID": "YOUR_SDKAPPID",
        "SECRETKEY": "YOUR_SECRET_KEY"
      }
    }
  }
}
单击设置 > 选择 MCP > 手动添加 MCP > 原始配置(JSON) > 打开 mcp.json 文件，配置以下内容：
{
  "mcpServers": {
    "tencentcloud-sdk-mcp": {
      "command": "npx",
      "args": ["-y", "@tencentcloud/sdk-mcp@latest"],
      "env": {
        "SDKAPPID": "YOUR_SDKAPPID",
        "SECRETKEY": "YOUR_SECRET_KEY"
      }
    }
  }
}
单击设置 > 选择 Tools & MCP > Add Custom MCP > 打开 mcp.json 文件，配置以下内容：
{
  "mcpServers": {
    "tencentcloud-sdk-mcp": {
      "command": "npx",
      "args": ["-y", "@tencentcloud/sdk-mcp@latest"],
      "env": {
        "SDKAPPID": "YOUR_SDKAPPID",
        "SECRETKEY": "YOUR_SECRET_KEY"
      }
    }
  }
}
1. 运行以下命令配置 MCP，将 SDKAPPID 和 SECRETKEY 替换为真实的应用信息。
codex mcp add tencentcloud-sdk-mcp \\
  --env SDKAPPID=YOUR_SDK_APP_ID --env SECRETKEY=YOUR_SECRET_KEY \\
  -- npx -y @tencentcloud/sdk-mcp@latest
如需项目级配置，可追加 --scope project，写入项目根目录的 .mcp.json。
2. 运行 codex mcp list 验证 MCP 是否配置成功，列表中出现 tencentcloud-sdk-mcp 表示配置成功。
1. 运行以下命令配置 MCP，将 SDKAPPID 和 SECRETKEY 替换为真实的应用信息。
claude mcp add tencentcloud-sdk-mcp \\
  --env SDKAPPID=YOUR_SDK_APP_ID --env SECRETKEY=YOUR_SECRET_KEY \\
  -- npx -y @tencentcloud/sdk-mcp@latest
如需项目级配置，可追加 --scope project，写入项目根目录的 .mcp.json。
2. 运行 claude mcp list 验证 MCP 是否配置成功，列表中出现 tencentcloud-sdk-mcp 表示配置成功。
单击设置 > 选择 Developer > Edit Config > claude_desktop_config.json，配置以下内容：
{
  "mcpServers": {
    "tencentcloud-sdk-mcp": {
      "command": "npx",
      "args": ["-y", "@tencentcloud/sdk-mcp@latest"],
      "env": {
        "SDKAPPID": "YOUR_SDKAPPID",
        "SECRETKEY": "YOUR_SECRET_KEY"
      }
    }
  }
}

环境变量

SDKAPPID: 实时音视频 TRTC 应用 ID。
SECRETKEY: SDKAPPID 对应的密钥，用于生成测试 userSig。

快速开始指南

知识咨询

复制下面 Prompt 到 IDE 对话框，体验知识咨询能力：
Vue3 LiveCoreView 的 ref 暴露了哪些方法？

直播互动（Live）集成

直接复制下面 Prompt 到 IDE 对话框，通过 Livekit 组件或无 UI Core SDK 集成直播互动能力：
任务：在当前项目中集成 LiveKit（先跑通视频直播基础流程）

执行要求：
1. 自动识别框架（Web Vue3/Flutter/Android/iOS）。
2. 无法识别时，需要调用 `present_framework_choice` 给用户选择。
3. 按平台调用 MCP 工具：
   - Web: `get_web_live_uikit_integration`
   - Native: `get_native_livekit_core_integration`
4. 参数：`framework`。
5. 调用 `get_usersig` 完成初始化和登录。
6. 生成主播开播页、观众观看页、基础互动入口。

验收清单：
- 主播可开播
- 观众可观看
- 基础互动可用（如连麦入口）

常见问题排查：
- 黑屏：检查设备权限与渲染初始化
- 无声：检查音频权限与设备路由

视频会议（Room）集成

直接复制下面 Prompt 到 IDE 对话框，集成 Web Vue3 视频会议 RoomKit：
任务：在当前项目中集成 RoomKit（先跑通 quick-start 模式）

执行要求：
1. 自动识别框架（Web Vue3）。
2. 无法识别时，需要调用 `present_framework_choice` 给用户选择。
3. 按平台调用 MCP 工具：
   - Web: `get_web_room_uikit_integration`
4. 参数：`framework`。
5. 调用 `get_usersig` 完成初始化和登录。
6. 生成会议入口页、会议房间页、路由注册。

验收清单：
- 设备检测正常
- 可入会并看到音视频
- 屏幕共享可用（平台支持时）

常见问题排查：
- 进房失败：检查 roomId 与登录状态
- 无画面/无声音：检查摄像头麦克风权限

音视频通话（Call）集成

直接复制下面 Prompt 到 IDE 对话框，集成音视频通话 CallKit：
任务：在当前项目中集成 CallKit（先跑通 1v1 语音通话和视频通话）

执行要求：
1. 自动识别框架（React/Vue3/Flutter/Android/iOS）.
2. 无法识别时，需要调用 `present_framework_choice` 给用户选择。
3. 按平台调用 MCP 工具：
   - Web: `get_web_call_uikit_integration`
   - Native: `get_native_call_uikit_integration`
4. 参数：`framework`。
5. 调用 `get_usersig` 完成初始化和登录。
6. 生成最小可运行的呼叫入口和来电处理页面。

验收清单：
- 初始化与登录成功
- 能发起 1v1 视频通话
- 能收到来电并接听

常见问题排查：
- 60001：重新生成 userSig
- 通话失败：检查网络与设备权限

常见问题

Cursor IDE 配置 @tencentcloud/sdk-mcp@latest 连接失败怎么处理 ？

Cursor 配置 MCP 连接失败可能是因为 npx 缓存的问题，请在终端执行以下命令，清除缓存后， reload 重新连接 MCP。
rm -rf ~/.npm/_npx && npm cache verify

附录：全局手动安装

如果需要全局安装，可以在命令行执行以下命令：
npx -y @tencentcloud/sdk-mcp@latest
中国站