If you run into trouble with MCP, login, packages, or platform setup, the table below points you to the right section.
|
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 | |
Android permission denied, iOS pod install fails, Flutter doctor errors | |
SECRET_KEY safety | |
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:
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.
|
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.
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