Skip to main content

Frequently Asked Questions (FAQ)

🌟 Reasons to Choose CloudBase​

Why Choose CloudBase?​

  • ⚡ Lightning-fast Deployment: Domestic nodes offer faster access speeds than overseas ones.
  • 🛡️ Stable and Reliable: A Serverless platform chosen by 3.3 million developers
  • 🔧 Developer-Friendly: A full-stack platform designed for the AI era, supporting automatic environment configuration
  • 💰 Cost Optimization: Serverless architecture is more flexible, and new users can experience it for free during development.

🚀 Get Started​

As a new user, how do I get started quickly?​

  1. Install supported AI development tools (such as Cursor, WindSurf, etc.)
  2. Activate the environment in the Tencent Cloud Development Console (free for new users)
  3. Download the project template or configure MCP in an existing project
  4. Say "Login to CloudBase" to the AI to start development

Which AI Development Tools Are Supported?​

Supports mainstream AI development tools such as CloudBase AI CLI, Cursor, WindSurf, CodeBuddy, CLINE, GitHub Copilot, Claude Code, Gemini CLI, OpenAI Codex CLI, OpenCode, Trae, Tongyi Lingma, RooCode, Wenxin Kuaima, Augment Code, Qwen Code, etc.

🛠️ Technical Issues​

How can existing projects integrate this template and rule system?​

If you already have your own project, simply configure MCP and say "Download CloudBase AI rules in the current project" to the AI. This will one-click download and supplement the AI editor rule configurations to your project directory without manual operations.

If you only want to download configuration files for a specific IDE to avoid project file clutter, you can specify the IDE type:

Download CloudBase AI rules in the current project, only including Cursor configuration
Download CloudBase AI rules in the current project, only including WindSurf configuration
Download CloudBase AI rules in the current project, only including Claude Code configuration

How to Obtain the CloudBase Environment ID​

  1. Access the Tencent Cloud Development Console to activate the environment. New users can activate it for free.
  2. On the right side of the console's Overview page, obtain the Environment ID
    (This ID is required for subsequent deployment)

How to Update CloudBase AI ToolKit​

Update AI Rules

If you want to update to the latest CloudBase AI rules in your existing project, simply say to the AI:

Download CloudBase AI rules and update the rules in the current project

The AI will automatically download and update the latest rule configurations to your project directory.

Update MCP Tool

When a new version of the MCP tool is released, you can update it in the following ways:

  1. Automatic update (recommended): In your AI development tool's MCP list, find cloudbase and re-enable or refresh the MCP list to automatically install the latest version.

  2. Manual update: If the automatic update is unsuccessful, you can disable and then re-enable cloudbase, or restart your AI IDE

Notes:

  • In MCP configuration, the @latest tag is used, which typically automatically obtains the latest version
  • If you encounter cache issues, you can fully restart the AI IDE and then re-enable MCP
  • It is recommended to regularly check for updates to obtain the latest features and fixes

What should I do if MCP shows zero tools?​

If you see cloudbase-mcp showing a tool count of 0 in the MCP list of your AI development tool, troubleshoot by following the steps below:

1. Check environment configuration

  • Ensure the Node.js version is v18.15.0 or above
  • For macOS users managing Node.js with nvm, be sure to set the default Node version to v18.15.0 or above to avoid issues caused by version inconsistencies across different terminals.
  • Check the network connection. It is recommended to set the npm registry to the Tencent Cloud mirror source:
    npm config set registry https://mirrors.cloud.tencent.com/npm/

2. Re-enable MCP

  • Disable cloudbase-mcp in the MCP list of the AI development tool
  • Re-enable cloudbase or refresh the MCP list
  • If the issue persists, fully restart the AI IDE and retry

3. Manually reinstall

Generally, tools can be installed and displayed normally by re-enabling or refreshing the MCP list.

Refer to the steps below for how to globally install CloudBase AI ToolKit.

After MCP configuration, an error is reported: MCP error -32001: Request timed out​

If you encounter the MCP error -32001: Request timed out error when configuring MCP, you can follow the steps below to resolve it:

Refer to the steps below for how to globally install CloudBase AI ToolKit.

How to install CloudBase AI ToolKit globally?​

Issues Encountered​

When using CloudBase AI ToolKit, have you encountered the following issues?

  • Slow installation speed - Using npx requires redownloading each time, resulting in excessively long wait times
  • Complex configuration - Requires manual configuration of environment dependencies such as npm registry and Node.js version
  • Repeated installation - The MCP service needs to be repeatedly configured in different AI IDEs
  • Network issues - npm installations often encounter network timeouts or download failures

Solution: CloudBase AI CLI Quick Installation​

It is recommended to use the CloudBase AI CLI quick installation method to resolve all issues at once:

  • 🚀 Quick Installation - Compared to npm installation which usually takes several minutes, the one-click installation script can be completed in just a few seconds.
  • 🛠️ Unified Management - Manage multiple AI programming CLI tools with a single command, covering built-in tools like CloudBase AI Toolkit MCP
  • 🌍 Ubiquitous - Runs in any environment, including Mini Program Developer Tools, VS Code, GitHub Actions, etc.
  • 🔧 Out-of-the-box - Automatically configures the MCP service after installation without additional configuration

Quick Installation Steps​

1. Use the one-click installation script

Mac/Linux/Windows WSL users:

curl https://static.cloudbase.net/cli/install/install.sh -fsS | bash

Windows PowerShell users:

irm https://static.cloudbase.net/cli/install/install.ps1 | iex

2. Verify the installation

After installation is complete, CloudBase AI CLI will automatically install the CloudBase AI Toolkit MCP service and generate the global command cloudbase-mcp.

3. Configure MCP

Restart your AI IDE and then modify the MCP configuration:

{
  "mcpServers": {
    "cloudbase": {
      "command": "cloudbase-mcp"
    }
  }
}

4. Verify the MCP Service

You can immediately see that CloudBase MCP starts normally.

Supported AI IDE​

The quick installation method of CloudBase AI CLI is applicable to all AI IDEs that support MCP (Model Context Protocol), including but not limited to:

  • Cursor - An AI programming assistant based on VS Code
  • WindSurf - An AI programming tool developed by Tencent Cloud
  • CodeBuddy - Intelligent code assistant
  • Visual Studio Code - Supported via the CodeBuddy plugin
  • Claude Code - Anthropic's AI programming environment
  • GitHub Copilot - Supports the MCP version
  • Other AI IDEs Supporting MCP

This unified installation method allows you to seamlessly switch between different AI IDEs without the need for repeated configurations.

  • Normal configuration effect in CodeBuddy

  • Normal behavior of the CloudBase MCP configuration in the CodeBuddy plugin for Visual Studio Code

  • Normal configuration effect in Cursor

Learn More​

CloudBase AI CLI not only includes the built-in CloudBase AI Toolkit MCP but also supports multiple mainstream AI programming tools:

  • Claude Code - Anthropic's AI programming assistant
  • OpenAI Codex - OpenAI's code generation tool
  • aider - Open-source AI programming assistant
  • Qwen Code - Tongyi Lingma

For detailed usage instructions, refer to: CloudBase AI CLI Documentation

What should I do if the MCP configuration doesn't take effect?​

  1. Check whether the configuration format is correct
  2. Restart the AI IDE
  3. Confirm that the MCP service is enabled

What should I do if Safari browser fails to complete authorization login?​

If you encounter authorization login issues when using Safari browser, it is recommended to switch to Chrome browser for authorization login.

Safari browser may encounter compatibility issues in certain scenarios, affecting the normal authorization process. Chrome browser provides better support for CloudBase authorization workflows.

How to use MCP in a remote development environment or server-side​

Issues Encountered​

Have you encountered these challenges when using CloudBase AI ToolKit in a remote development environment?

  • Browser Authorization Failure - The server environment lacks a graphical interface and cannot complete browser login
  • Environment Isolation - The remote environment cannot access the local browser for authorization
  • Automated Deployment - CI/CD pipeline requires a non-interactive configuration method
  • Permission Management - Requires precise control over access permissions for CloudBase resources.

Solution: Environment Variable Configuration​

CloudBase AI CLI supports browserless authorization via environment variables, effectively resolving usage issues in remote environments.

Install CloudBase AI CLI​

Using the CloudBase AI CLI quick installation script:

curl https://static.cloudbase.net/cli/install/install.sh -fsS | bash

After installation is complete, the cloudbase-mcp global command will be automatically generated.

Configuration Method:

Use the env environment variable in MCP configuration to set authentication information:

{
  "mcpServers": {
    "cloudbase": {
      "command": "cloudbase-mcp",
      "args": ["--integration-ide", "YOUR_IDE"],
      "env": {
        "TENCENTCLOUD_SECRETID": "Tencent Cloud SecretId",
        "TENCENTCLOUD_SECRETKEY": "Tencent Cloud SecretKey",
        "TENCENTCLOUD_SESSIONTOKEN": "Tencent Cloud temporary key Token, only required if using temporary keys."
        "CLOUDBASE_ENV_ID": "CloudBase environment ID"
      }
    }
  }
}

Obtain Key Information:

This approach is particularly suitable for:

  • Remote development environments (such as GitHub Codespaces, cloud IDEs, etc.)
  • Server-side automation scripts
  • Automated deployment in CI/CD pipelines

Which application types are supported?​

  • Web Application: modern frontend + static hosting
  • WeChat Mini Program: CloudBase Mini Program solution
  • Backend Services: cloud database + serverless functions + cloud hosting

What are the special recommendations for developing WeChat Mini Programs?​

Recommended Development Process:

  1. Activate the Cloud Development environment in WeChat Developer Tools

    • Activate directly in WeChat Developer Tools to ensure seamless binding between the Mini Program and the Cloud Development environment

  2. When logging into the AI IDE, select [Mini Program/Official Account Login]

    • When redirected to log in to Tencent Cloud CloudBase, select [Mini Program/Official Account Login]
    • Use your Mini Program to log in instead of the Tencent Cloud main account

This ensures permission consistency and prevents environment configuration issues.

How to use CloudBase AI ToolKit in WeChat Developer Tools?​

CloudBase AI ToolKit and WeChat Developer Tools can be seamlessly integrated to deliver a more efficient development experience.

Method 1: Start development from the AI IDE​

If you have already started developing a Mini Program project in an AI IDE (such as Cursor, WindSurf, CodeBuddy, etc.):

  1. AI IDE Development: Use CloudBase AI ToolKit in AI IDEs for coding and cloud development resource management
  2. Import WeChat Developer Tools: Import the entire project folder in WeChat Developer Tools
  3. Real-time Synchronization: File changes in the AI IDE are synchronized to WeChat Developer Tools in real time
  4. Build Preview: Perform build and preview operations in WeChat Developer Tools
  5. Error Troubleshooting: If encountering build or runtime errors, copy the error messages to the AI IDE for intelligent troubleshooting

Advantages:

  • Enjoy the convenience of AI intelligent programming
  • Utilize the native debugging capabilities of WeChat Developer Tools
  • Real-time preview and real device debugging
  • A complete development toolchain

Method 2: Start from WeChat Developer Tools​

If you already have a mini program project in WeChat Developer Tools:

  1. Open Project: Open an existing mini-program project folder in the AI IDE
  2. Configure MCP: Refer to the documentation to configure the CloudBase MCP service
  3. Download AI Rules: Say "Download CloudBase AI rules" to the AI to obtain the development rules
  4. Start AI Development: Use AI for code writing and cloud development resource management
  5. WeChat Developer Tools Preview: Perform real-time preview and debugging in WeChat Developer Tools

Workflow:

  • AI IDE: Responsible for code writing, cloud function development, database design, etc.
  • WeChat Developer Tools: Responsible for Mini Program preview, real-device debugging, performance analysis, etc.
  • Both work in synergy to leverage their respective strengths

Notes:

  • Ensure both tools open the same project folder
  • Files are automatically synchronized after saving, requiring no manual operation.
  • It is recommended to complete the main development work in the AI IDE and perform final testing in WeChat Developer Tools

🔄 Environment Management​

How to Switch the CloudBase Environment​

Log out of CloudBase
Log in to CloudBase

How to Switch Tencent Cloud Accounts​

If you need to switch to a different Tencent Cloud account:

  1. Clear Local Login State: Tell the AI log out
  2. Log Out in Browser: Log out of the currently logged-in Tencent Cloud account in the browser
  3. Re-login: Tell the AI Login to CloudBase

In this way, you can switch to a new Tencent Cloud account.

How to Confirm the Current Environment​

Query current CloudBase environment information

🐛 Troubleshooting​

What to Do If Deployment Fails?​

Send the complete error information to the AI:

An error occurred, the error is xxxx

How to Debug Cloud Function Runtime Exceptions​

Have the AI view the logs and fix:

The cloud function code does not meet the requirements. The requirement is xxx. Please check the logs and data to debug, and fix it.

💬 Technical Discussion Group​

Encountered any issues or want to exchange experiences? Join our technical community!

🔥 WeChat Discussion Group​

WeChat Group QR Code
Scan the QR code to join the WeChat technical discussion group

Technical Support​

How to Get Help When Encountering Issues​

  1. Check the Frequently Asked Questions (FAQ)
  2. Submit issues on GitHub Issues
  3. Join the WeChat technical discussion group to obtain community support

How to Participate in the Community?​

  • Join the WeChat technical discussion group to share projects and exchange experiences
  • Star the project on GitHub and submit Issues or PRs
  • Follow the official documentation to obtain the latest feature updates