前置条件

• ✅ Node.js v18.15.0 及以上版本
• ✅ 已开通 腾讯云开发环境
• ✅ 安装支持 MCP 的 AI IDE（查看支持的 IDE）

🚀 快速开始

2. 一键部署（One-Click Deploy）

AI 自动化的 MCP 部署流，AI 帮你搞定从云函数、数据库到静态网站的所有云上资源配置。

提示词：部署当前项目到云开发
- 自动检测项目类型（Web/小程序/后端）
- 智能配置部署参数
- 实时显示部署进度
- 自动返回访问链接

<img width="1200" alt="One-Click Deploy" src="scripts/assets/cloudbase-mcp-card-02.png" />

📦 安装配置

安装

npm install @cloudbase/cli@latest -g

一行配置，立即使用

在支持 MCP 的 AI IDE 中（Cursor、WindSurf、CodeBuddy 等）添加下方任一配置即可。连接方式有两种：

---

方式一：本地模式（推荐）

含义：MCP 服务在你本机通过 npx 启动，与 IDE 同机运行。 优点：功能最全（包含上传/下载、模板安装等依赖本地文件系统的能力）。 要求：本机已安装 Node.js，且能执行 npx。

{
  "mcpServers": {
    "cloudbase": {
      "command": "npx",
      "args": ["@cloudbase/cloudbase-mcp@latest"]
    }
  }
}

---

方式二：托管模式

含义：MCP 服务运行在腾讯云上，IDE 通过 HTTP 连接云端服务，无需在本地安装或运行 Node。 优点：不依赖本机环境，配置好密钥即可使用。 限制：部分依赖本地文件系统的能力不可用（如本地文件上传、模板下载到本机等）。

将下面配置中的 <env_id>、<腾讯云 Secret ID>、<腾讯云 Secret Key> 替换为你的环境 ID 和腾讯云 API 密钥：

{
  "mcpServers": {
    "cloudbase": {
      "type": "http",
      "url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<env_id>",
      "headers": {
        "X-TencentCloud-SecretId": "<腾讯云 Secret ID>",
        "X-TencentCloud-SecretKey": "<腾讯云 Secret Key>"
      }
    }
  }
}

方式三：自建服务器部署（Cloud Mode）

含义：在自有服务器上运行 MCP 服务，通过环境变量 CLOUDBASE_MCP_CLOUD_MODE=true 启用云端模式。 适用场景：需要在远程服务器上自行部署 MCP 服务端，对外提供 Streamable HTTP 接口。 安全机制：启用 Cloud Mode 后，所有涉及本地文件系统读写和本地进程启动的工具将自动禁用，确保远程调用方无法操作服务器本地资源。

```bash

首次使用

1. 登录云开发

   登录云开发
   

2. 开始开发

   做一个双人在线对战五子棋网站，支持联机对战，最后进行部署
   

使用

tcb ai

#### 方式二：手动配置 MCP

根据你使用的 AI IDE，添加 MCP 配置：

<details>
<summary><b>Cursor</b></summary>

在 `.cursor/mcp.json` 中添加：

</details>

<details>
<summary><b>WindSurf</b></summary>

在 `.windsurf/settings.json` 中添加：

</details>

<details> <summary><b>CodeBuddy</b></summary>

CodeBuddy 已内置 CloudBase MCP，无需配置即可使用。

</details>

<details> <summary><b>其他 IDE</b></summary>

查看 完整配置指南 了解其他 IDE 的配置方式。

</details>

🎯 使用案例

案例 1：双人在线对战五子棋

开发过程： 1. 输入需求："做个双人在线对战五子棋网站，支持联机对战" 2. AI 生成：Web 应用 + 云数据库 + 实时数据推送 3. 自动部署并获得访问链接

体验地址： 五子棋游戏

<details> <summary>查看开发截图</summary>

</details>

案例 2：AI 宠物养成小程序

开发过程： 1. 输入："开发一个宠物小精灵养成小程序，使用 AI 增强互动" 2. AI 生成：小程序 + 云数据库 + AI 云函数 3. 导入微信开发者工具即可发布

<details> <summary>查看开发截图与小程序预览</summary>

![][image-case2]

</details>

案例 3：智能问题诊断

当应用出现问题时，AI 自动查看日志、分析错误并生成修复代码。

<details> <summary>查看智能诊断过程</summary>

![][image-case3]

</details>

启用云端模式的环境变量（二选一）

export CLOUDBASE_MCP_CLOUD_MODE=true

配置方式

方式一：CloudBase AI CLI（推荐）

```bash

只启用指定插件

https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&enable_plugins=env,database

禁用指定插件

https://tcb-api.cloud.tencent.com/mcp/v1?env_id=YOUR_ENV_ID&disable_plugins=rag,env

当前可配置的插件名以 `mcp/src/server.ts` 为准，建议优先使用 canonical 名称：`env`, `database`, `functions`, `hosting`, `storage`, `setup`, `rag`, `download`, `gateway`, `cloudrun`, `app-auth`, `permissions`, `logs`, `agents`, `invite-code`, `capi`, `apps`。

> [!TIP]
> **推荐使用 CloudBase AI CLI**
> 
> 一键安装，自动配置，支持多种 AI 编程工具：
> 
> 

6. 灵活工作流（Flexible Workflow）

支持 /spec 和 /no_spec 命令，根据任务复杂度智能选择。

/spec - 完整工作流（需求→设计→任务→实现）
/no_spec - 快速迭代（直接实现）

<img width="1200" alt="Flexible Workflow" src="scripts/assets/cloudbase-mcp-card-06.png" />

❓ 常见问题

<details> <summary><b>跟 Vercel / Railway / Netlify 有什么不同？</b></summary>

这些平台解决的是"部署"，CloudBase MCP 解决的是"从 AI 生成代码到部署上线"的完整链路。你不需要离开 IDE，不需要写配置文件，AI 自动帮你搞定云函数、数据库、CDN、域名等所有云资源。一句话：它们是部署工具，我们是 AI 原生的全栈开发+部署平台。

</details>

<details> <summary><b>不用 Cursor / Copilot 这些 AI IDE 也能用吗？</b></summary>

CloudBase MCP 基于标准 MCP 协议，支持所有兼容 MCP 的工具——包括 Claude Code、Gemini CLI、OpenCode 等命令行工具。只要你的工具能配置 MCP Server，就能用。查看完整支持列表。

</details>

<details> <summary><b>我的代码会被上传到哪里？安全吗？</b></summary>

代码只会部署到你自己的腾讯云开发环境，不经过任何第三方。本地模式下 MCP 服务运行在你本机，代码不会离开你的电脑直到你主动部署。所有云端通信均走 HTTPS 加密。

</details>

<details> <summary><b>在服务器上部署 MCP 服务是否安全？</b></summary>

CloudBase MCP 提供了完善的部署模式安全隔离机制：

• 本地模式（npx 启动）：MCP 服务运行在开发者本机，通过 stdio 与 AI IDE 通信。调用方就是开发者本人，拥有该机器的完整控制权。downloadRemoteFile、manageCloudRun(action="run") 等工具本质上等同于开发者在终端执行 curl 或 node app.js，这是产品的正常功能。
• 云端/服务器模式（设置 CLOUDBASE_MCP_CLOUD_MODE=true）：启用三层安全过滤机制，所有涉及本地文件读写、本地进程启动的工具均被禁用，远程调用方无法通过 MCP 操作服务器本地文件系统或启动本地进程。

如果你需要在远程服务器上自行部署 MCP 服务，务必设置 CLOUDBASE_MCP_CLOUD_MODE=true 环境变量。使用腾讯云托管模式（Streamable HTTP）时已自动启用该保护。

</details>

<details> <summary><b>支持哪些类型的项目？</b></summary>

几乎所有主流场景：React/Vue/Next.js 等 Web 应用、微信小程序、Node.js/Python/Go/Java 后端服务。AI 会自动检测项目类型并选择合适的部署策略（静态托管、云函数、云托管容器）。

</details>

<details> <summary><b>免费吗？需要付费吗？</b></summary>

CloudBase MCP 工具本身完全开源免费（MIT）。云开发环境有免费额度，个人开发和小项目通常够用。超出免费额度后按量计费，详见 计费说明。

</details>

<details> <summary><b>登录提示"环境不存在"怎么办？</b></summary>

1. 确认已在 云开发控制台 开通环境
2. 检查环境是否处于正常运行状态（非欠费/隔离）
3. 重新执行"登录云开发"让 AI 引导选择正确的环境

</details>