实时音视频 MCP

注意：说明：

注意：MCP 1.8.0 起知识库覆盖直播/语聊房 Live、音视频通话 Call、视频会议 Room、TRTC SDK、AI 实时对话等资源，内置最新文档，支持 10+ 的平台与框架，涵盖组件与 Core SDK API、WebRTC 插件、Native TRTC API、服务端 API 与回调、错误码的查询能力。

一、三大优势

·答案可溯源：答案来自产品文档并附来源链接，不依赖模型训练数据；文档中没有的内容会明确说明，不编造 API 和参数。

·自动确认平台：平台信息不明确时主动向你确认，避免跨平台混答。

·一个入口覆盖全栈：组件、客户端 API、Core SDK、服务端 API 与回调、错误码在同一入口查询，无需在多个文档站之间切换。

二、能力清单

平台覆盖：Web、React、Vue、小程序、uni-app（打包 app）、Android、iOS、HarmonyOS、Flutter、React Native、Unity、C++。

三、准备账号与凭证

你需要先在腾讯云控制台创建应用，并获取以下凭证（如果你还没有创建应用，支持不配置 SDKAppID 试用。）：

四、配置方式

在你的 AI 编辑器（CodeBuddy / Trae / Cursor / Codex / Claude Code CLI / Claude Desktop 等）配置 MCP。

CodeBuddyTraeCursorCodexClaude Code CLIClaude 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。

六、配置验证

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

七、快速开始指南

注意：快速唤醒技巧：

注意：在提问时带上 @tencentcloud-sdk-mcp 前缀，可跳过泛意图搜索，直连最新的 SDK 和 UI 组件能力，响应速度更快，回复精准。

注意：精准唤醒（推荐）：“@tencentcloud-sdk-mcp 帮我在 Vue3 项目中集成视频会议 RoomKit”

注意：普通提问：“帮我在 Vue3 项目中集成视频会议 RoomKit”

八、知识咨询

复制下面 Prompt 到 IDE 对话框，体验知识咨询能力：

@tencentcloud-sdk-mcp 帮我查一下 Vue3 LiveKit 集成指南，包含示例代码。

九、直播互动（Live）集成

直接复制下面 Prompt 到 IDE 对话框，通过 LiveKit 组件或无 UI Core SDK 集成直播互动能力：

任务：@tencentcloud-sdk-mcp 在当前项目中集成 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：

任务：@tencentcloud-sdk-mcp 在当前项目中集成 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：

任务：@tencentcloud-sdk-mcp 在当前项目中集成 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