MCP 配置
Download
聚焦模式
字号
MCP 功能特性
说明：
MCP 1.6.0 起覆盖了 Chat 组件、SDK、服务端 API、服务端回调、产品计费与配置相关的查询能力。
功能分类 | 覆盖范围 |
知识咨询 | Chat UIKit 组件（ ConversationList、 MessageList、MessageInput、ContactList、Search ）、主题配置、本地化多语言、SDK API 文档。 |
| 离线推送 Push 接入、厂商配置信息 。 |
| SDK 错误码（2xxx/3xxx/8xxx）、服务端错误码（消息/群组/关系链/账号/资料等）。 |
| 套餐价格、免费额度、套餐购买、能力限制、多端登录配置、内网代理等。 |
| 服务端接口调用、导入账号、服务端发消息。 |
| Webhook 配置、发消息回调、第三方回调。 |
功能集成 | Web（Vue3/React）UIKit 集成。 |
| Native（Android/iOS/Flutter）UIKit 集成。 |
平台支持 | Web / Android / iOS / Flutter。 |
第 1 步：获取 TRTC 应用凭证
1. 登录 TRTC 控制台
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（对所有项目生效）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，表示配置成功。文档反馈