Skip to main content

CodeBuddy Code Setup Guide

CodeBuddy Code can install the CloudBase plugin (MCP + Skills) via the plugin marketplace, then use CloudBase CLI to complete environment login. After setup, you can operate CloudBase services directly from the CLI chat.

Examples:

  • "Build a WeChat Mini Program ordering system with CloudBase" — AI scaffolds pages, creates the cloud database, writes cloud functions, and guides preview
  • "Build a reservation management system that lets users place orders and admins update status" — AI models it with CloudBase PostgreSQL, configures permissions, and wires up frontend and backend
  • "Add phone-number login to a Web app" — AI enables the auth method and integrates the CloudBase SDK

No need to switch to the Cloud console — you can do everything from the CLI with natural language.

Prerequisites​

Before you start, make sure you have:

Node.js and a CloudBase environment ready

Node.js: Install Node.js v18.15.0 or later:

node --version

If you don't have it installed, download it from the Node.js website.

CloudBase environment: See Create a CloudBase environment. New users can start for free.

The plugin marketplace installs both MCP tools and AI Skills in one step, giving you the full feature set.

# Add the CloudBase plugin marketplace
codebuddy plugin marketplace add TencentCloudBase/CloudBase-AI-Toolkit

# Install the CloudBase plugin
codebuddy plugin install cloudbase@tencent-cloudbase

The full marketplace URL is:

https://github.com/TencentCloudBase/CloudBase-AI-Toolkit

After installation, open a new session to ensure the plugin loads completely. For the GUI version, see the CodeBuddy Setup Guide.

Log in to CloudBase​

No pre-configuration needed. Start a conversation in CodeBuddy Code and follow the prompts to complete Device Login.

🌏 International site users: when your environment is in the Tencent Cloud international site, declare the site first, otherwise login goes to the China-site authorization page. Add "TCB_SITE": "intl" to the MCP config env (or use the --site intl startup flag), restart, then log in. See Connection Modes - International site users.

Without a Tencent Cloud account (API Key)​

# Install CloudBase CLI
npm i -g @cloudbase/cli

# International site users: run `tcb config set isIntl true` first (or set TCB_IS_INTL=true) to switch to the international-site path
# Log in with an environment API Key (environment ID is also required)
tcb login --cloudbase-api-key <cloudbaseApiKey> -e <cloudbaseEnvId>

💡 API Keys can be created and managed in the CloudBase Console under environment settings (if you have admin permissions).

⚠️ Do not commit API Keys to your code repository.

Option 2: Connect via MCP Configuration​

If you only need the MCP tool connection, you can configure it manually:

Client

Configure your AI tool to connect with CloudBase capabilities. Supports local and hosted connection. See connection modes.

Step 1: Install / Configure CloudBase

Use project template (recommended) - Template includes MCP configuration and AI rulesView templates

CLI command:

codebuddy mcp add --scope project cloudbase --env INTEGRATION_IDE=CodeBuddyCode -- npx @cloudbase/cloudbase-mcp@latest

或者将以下配置添加到 .mcp.json:

Or manual configuration:

或者将以下配置添加到 .mcp.json:

json
1{
2  "mcpServers": {
3    "cloudbase": {
4      "type": "stdio",
5      "command": "npx",
6      "args": ["@cloudbase/cloudbase-mcp@latest"],
7      "env": {
8        "INTEGRATION_IDE": "CodeBuddyCode"
9      }
10    }
11  }
12}
Need help?View CodeBuddy Code docs

Step 2: Chat with AI

Enter the following in your AI chat in order:

prompt
Read https://docs.cloudbase.net/skill.md and tell me what it can do
Use CloudBase Skills: 创建一个 Node.js 后端服务，使用 CloudBase Auth 进行用户认证

FAQ​

Q: Do I still need API Key login if I have a Tencent Cloud account? A: No. Just follow the prompts to complete Device Login when chatting.

Q: MCP connection failed? A: Check your .mcp.json format, ensure npx is available, restart CodeBuddy Code, and make sure you have completed login.

Q: Tool count shows 0? A: See the FAQ.

More: FAQ

相关资源