帮你快速理解、总结文档立即下载

MCP

最近更新时间:2026-11-16 15:56:23
本文档已由 AI 辅助审校
我的收藏
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 对象中,用英文逗号分隔。
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。

配置验证

配置保存后,在 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