连接 CloudBase MCP
通过 Model Context Protocol (MCP) 连接后,你可以在 AI 对话中直接操作 CloudBase 服务,无需在 IDE 和控制台之间切换。
支持远端模式(推荐:IDE 通过 HTTP 连接云端,本机无需 Node)和本地模式(本机 npx 运行,含本地文件能力)。两种方式都区分国内站与国际站,接入前请先确认环境开在哪个站。详见 连接方式:远端模式与本地模式。
最快上手: 复制下面的 AI Prompt,粘贴到你的 AI IDE。
帮我把 CloudBase 接好,按下面做:
1. 打开 https://docs.cloudbase.net/skill.md,按说明完成接入。
2. 接入完成后告诉我,并建议最相关的下一步。
前置条件
在开始配置之前,请确保满足以下条件:
已准备好云开发环境(本地模式还需 Node.js)
云开发环境: 请参考文档 开通云开发环境。新用户可以免费开通体验。
Node.js 环境(仅本地模式需要): 远端模式不依赖本机 Node,可跳过这一项。本地模式需确保已安装 Node.js v18.15.0 或更高版本:
node --version
如果未安装,请从 Node.js 官网 下载安装。
连接你的 AI 工具
选择你的 AI 开发工具,然后按照安装说明操作:
该客户端已内置 CloudBase,接入方式以官方市场 / 连接器为准,站点跟随你的登录态,无需在此选择。
配置你的 AI 工具以连接 CloudBase 能力 支持本地与远端两种连接方式,详见 连接方式。
步骤 1:安装 / 配置 CloudBase
打开连接器:
使用内置连接器
1. 在 WorkBuddy 对话界面中,点击输入框左下角的 连接器 按钮 2. 在弹窗中找到 腾讯云 CloudBase,点击进入详情页,点击 连接 启用
启用后,即可在对话中直接使用 CloudBase 的各项能力。
使用快捷命令
在对话中直接输入 `/cloudbase` 选择 CloudBase Skill,然后输入需求即可。
配套专家
WorkBuddy 专家中心还有 4 个 CloudBase 专家,腾讯云 CloudBase 全栈工程师 最通用;其余 3 个见 WorkBuddy 配置指南。
步骤 2:和 AI 对话
在 AI 对话中依次输入以下内容:
阅读 https://docs.cloudbase.net/skill.md,帮我介绍可以做什么使用 CloudBase Skills: 帮我创建一个待办事项应用,使用 CloudBase 文档数据库存储数据手动确认工具调用
大多数 MCP 客户端(如 Cursor)会在执行每个工具调用前要求你手动确认。我们建议你始终启用此设置,并在执行前仔细查看工具调用的详细信息。
开始使用
配置完成后,在 AI 对话中输入:
登录云开发
AI 会自动引导你完成登录和环境选择。然后你可以开始使用自然语言描述需求,让 AI 帮你开发应用。
🌏 站点别选错:国内站与国际站是两套独立的账号体系,接入地址与登录态都不通用。接错站点的典型表现是**「登录成功但看不到自己的环境」**,而不是明确的报错。
- 远端模式:站点由域名决定 —— 国内站用
https://tcb-api.cloud.tencent.com/mcp/v1,国际站用https://tcb-api.tencentcloud.com/mcp/v1。- 本地模式:没有域名可依据,需显式声明
TCB_SITE=intl,否则登录会走国内站链路、看不到国际站环境。配置方式(MCPenv、启动参数--site、对话中指定、CLI)见 连接方式 - 国际站用户。国内站在
ap-singapore地域被误判为国际站的场景,见 常见问题。
使用示例
完整流程示例:
用云开发做一个带手机号登录的待办应用,并部署上线
AI 会自动完成:生成前后端代码、配置认证与数据库、部署云函数和静态托管,并返回访问链接。
分步操作示例:
- "用云开发做一个微信小程序点餐系统" - AI 搭页面、建云数据库、写云函数并引导预览
- "做一个预约管理系统,支持用户下单和后台改状态" - AI 用 CloudBase PostgreSQL 建模、配权限并接好前后端
- "给 Web 应用加上手机号登录" - AI 启用认证方式并接入 CloudBase SDK
详细需求示例:
用云开发做一个咖啡预约小程序,包含:
- 菜单浏览与下单
- 订单写入云数据库
- 云函数处理订单状态
- 用微信开发者工具预览
AI Skill 场景
数据库
后端开发
应用集成
AI
视频教程
想通过视频学习如何使用 CloudBase MCP?查看我们的视频教程和实战案例。