Skip to main content

Connect to CloudBase MCP

After connecting via the Model Context Protocol (MCP), you can operate CloudBase services directly in your AI chat—no need to switch between your IDE and the console.

CloudBase MCP supports Remote Mode (recommended: your IDE connects to the cloud over HTTP, with no local Node.js dependency) and Local Mode (run via npx on your machine, including local-file capabilities). Both modes distinguish between the China site and the International site, so confirm where your environment was created before connecting.

See Connection Modes: Remote vs Local.

Fastest start: Copy the AI Prompt below into your AI IDE.

Help me get set up with CloudBase. Do the following:
1. Open https://docs.cloudbase.net/skill.md and follow the instructions.
2. When done, tell me you're ready and suggest the most relevant next steps.

Prerequisites​

Before you start, make sure you have:

A CloudBase environment ready (plus Node.js for Local Mode)

CloudBase environment: Follow the doc Create a CloudBase environment. New users can start for free.

Node.js (Local Mode only): Remote Mode does not depend on local Node.js, so you can skip this requirement. For Local Mode, install Node.js v18.15.0 or later:

node --version

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

Connect Your AI Tool​

Pick your AI development tool and follow the setup guide:

Client

This client ships CloudBase built in. Setup follows its own marketplace or connectors, and the site follows your login state — nothing to pick here.

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

Step 1: Install / Configure CloudBase

Open connector:

Open in WorkBuddy

Use the built-in connector

1. In the WorkBuddy conversation interface, click the Connect App button at the bottom left of the input box 2. Find Tencent CloudBase in the popup, click to enter the detail page, and click Connect to enable

Once enabled, you can use CloudBase capabilities directly in the conversation.

Use the slash command

Type `/cloudbase` in a conversation to pick the CloudBase Skill, then describe what you need.

Bundled experts

WorkBuddy expert center ships four CloudBase experts; Full-Stack Engineer covers the most ground, and the other three are listed in the WorkBuddy setup guide.

Need help?View WorkBuddy 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: 帮我通过 HTTP API 调用 CloudBase 服务

Manually Confirm Tool Calls​

Most MCP clients (e.g. Cursor) will ask you to manually confirm every tool call. We recommend keeping this enabled and carefully reviewing the tool call details before execution.

Start Using It​

After setup, type in your AI chat:

Log in to CloudBase

Your AI will guide you through login and environment selection. Then you can start describing requirements in natural language and let the AI build your app.

🌏 Choose the correct site: the China site and the International site use separate account systems, endpoints, and login states. The typical symptom of choosing the wrong site is “login succeeded, but my environment is missing”, not an explicit error.

  • Remote Mode: the hostname determines the site — use https://tcb-api.cloud.tencent.com/mcp/v1 for the China site and https://tcb-api.tencentcloud.com/mcp/v1 for the International site.
  • Local Mode: there is no hostname to infer the site from, so International-site users must explicitly set TCB_SITE=intl; otherwise login uses the China-site flow and the International-site environment is not visible. For all configuration methods (MCP env, --site startup flag, conversation-level selection, and CLI), see Connection Modes - International site users.

For the case where a China-site environment in the ap-singapore region is misdetected as international, see FAQ.

Examples​

End-to-end example:

Build a todo app with phone-number login using CloudBase, and deploy it

The AI can automatically: generate frontend and backend code, configure auth and the database, deploy cloud functions and static hosting, and return an access link.

Step-by-step 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

Detailed requirement example:

Build a coffee reservation Mini Program with CloudBase that includes:
- Menu browsing and ordering
- Writing orders to the cloud database
- Cloud functions to handle order status
- Preview in WeChat DevTools

AI Skill Scenarios​

身份认证

身份认证：配置管理
配置管理认证提供商
身份认证：Web SDK
Web SDK 身份认证
身份认证：微信小程序
微信小程序身份认证
身份认证：App 集成
Android、iOS 原生应用
身份认证：Node.js 服务端
Node.js 服务端身份认证

数据库

文档数据库：Web SDK
Web SDK 文档数据库
文档数据库：小程序 SDK
小程序 SDK 文档数据库
关系型数据库：工具与规则
MySQL 关系型数据库
关系型数据库：Web SDK
Web SDK 关系型数据库
数据库：数据模型创建
复杂数据模型设计
数据库：App 集成
Android、iOS 原生应用
关系型数据库：PostgreSQL
PostgreSQL 开发与调试
PostgreSQL：设计与性能最佳实践
PostgreSQL 设计与性能优化

后端开发

后端开发：云函数
Node.js 云函数
后端开发：云托管
Node.js、Python、Go、Java 等
后端开发：声明式部署
cloudbaserc 声明式部署
后端开发：Cloud API 操作
管控面 API 调用与 CAM 授权

应用集成

应用集成：Web 应用
React、Vue、Vite、浏览器验证
应用集成：最小 Web BaaS Demo
Lovable-like 最小前后端，Web SDK CRUD 优先
应用集成：微信小程序
小程序开发、tabBar、CloudBase
应用集成：微信生态集成
微信支付、公众号 OAuth
应用集成：UI 设计
专业界面设计指南
应用集成：App 集成
Android、iOS 原生应用
应用集成：云存储（Web SDK）
Web SDK 云存储

AI

在 Web 应用中集成 AI 功能
在 Web 应用中调用 AI
在 Node.js 后端中集成 AI 功能
在后端服务中调用 AI
在微信小程序中集成 AI 功能
在小程序中调用 AI
在应用中集成 AI Agent
Agent 服务构建与部署

开发工具

开发工具：Spec 工作流
需求分析、技术设计、任务拆分
开发工具：CloudBase 平台
平台知识库和最佳实践
开发工具：CloudBase CLI
tcb 命令行资源管理
开发工具：CloudBase MCP
MCP 连接方式与开源贡献
开发工具：代码审查
项目落地检查与常见坑
开发工具：环境巡检与诊断
环境巡检、告警与故障诊断

Video Tutorials​

Want to learn CloudBase MCP via videos? See tutorials and practical cases.