MCP 提供 TRTC 技术知识、套餐价格与购买咨询和功能集成 AI 解决方案。您可以在 AI 编辑器里用自然语言提问,直接获得基于腾讯云官方文档的答案,并可一键生成集成代码。
说明:
MCP 1.9.0 新增套餐价格与购买咨询:套餐购买、版本价格、能力清单、计费规则、多个 UI 组件共存等问题,直接返回结构化答案(价格、能力、版本限制,附官方购买页链接)。支持 CallKit、LiveKit、RoomKit 组件及 TRTC、即时通信 IM 底座,可结合场景、能力需求和预算查询对应套餐。
三大优势
答案可溯源:答案来自官方文档并附来源链接,不依赖模型训练数据;文档中没有的内容会明确说明,不编造 API 和参数。
套餐咨询一步到位:套餐版本、价格、能力与计费规则一次给出,并附官方购买与开通入口,无需在多个计费文档间翻找。
一个入口覆盖全栈:组件、客户端 API、Core SDK、服务端 API 与回调、错误码在同一入口查询,无需在多个文档站之间切换。
能力清单
能力场景 | 能力说明 | 示例 |
知识咨询 | 根据场景和能力需求查询对应套餐。 | “@tencentcloud-sdk-mcp 用 LiveKit 做直播 App 需要主播连麦,应该购买哪个套餐?” |
| 根据多端接入场景(如小程序 + Web)查询适用套餐。 | “@tencentcloud-sdk-mcp 在线问诊小程序 + 电脑 Web 该买 CallKit 哪个套餐?” |
| 多个 UI 组件同时使用时,给出购买引导、版本要求。 | “@tencentcloud-sdk-mcp 已经买了 CallKit,现在还要用 RoomKit,还要再买一个 RoomKit 套餐吗?” |
| 查询 RoomKit 相关的知识。 | “@tencentcloud-sdk-mcp Vue3 TUIRoomKit 无 UI 和含 UI 方案怎么选?” |
| 查询 LiveKit 相关的知识。 | “@tencentcloud-sdk-mcp 语聊房管理员怎么上麦到 0 号麦位?” |
| 查询 CallKit 相关的知识。 | “@tencentcloud-sdk-mcp CallKit 有没有视频交友解决方案?” |
| 查询 WebRTC SDK 和插件相关知识。 | “@tencentcloud-sdk-mcp TRTC Web SDK 美颜插件 BasicBeauty 磨皮美白红润使用方法?” |
| 查询服务端 REST API 与服务端回调的参数、触发时机。 | “@tencentcloud-sdk-mcp Call 通话状态回调有哪些事件和字段?” |
错误排查 | 诊断初始化失败、麦上用户无声、错误码等常见问题。 | “@tencentcloud-sdk-mcp iOS AtomicXCore 语聊房观众 joinLive 后听不到主播声音,怎么排查?” |
测试凭证 | 根据 SDKAppID + SecretKey 生成调试用 UserSig。 | “@tencentcloud-sdk-mcp 帮我生成 userID 为 test01 的 userSig。” |
代码集成 | MCP 根据上下文识别 Vue3/Android/iOS/Flutter/uni-app 框架,生成开播页、观看页、连麦入口。 | “@tencentcloud-sdk-mcp 帮我在 iOS 项目里集成 LiveKit 语聊房” |
| MCP 根据上下文识别 Vue3 框架,生成会议入口页、会议房间页、路由注册,支持屏幕共享。 | “@tencentcloud-sdk-mcp 帮我在 Vue3 项目里集成视频会议 RoomKit” |
| MCP 根据上下文识别 Vue3/React/Android/iOS/Flutter 框架,生成发起通话和来电处理页面。 | “@tencentcloud-sdk-mcp 帮我在 Flutter 项目里集成音视频通话 CallKit 组件” |
平台覆盖:Web、React、Vue、小程序、uni-app(打包 app)、Android、iOS、HarmonyOS、Flutter、React Native、Unity、C++。
准备账号与凭证
您需要先在腾讯云控制台创建应用,并获取以下凭证(如果您还没有创建应用,支持不配置 SDKAppID 试用。):
凭证 | 用途 | 获取位置 |
SDKAppID | MCP 环境变量,基础查询时配置。 | |
SecretKey | MCP 环境变量,需要 MCP 生成测试 userSig 时配置。 | |
配置 MCP
配置方式
在您的 AI 编辑器(CodeBuddy / Trae / Cursor / Codex / Claude Code CLI / Claude Desktop 等)配置 MCP。如果配置文件中已配置了其他 MCP 服务,请不要整段覆盖。只需把下面
"tencentcloud-sdk-mcp": { ... } 这一项添加到已有的 mcpServers 对象中,用英文逗号分隔。单击设置 > 选择 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. 自动识别框架(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. 自动识别框架(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- 通话失败:检查网络与设备权限
常见问题
IDE 提示 MCP error -32000: Connection closed xxx .npm/_npx xxx 怎么处理?
IDE 配置 @tencentcloud/sdk-mcp@latest 连接失败,如果提示是 .npm/_npx xxx 这样的问题,是 npx 缓存问题,请在终端执行以下命令,清除缓存后, reload 重新连接 MCP。如果重启后问题没有解决,请把错误信息复制给 AI,让 AI 帮您分析下具体原因。
rm -rf ~/.npm/_npx && npm cache verify
IDE 提示 npx 命令不可用,如何处理?
IDE 配置 @tencentcloud/sdk-mcp@latest 时,提示 npx 命令不可用,原因是本机没有 Node 环境或者 Node 版本过低导致的问题,请安装或升级 Node 20+ 的稳定版本,安装完成后重启 IDE。
附录:全局手动安装
如果需要全局安装,可以在命令行执行以下命令:
npx -y @tencentcloud/sdk-mcp@latest