tencent cloud

实时音视频

文档实时音视频AI 集成MCP 配置

MCP 配置

下载
聚焦模式
字号
最后更新时间： 2026-10-08 16:12:33
MCP 提供了 TRTC 知识咨询和含 UI 功能集成的 AI 解决方案。您可以在 AI 编辑器里配置 MCP，帮您快速准确的查询实时音视频相关文档内容和实现功能集成。以上能力覆盖 Web / Android / iOS / Flutter 等平台。
说明：
MCP 1.6.0 起覆盖了 Live、Call 、Room 组件和 Core SDK API 以及 WebRTC 插件、Native TRTC API 相关的查询能力。

能力清单

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

准备账号与凭证

您需要先在腾讯云控制台创建应用，并获取以下凭证（如果您还没有创建应用，支持不配置 SDKAppID 试用。）：
凭证
用途
获取位置
SDKAppID
MCP 环境变量，基础查询时配置。
SecretKey
MCP 环境变量，需要 MCP 生成测试 userSig 时配置。

配置 MCP

配置方式

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

环境变量

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

配置验证

配置保存后，在 IDE 的 MCP 面板中看到 tencent-rtc 显示为 Connected（绿色）即表示安装成功。

快速开始指南

快速唤醒技巧：
在提问时带上 @tencent-rtc 前缀，可跳过泛意图搜索，直连官方最新的 SDK 和 UI 组件能力，响应速度更快，回复精准。
精准唤醒（推荐）：“@tencent-rtc 帮我在 Vue3 项目中集成视频会议 RoomKit”
普通提问：“帮我在 Vue3 项目中集成视频会议 RoomKit”

知识咨询

复制下面 Prompt 到 IDE 对话框，体验知识咨询能力：
@tencent-rtc 帮我查一下 Vue3 LiveKit 集成指南，包含示例代码。

直播互动（Live）集成

直接复制下面 Prompt 到 IDE 对话框，通过 LiveKit 组件或无 UI Core SDK 集成直播互动能力：
任务：@tencent-rtc 在当前项目中集成 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：
任务：@tencent-rtc 在当前项目中集成 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：
任务：@tencent-rtc 在当前项目中集成 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 配置 @tencent-rtc/mcp@latest 连接失败怎么处理 ？

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

附录：全局手动安装

如果需要全局安装，可以在命令行执行以下命令：
npx -y @tencent-rtc/mcp@latest
上一篇: 概述下一篇: Skills 配置

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈

搜索
    请输入关键词搜索文档