连接 CloudBase MCP
通过 Model Context Protocol (MCP) 连接后,你可以在 AI 对话中直接操作 CloudBase 服务,无需在 IDE 和控制台之间切换。
支持本地模式(本机 npx 运行)和托管模式(HTTP 连接云端)。本地模式可配置环境变量,托管模式可通过 URL 控制插件。详见 连接方式:本地模式与托管模式。
前置条件
在开始配置之前,请确保满足以下条件:
已准备好Node.js 环境和云开发环境
Node.js 环境: 确保已安装 Node.js v18.15.0 或更高版本:
node --version
如果未安装,请从 Node.js 官网 下载安装。
云开发环境: 请参考文档 开通云开发环境。新用户可以免费开通体验。
连接你的 AI 工具
选择你的 AI 开发工具,然后按照安装说明操作:
Client
配置你的 AI 工具以连接 CloudBase 能力 支持本地与托管两种连接方式,详见 连接方式。
步骤 1:安装 / 配置 CloudBase
使用项目模板(推荐) - 模板已内置 MCP 配置和 AI 规则查看模板
一键安装:
或手动配置:
将以下配置添加到项目目录下的 .cursor/mcp.json:
json
1{2 "mcpServers": {3 "cloudbase": {4 "command": "npx",5 "args": ["@cloudbase/cloudbase-mcp@latest"],6 "env": {7 "INTEGRATION_IDE": "Cursor"8 }9 }10 }11}需要帮助?查看 Cursor 文档
步骤 2:和 AI 对话
在 AI 对话中依次输入以下内容:
prompt
安装 CloudBase Skills:命令 npx skills add tencentcloudbase/cloudbase-skills -y使用 CloudBase Skills: 帮我创建一个待办事项应用,使用 CloudBase 文档数据库存储数据手动确认工具调用
大多数 MCP 客户端(如 Cursor)会在执行每个工具调用前要求你手动确认。我们建议你始终启用此设置,并在执行前仔细查看工具调用的详细信息。
开始使用
配置完成后,在 AI 对话中输入:
登录云开发
AI 会自动引导你完成登录和环境选择。然后你可以开始使用自然语言描述需求,让 AI 帮你开发应用。
使用示例
完整流程示例:
用云开发做一个带手机号登录的待办应用,并部署上线
AI 会自动完成:生成前后端代码、配置认证与数据库、部署云函数和静态托管,并返回访问链接。
分步操作示例:
- "用云开发做一个微信小程序点餐系统" - AI 搭页面、建云数据库、写云函数并引导预览
- "做一个预约管理系统,支持用户下单和后台改状态" - AI 用 CloudBase PostgreSQL 建模、配权限并接好前后端
- "给 Web 应用加上手机号登录" - AI 启用认证方式并接入 CloudBase SDK
详细需求示例:
用云开发做一个咖啡预约小程序,包含:
- 菜单浏览与下单
- 订单写入云数据库
- 云函数处理订单状态
- 用微信开发者工具预览
AI Skill 场景
身份认证
数据库
应用集成
视频教程
想通过视频学习如何使用 CloudBase MCP?查看我们的视频教程和实战案例。