tencent cloud

实时音视频

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

MCP 配置

Download
聚焦模式
字号
最后更新时间： 2026-08-21 15:38:04
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。

前置条件

第 1 步：获取 TRTC 应用凭证

1. 登录 TRTC 控制台
打开 TRTC 控制台，创建一个新的 Chat 应用或选择已有应用。
2. 复制 SDKAppID 与 SDKSecretKey
在应用详情页复制这两个值，后续将填写到 MCP 配置里。

警告：
SDKSecretKey 属于敏感密钥，请勿提交到代码仓库，或在公开渠道分享。
本地开发：可暂存于 MCP 配置中用于调试。
上线前：请将 UserSig 生成迁移到你的业务后端完成，详见 生成 UserSig。

第 2 步：配置 MCP Server

MCP 的配置文件位置因"作用域"而异，你可以根据需求选择在项目级还是全局来配置 MCP：
项目级（推荐）：在项目根目录使用 .cursor/mcp.json（Cursor）或 .mcp.json（Claude Code / Codex CLI）
全局级：使用 ~/.cursor/mcp.json（对所有项目生效）
Cursor
CodeBuddy
Claude Code
Codex CLI
1. 下载 Cursor。
2. 在项目根目录下创建 .cursor/mcp.json 文件，把 mcpServers 的配置信息更新到 mcp.json 中并进行保存。
{
  "mcpServers": {
    "tencent-rtc": {
      "command": "npx",
      "args": ["-y", "@tencent-rtc/mcp@latest"],
      "env": {
        "SDKAPPID": "YOUR_SDKAPPID",
        "SECRETKEY": "YOUR_SECRET_KEY"
      }
    }
  }
}
3. 当保存文件时，会弹出下图提示，选择 Enable 开启 MCP 工具。

4. 配置完成，在 Cursor 的 Settings > Tools & MCP 选项中检查 MCP 工具是否成功加载。

1. 下载 CodeBuddy。
2. 单击 设置 > 添加 MCP 打开 settings.json 配置 MCP。

3. 把 mcpServers 的配置信息更新到 settings.json 文件中并进行保存。
{
  "mcpServers": {
    "tencent-rtc": {
      "command": "npx",
      "args": ["-y", "@tencent-rtc/mcp@latest"],
      "env": {
        "SDKAPPID": "YOUR_SDKAPPID",
        "SECRETKEY": "YOUR_SECRET_KEY"
      }
    }
  }
}
4. 检查 MCP 工具是否成功加载 tools。

1. 运行以下命令配置 MCP，将 SDKAPPID 和 SECRETKEY 替换为真实的应用信息。
claude mcp add tencent-rtc -e SDKAPPID=YOUR_SDKAPPID -e SECRETKEY=YOUR_SECRET_KEY -- npx -y @tencentcloud/sdk-mcp@1.4.3
如需项目级配置，可追加 --scope project，写入项目根目录的 .mcp.json。
2. 运行 claude mcp list 验证 MCP 是否配置成功，列表中出现 tencent-rtc 表示配置成功。
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 表示配置成功。

第 3 步：验证 MCP 是否可用（生成测试 UserSig）

在你的 AI 对话中发送如下提示词，验证 MCP 服务是否工作正常：
使用 tencent-rtc MCP 工具为 test001 生成一个 userSig
如果成功返回 userSig，表示配置成功。

下一步

安装 Agent Skills，用自然语言描述需求，AI 会自动识别产品和平台，引导你完成集成、排障或文档查询，详见 Skills 配置。
上一篇: 概述下一篇: Skills 配置

帮助和支持

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

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

文档反馈