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

MCP

最近更新时间：2026-07-08 16:41:00

我的收藏

本页目录：

MCP (Model Context Protocol) 标准化了应用向 LLM 提供上下文的方式。本文介绍如何使用 MCP 集成实时音视频 TRTC UIKit 组件和底层 SDK，仅支持 stdio 模式传输。

MCP 功能特性

说明：
MCP 1.6.0 起覆盖了 Live、Call 、Room 组件和 Core SDK API 以及 WebRTC 插件、Native TRTC API 相关的查询能力。
功能分类
覆盖范围
知识咨询
Live（Vue3）、Call、Room（Vue3 & React） 含 UI 集成指南以及 Call 含 UI 组件的客户端 API 。
Live、Call、Room 的 Core SDK 相关的能力。
WebRTC SDK API 、插件以及 Native TRTC API 相关能力。
功能集成
Live（Vue3）含 UI 组件集成。
Live （Android/iOS/Flutter/uni-app）Core SDK 直播和语聊功能集成。
Room（Vue3）含 UI 和 Core SDK 集成。
Call（Vue3/React/Android/iOS/Flutter）含 UI 和 Core SDK 集成。
平台支持
Web / Android / iOS / Flutter / uni-app（打包 app）等。

前置条件

MCP 已经发布在 NPM 上，您可以通过 npx 安装在任何支持 MCP 的 AI 编辑器中。
使用 MCP 您需要先在腾讯云控制台创建应用，并获取以下凭证：
凭证
用途
获取位置
SDKAppID
MCP 环境变量
SecretKey
MCP 环境变量，生成 UserSig （仅用于测试）

配置 MCP

在 AI 编辑器中配置

在您使用的 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 和即时通信 IM 应用 ID。
SECRETKEY: SDKAPPID 对应的密钥，用于生成测试 UserSig，如果您只是查询或排查问题，配置 SDKAPPID 即可。

快速开始指南

知识咨询

复制下面 Prompt 到 IDE 对话框，体验知识咨询能力：
LiveCoreView / LiveView 组件的 ref 是否暴露了 player 实例？通过 ref 可以访问哪些方法和属性？有没有 audioMuted、muted、toggleMute 等音频控制能力？组件的 expose 输出了什么？

直播互动（Live）集成

直接复制下面 Prompt 到 IDE 对话框，集成直播互动 LiveKit 或 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 对话框，集成视频会议 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
中国站