tencent cloud

FAQ
Download PDF
Last updated:2026-03-11 17:08:20
FAQ
Last updated: 2026-03-11 17:08:20
Download PDF
If you run into trouble with MCP, login, packages, or platform setup, the table below points you to the right section.
Issues
Go to
MCP server offline, tools not loading, or AI not using tencent-rtc tools
Login fails, UserSig invalid/expired, or SDK_APP_ID/SECRET_KEY issues
Wrong TUIKit package, React upgrade breaks TUIKit
Skills installed but AI doesn't treat request as Chat/TUIKit
Skills
Android permission denied, iOS pod install fails, Flutter doctor errors
SECRET_KEY safety
Security

MCP connection

The MCP server shows as offline or tools don't load

When: MCP server appears offline in settings, or tencent-rtc tools are missing from the tool list.
Work through 1–4 in order; stop when the server is back up.
1. Node.js: Run node -v; you need v18 or higher. Get LTS from nodejs.org if needed.
2. Run the server once: From a terminal (e.g. your project root or any directory): npx -y @tencent-rtc/mcp. If it runs without errors, restart your IDE and re-enable the server.
3. Config JSON: Check for typos, trailing commas, or missing quotes. Validate at jsonlint.com.
4. Restart the IDE: Config changes often need a full restart to take effect.

How do I install the MCP server manually?

When: IDE auto-install fails or you want to verify the server runs. From a terminal (e.g. your project root or any directory), run:
npx -y @tencent-rtc/mcp
Once it runs successfully, restart your IDE and re-enable the MCP server in settings.

The AI doesn't use the tencent-rtc MCP tools automatically

When: You asked for Chat integration but the AI didn't call tencent-rtc tools. Some IDEs don't auto-select an MCP server. Specify it explicitly in your prompt:
Use the tencent-rtc MCP tool to generate a userSig for test001

Credentials

Login fails after the AI writes the UserSig into code

When: Login or init fails; userSig in code may be escaped or malformed.
Special characters in userSig (such as +, =, /) can get escaped when the AI writes them into a file automatically.
Fix it by asking the AI to regenerate, then copy the value manually:
Regenerate the userSig for test001 using the MCP tool
Once the AI outputs the JSON, copy the raw userSig string and paste it directly into the code yourself.

UserSig expired

When: Login works then fails after a few days. UserSigs are valid for 7 days by default. To regenerate:
Use the MCP tool to regenerate userSig for test001 and test002, and update the code

SDK_APP_ID and SECRET_KEY don't match

When: Auth or init fails; credentials may be from different apps or mistyped.
Confirm both values come from the same application in the console (SDK_APP_ID is numeric; SECRET_KEY is a long string — copy both again from the app page if either looks wrong)
Double-check you're looking at the right application if you have multiple

Packages and frameworks

Which package name does each framework use?

When: You need the exact npm package name for React or Vue TUIKit.
Framework
Package
React
@tencentcloud/chat-uikit-react
Vue 3
@tencentcloud/chat-uikit-vue3
These are not interchangeable. Installing the wrong one causes runtime errors.

The AI installed the wrong TUIKit package

When: Wrong framework package is installed (e.g. Vue package in a React app). Specify the correct package name explicitly:
Uninstall the current TUIKit package and install @tencentcloud/chat-uikit-react

Skills

Skills are configured but the AI still doesn't recognize my Chat request

When: User asked for Chat/TUIKit but AI didn't use tencent-rtc tools or Skills.
1. Confirm the CLI installed the skill and the tencent-rtc-skills folder exists in the path the CLI printed (e.g. under ~/.cursor or your project)
2. Restart the IDE so Skills re-load
3. As a fallback, add explicit keywords to your prompt: "TUIKit", "Chat", "React" or "Vue"

What path format should I use for Skills?

When: Skills path is wrong or Skills don't load. Use an absolute path or ~ expansion (e.g. ~/.skills/tencent-rtc-skills). Relative paths can break when the IDE's working directory changes.

Platform-specific

Android: "Permission denied" when creating files

When: IDE or AI cannot create files in the Android project directory (on your development machine).
Fix permissions: run the following (replace /path/to/your/project with your Android project path):
sudo chmod -R 755 /path/to/your/project
Or move the project to a directory your user can write to (e.g. ~/Projects/).

iOS: pod install fails

When: pod install or CocoaPods fails in an iOS project. CocoaPods source may be stale, or the version may be too old. Ask the AI:
pod install failed — diagnose the issue and fix it

Flutter: flutter doctor reports errors

When: Flutter toolchain or environment has issues. Run:
Run flutter doctor and tell me what needs to be fixed

Security

Is it safe to store SECRET_KEY in mcp.json?

When: You're unsure whether local mcp.json is safe for development. mcp.json lives only on your local machine, so it's safe for development as long as you don't commit it to a repository.
To keep it out of version control:
Add .cursor/mcp.json to your .gitignore, or
Store the config globally at ~/.cursor/mcp.json so it's outside your project directory entirely
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback