CodeBuddy 配置指南

CodeBuddy 可通过 插件市场 安装 CloudBase 插件（MCP + Skills），再配合 CloudBase CLI 完成环境登录。配置后，你可以在 CodeBuddy 的 AI 对话中直接操作 CloudBase 服务。

例如：

"用云开发做一个微信小程序点餐系统" - AI 搭页面、建云数据库、写云函数并引导预览
"做一个预约管理系统，支持用户下单和后台改状态" - AI 用 CloudBase PostgreSQL 建模、配权限并接好前后端
"给 Web 应用加上手机号登录" - AI 启用认证方式并接入 CloudBase SDK

无需切换到云控制台，所有操作都可以在 CodeBuddy 中用自然语言完成。

前置条件

在开始配置之前，请确保满足以下条件：

已准备好 Node.js 环境和云开发环境

Node.js 环境： 确保已安装 Node.js v18.15.0 或更高版本：

node --version

如果未安装，请从 Node.js 官网下载安装。

云开发环境： 请参考文档开通云开发环境。新用户可以免费开通体验。

方式一：通过插件市场安装（推荐）

插件市场方式会同时安装 MCP 工具和 AI Skills，一次安装即可获得完整能力。

1. 添加 CloudBase 插件市场

打开 CodeBuddy 的 插件市场 页面
选择 添加市场源（或等价入口）
填入市场源地址：

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

添加成功后，市场列表中会出现 Tencent CloudBase。

2. 安装 CloudBase 插件

在刚添加的市场中，安装 cloudbase 插件并启用。

若你使用的是 CodeBuddy Code（CLI），也可用命令完成同样步骤：

# 添加 CloudBase 插件市场
codebuddy plugin marketplace add TencentCloudBase/CloudBase-AI-Toolkit

# 安装 CloudBase 插件
codebuddy plugin install cloudbase@tencent-cloudbase

安装后建议新开对话或重启 CodeBuddy，确保插件、Skills 与 MCP 工具完整加载。

命令行版更多说明见 CodeBuddy Code 配置指南。

登录云开发环境

安装插件后，还需要完成 CloudBase 环境鉴权。按你是否有腾讯云账号选择对应方式：

已有腾讯云账号（推荐）

无需预先配置 CLI。直接在 CodeBuddy 里开始对话，系统会提示完成 Device 登录（设备码授权），按页面提示授权即可。

🌏 国际站用户：环境开通在腾讯云国际站时，需先声明站点，否则登录会走国内站授权页。在 MCP 配置的 env 中加入 "TCB_SITE": "intl"（或使用启动参数 --site intl），重启 CodeBuddy 后再登录。详见连接方式 - 国际站用户。

没有腾讯云账号（API Key）

若你只有环境级 API Key（例如由合作方/管理员下发），请先安装 CloudBase CLI，再用 API Key 登录：

# 安装 CloudBase CLI
npm i -g @cloudbase/cli

# 国际站用户请先执行 tcb config set isIntl true（或设置环境变量 TCB_IS_INTL=true）切换到国际站链路
# 使用环境 API Key 登录（必须同时指定环境 ID）
tcb login --cloudbase-api-key <cloudbaseApiKey> -e <cloudbaseEnvId>

💡 API Key 可在云开发控制台的环境设置中创建和管理（有管理权限时）。

⚠️ API Key 具有环境级操作权限，请妥善保管；不要把密钥提交到代码仓库或截图外传。

登录成功后，即可在对话中使用 CloudBase 能力。

CodeBuddy IDE 内置集成

CodeBuddy IDE 用户也可以直接在设置页 / 集成中点击 Tencent CloudBase 管理按钮并授权，走内置集成，无需手动配置 MCP。

详见 CodeBuddy BaaS 集成文档。

方式二：通过 MCP 市场或手工配置

如果只需要 MCP 工具连接，也可以：

点击 CodeBuddy 右上角的 MCP 按钮
在 MCP 市场中搜索 CloudBase 并安装

或手工写入 MCP 配置：

Client

配置你的 AI 工具以连接 CloudBase 能力支持本地与托管两种连接方式，详见连接方式。

步骤 1：安装 / 配置 CloudBase

使用项目模板（推荐） - 模板已内置 MCP 配置和 AI 规则查看模板

推荐：CodeBuddy IDE 已内置集成 CloudBase MCP，建议优先使用配置集成方式。查看 BaaS 集成文档。如需手动配置 MCP，请参考下方配置。

在 MCP 配置中增加如下配置

json

1{
2  "mcpServers": {
3    "cloudbase": {
4      "command": "npx",
5      "args": ["@cloudbase/cloudbase-mcp@latest"],
6      "env": {
7        "INTEGRATION_IDE": "CodeBuddyManual"
8      }
9    }
10  }
11}

需要帮助？查看 CodeBuddy 文档

步骤 2：和 AI 对话

在 AI 对话中依次输入以下内容:

prompt

阅读 https://docs.cloudbase.net/skill.md，帮我介绍可以做什么

使用 CloudBase Skills：在 CI 脚本里用 CloudBase CLI 完成一次批量部署发布

常见问题

Q: 有腾讯云账号还需要 tcb login --cloudbase-api-key 吗？
A: 不需要。直接对话，按提示完成 Device 登录即可。API Key 登录主要用于没有腾讯云账号、仅持有环境 API Key 的场景。

Q: 插件市场添加失败？
A: 确认市场源为 https://github.com/TencentCloudBase/CloudBase-AI-Toolkit，检查网络能否访问 GitHub；必要时重试或改用内置集成 / MCP 市场。

Q: MCP 连接失败？
A: 检查配置文件格式是否正确，重启 CodeBuddy，确认网络连接正常，并确认已完成 Device 登录或 API Key 登录。

Q: 工具数量显示为 0？
A: 请参考常见问题。

更多问题请查看：完整 FAQ

前置条件​

方式一：通过插件市场安装（推荐）​

1. 添加 CloudBase 插件市场​

2. 安装 CloudBase 插件​

登录云开发环境​

已有腾讯云账号（推荐）​

没有腾讯云账号（API Key）​

CodeBuddy IDE 内置集成​

方式二：通过 MCP 市场或手工配置​