tencent cloud

Tencent Real-Time Communication

문서Tencent Real-Time CommunicationAI IntegrationConfigure MCP Server

Configure MCP Server

다운로드
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-10-08 16:12:33
MCP delivers an AI-powered solution for TRTC Knowledge Query and UI-Integrated Feature Implementation. By configuring MCP in your AI development environment, you can efficiently search real-time audio/video documentation and integrate feature sets directly into your project. MCP supports Web, Android, iOS, Flutter, and additional platforms.
Note：
Starting with MCP 1.6.0, you can query Live, Call, and Room components, Core SDK APIs, as well as WebRTC plugins and native TRTC API features.

Capability List

Capability Scenario
Capability Description
Example
Query
Query usage details for Live, Room, and Call components and APIs.
“@tencent-rtc How do I choose between UI-less and UI-integrated solutions for Vue3 TUIRoomKit?”
Query usage for Live, Room, and Call SDKs without UI components.
“@tencent-rtc How does a voice chat room admin take the 0th mic slot?”
Query WebRTC SDK, plugins, and native TRTC API capabilities.
“@tencent-rtc How to use the BasicBeauty plugin for skin smoothing, whitening, and rosiness in TRTC Web SDK?”
Integration
MCP automatically detects your framework (Vue3/Android/iOS/Flutter/uni-app) and generates the host start page, audience watch page, and co-host entry.
“@tencent-rtc Help me integrate LiveKit voice chat room in my iOS project”
MCP auto-detects the Vue3 framework and generates the meeting entry page, meeting room page, route registration, and enables screen sharing.
“@tencent-rtc Help me integrate RoomKit video conferencing in my Vue3 project”
Integration
MCP auto-detects Vue3, React, Android, iOS, or Flutter frameworks and generates call initiation and incoming call handling pages.
“@tencent-rtc Help me integrate CallKit audio/video call component in my Flutter project”
Troubleshooting
Diagnose common issues such as initialization failures, silent users on mic, error codes, and more.
“@tencent-rtc On iOS, audience in AtomicXCore voice chat room can't hear the host after joinLive. How to troubleshoot?”

Preparing Account and Credentials

Create an application in the Tencent Cloud Console and obtain the following credentials (If you haven't created an application yet, you can try MCP without configuring SDKAppID):
Credential
Purpose
Where to Obtain
SDKAppID
MCP environment variable, required for basic queries.
SecretKey
MCP environment variable, required for MCP to generate test userSig.

MCP Configuration

Configuration Methods

Set up MCP in your AI editor (Cursor / Codex / Claude Code CLI / Claude Desktop / CodeBuddy / Trae, etc.).
Cursor
Codex
Claude Code CLI
Claude Desktop
CodeBuddy
Trae
Go to Settings > Select Tools & MCP > Add Custom MCP > Open the mcp.json file and configure the following:
{
  "mcpServers": {
    "tencent-rtc": {
      "command": "npx",
      "args": ["-y", "@tencent-rtc/mcp@latest"],
      "env": {
        "SDKAPPID": "YOUR_SDKAPPID",
        "SECRETKEY": "YOUR_SECRET_KEY"
      }
    }
  }
}
1. Run the following command to configure MCP, replacing SDKAPPID and SECRETKEY with your actual application information.
codex mcp add tencent-rtc \\
  --env SDKAPPID=YOUR_SDK_APP_ID --env SECRETKEY=YOUR_SECRET_KEY \\
  -- npx -y @tencent-rtc/mcp@latest
For project-level configuration, add --scope project to write to the .mcp.json file in your project root directory.
2. Run codex mcp list to verify MCP configuration. If tencent-rtc appears in the list, configuration is successful.
1. Run the following command to configure MCP, replacing SDKAPPID and SECRETKEY with your actual application information.
claude mcp add tencent-rtc \\
  --env SDKAPPID=YOUR_SDK_APP_ID --env SECRETKEY=YOUR_SECRET_KEY \\
  -- npx -y @tencent-rtc/mcp@latest
For project-level configuration, add --scope project to write to the .mcp.json file in your project root directory.
2. Run claude mcp list to verify MCP configuration. If tencent-rtc appears in the list, configuration is successful.
Go to Settings > select Developer > Edit Config > claude_desktop_config.json, and configure as follows:
{
  "mcpServers": {
    "tencent-rtc": {
      "command": "npx",
      "args": ["-y", "@tencent-rtc/mcp@latest"],
      "env": {
        "SDKAPPID": "YOUR_SDKAPPID",
        "SECRETKEY": "YOUR_SECRET_KEY"
      }
    }
  }
}
Go to Settings > select MCP > Configure MCP > open the mcp.json file and configure as follows:
{
  "mcpServers": {
    "tencent-rtc": {
      "command": "npx",
      "args": ["-y", "@tencent-rtc/mcp@latest"],
      "env": {
        "SDKAPPID": "YOUR_SDKAPPID",
        "SECRETKEY": "YOUR_SECRET_KEY"
      }
    }
  }
}
Go to Settings > Select MCP > Manually Add MCP > Raw Configuration (JSON) > Open the mcp.json file and configure the following:
{
  "mcpServers": {
    "tencent-rtc": {
      "command": "npx",
      "args": ["-y", "@tencent-rtc/mcp@latest"],
      "env": {
        "SDKAPPID": "YOUR_SDKAPPID",
        "SECRETKEY": "YOUR_SECRET_KEY"
      }
    }
  }
}

Environment Variables

SDKAPPID: TRTC application ID for real-time audio/video.
SECRETKEY: SecretKey associated with your SDKAppID, used to generate test userSig.

Configuration Validation

After saving your configuration, confirm that tencent-rtc is shown as Connected (green) in your IDE's MCP panel. This indicates successful installation.

Quick Start Guide

Quick Activation Tips:
Add the @tencent-rtc prefix to your questions to bypass generic intent search and directly access the latest official SDK and UI component features. This improves both response speed and accuracy.
Precise Activation (Recommended): “@tencent-rtc Help me integrate RoomKit video conferencing in my Vue3 project”
General Query: “Help me integrate RoomKit video conferencing in my Vue3 project”

Knowledge Query

Copy and paste the following prompt into your IDE dialog to try the knowledge query feature:
@tencent-rtc Please check the Vue3 LiveKit integration guide for me, including sample code.

Live Interaction Integration

Copy and paste the following prompt into your IDE dialog to integrate live interaction using the LiveKit component or UI-less Core SDK:
Task: @tencent-rtc Integrate LiveKit in the current project (get the basic video live streaming flow running first)

Requirements:
1. Auto-detect framework (Web Vue3/Flutter/Android/iOS).
2. If detection fails, call `present_framework_choice` to let the user choose.
3. Call MCP tools per platform:
   - Web: `get_web_live_uikit_integration`
   - Native: `get_native_livekit_core_integration`
4. Parameter: `framework`.
5. Call `get_usersig` to complete initialization and login.
6. Generate host start page, audience watch page, and basic interaction entry.

Acceptance Checklist:
- Host can start streaming
- Audience can watch
- Basic interaction available (e.g., co-host entry)

Troubleshooting:
- Black screen: Check device permissions and rendering initialization
- No sound: Check audio permissions and device routing

Video Conference Integration

Copy and paste the following prompt into your IDE dialog to integrate RoomKit video conferencing for Web Vue3:
Task: @tencent-rtc Integrate RoomKit in the current project (run quick-start mode first)

Requirements:
1. Auto-detect framework (Web Vue3).
2. If detection fails, call `present_framework_choice` to let the user choose.
3. Call MCP tools per platform:
   - Web: `get_web_room_uikit_integration`
4. Parameter: `framework`.
5. Call `get_usersig` to complete initialization and login.
6. Generate meeting entry page, meeting room page, and route registration.

Acceptance Checklist:
- Device check passes
- Able to join meeting and see audio/video
- Screen sharing available (if platform supports)

Troubleshooting:
- Room entry failure: Check roomId and login status
- No video/no audio: Check camera and microphone permissions

Audio/Video Call Integration

Copy and paste the following prompt into your IDE dialog to integrate CallKit for audio/video calls:
Task: @tencent-rtc Integrate CallKit in the current project (get 1v1 voice and video calls running first)

Requirements:
1. Auto-detect framework (React/Vue3/Flutter/Android/iOS).
2. If detection fails, call `present_framework_choice` to let the user choose.
3. Call MCP tools per platform:
   - Web: `get_web_call_uikit_integration`
   - Native: `get_native_call_uikit_integration`
4. Parameter: `framework`.
5. Call `get_usersig` to complete initialization and login.
6. Generate minimal call entry and incoming call handling page.

Acceptance Checklist:
- Initialization and login succeed
- Able to initiate 1v1 video call
- Able to receive and answer incoming calls

Troubleshooting:
- 60001: Regenerate userSig
- Call failure: Check network and device permissions

FAQs

How do I resolve connection failures for @tencent-rtc/mcp@latest in Cursor IDE?

If MCP fails to connect in Cursor, it may be due to npx cache issues. Run the following commands in your terminal to clear the cache, then reload and reconnect MCP.
rm -rf ~/.npm/_npx && npm cache verify

Appendix: Global Manual Installation

To install MCP globally, run the following command in your terminal:
npx -y @tencent-rtc/mcp@latest
이전 주제: Overview다음 주제: Install Skills

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백

키워드로 검색
    Enter keywords to search documentation