よくある質問
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 | |
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:
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, orStore the config globally at
~/.cursor/mcp.json so it's outside your project directory entirely
