Feedback
使用 MCP 迁移

伴随 AI Coding 的快速发展，开发效率与迁移效率成为关键。Tencent RTC 提供专业的 MCP Server，支持从 Agora、Zego、Twilio 等音视频服务商无缝迁移至 RTC Engine，大幅降低改造成本，显著提升迁移效率。
准备工作
环境准备
支持 MCP 的 AI 编程工具，例如 Cursor、Trae、CodeBuddy、Claude Code、Codex CLI 等。
已安装 Python。
已安装 uv。uv 是 Python 生态的依赖与环境管理工具，用于快速拉取并运行 MCP Server 所需组件。
获取访问密钥
MCP 通过腾讯云的云 API 对外提供服务，云 API 通过签名机制保证数据传输的安全性，该方式需要您在官网控制台申请安全凭证，即 SecretID 和 SecretKey。具体操作步骤如下：
1. 登录 CAM 控制台
打开 CAM 控制台，新建一个子用户。
﻿
2. 设置子用户权限
对该子用户授予 QcloudTrtccopilotFullAccess 权限（TRTC 云助手全读写访问权限）。
﻿
3. 复制 SecretID 与 SecretKey
     在 API 密钥管理 页面获取上述子用户的 SecretID 和 SecretKey 用于访问 MCP 服务。
﻿
警告：
SecretID 和 SecretKey 属于敏感密钥，请勿提交到代码仓库，或在公开渠道分享。本地开发可暂存于 MCP 配置中用于调试。
为降低密钥泄漏的风险，所有主账号、子账号的密钥，关闭查询 SecretKey 的功能，仅支持在创建时查看，请及时保存 SecretKey。
配置 MCP Server
MCP 的配置文件位置因“作用域”而异，你可以根据实际需求选择在项目级还是全局来配置 MCP Server。
其中 TENCENTCLOUD_SECRET_ID 和 TENCENTCLOUD_SECRET_KEY 需填入上一步获取到的安全凭证（对应 SecretID 和 SecretKey）。
Cursor
Trae
CodeBuddy
Claude Code
Codex CLI
1. ﻿下载 Cursor。
2. 在项目根目录下创建 .cursor/mcp.json 文件，把 mcpServers 的配置信息更新到 mcp.json 中并进行保存。
{
  "mcpServers": {
    "trtc-migration-assistant-intl": {
      "command": "uvx",
      "args": ["trtc-migration-assistant-intl"],
      "env": {
        "TENCENTCLOUD_SECRET_ID": "<your-secret-id>",
        "TENCENTCLOUD_SECRET_KEY": "<your-secret-key>"
      }
    }
  }
}
3. 配置完成，在 Cursor 的 Settings > Tools & MCP 选项中检查 MCP 工具是否成功加载。
﻿
1. ﻿下载 Trae。
2. 单击设置 > MCP。
﻿
3. 选择 Add > Configure Manually, 单击 Raw Config（JSON）打开配置文件，把 mcpServers 的配置信息更新到配置文件中并进行保存。
{
  "mcpServers": {
    "trtc-migration-assistant-intl": {
      "command": "uvx",
      "args": ["trtc-migration-assistant-intl"],
      "env": {
        "TENCENTCLOUD_SECRET_ID": "<your-secret-id>",
        "TENCENTCLOUD_SECRET_KEY": "<your-secret-key>"
      }
    }
  }
}
4. 选择编辑器默认的 Builder with MCP 或者将 MCP 添加到您自定义的 Builder 中。
﻿
1. ﻿下载 CodeBuddy。
2. 单击 设置 > 添加 MCP 打开 settings.json 配置 MCP。
﻿
3. 把 mcpServers 的配置信息更新到 settings.json 文件中并进行保存。
{
  "mcpServers": {
    "trtc-migration-assistant-intl": {
      "command": "uvx",
      "args": ["trtc-migration-assistant-intl"],
      "env": {
        "TENCENTCLOUD_SECRET_ID": "<your-secret-id>",
        "TENCENTCLOUD_SECRET_KEY": "<your-secret-key>"
      }
    }
  }
}
4. 检查 MCP 工具是否成功加载 tools。
﻿
1. 运行以下命令配置 MCP，将 TENCENTCLOUD_SECRET_ID 和 TENCENTCLOUD_SECRET_KEY 替换为真实的密钥信息。
claude mcp add trtc-migration-assistant-intl \
  -e TENCENTCLOUD_SECRET_ID=<your-secret-id> \
  -e TENCENTCLOUD_SECRET_KEY=<your-secret-key> \
  -- uvx trtc-migration-assistant-intl
如需项目级配置，可追加 --scope project，写入项目根目录的 .mcp.json。
2. 运行 claude mcp list 验证 MCP 是否配置成功，列表中出现 trtc-migration-assistant-intl 表示配置成功。
1. 运行以下命令配置 MCP，将 TENCENTCLOUD_SECRET_ID 和 TENCENTCLOUD_SECRET_KEY 替换为真实的密钥信息。
codex mcp add trtc-migration-assistant-intl \
  --env TENCENTCLOUD_SECRET_ID=<your-secret-id> \
  --env TENCENTCLOUD_SECRET_KEY=<your-secret-key> \
  -- uvx trtc-migration-assistant-intl
     如需项目级配置，需在项目根目录手动创建 .codex/config.toml 并写入 mcp_servers 的配置信息。
[mcp_servers."trtc-migration-assistant-intl"]
command = "uvx"
args = ["trtc-migration-assistant-intl"]
﻿
[mcp_servers."trtc-migration-assistant-intl".env]
TENCENTCLOUD_SECRET_ID = "<your-secret-id>"
TENCENTCLOUD_SECRET_KEY = "<your-secret-key>"
2. 运行 codex mcp list 验证 MCP 是否配置成功，列表中出现 trtc-migration-assistant-intl 表示配置成功。
使用 MCP Server
在完成 MCP Server 配置的 AI 编程工具中，选择或复制已集成的其他音视频服务商的业务代码，然后通过自然语言描述迁移需求，提示词示例如下。AI 会在对话中调用 MCP 工具完成 API 映射匹配、迁移指引文档拉取等操作，并最终提供迁移完成的业务代码。
@ xxx（原代码）
这是集成 xxx 服务商的代码，请帮我迁移到 TRTC
例如在 Cursor 中使用 MCP Server 进行代码迁移，参考截图如下。
﻿
﻿