跳到主要内容

CloudBase AI 插件

一键把 CloudBase 接入 AI 编程助手：同时捆绑 MCP Server 与 Agent Skills，安装后即可查库、管云函数、部署托管等，无需再分别配置。

相比单独装 Skills，插件还带上 Hooks 等能力，Skill 激活更稳定，推荐优先用插件。

安装​

方式 1：一键安装（推荐）​

通过兼容 Open Plugin Specification 的 plugins CLI 安装，会自动检测本机 AI 工具。优先用这条路径，不要手写 MCP JSON。

默认 --scope user（全局）：

npx plugins add TencentCloudBase/cloudbase-plugin -y --scope user

# Sites 插件（可选）
npx plugins add TencentCloudBase/cloudbase-sites-plugin -y --scope user

支持的 AI IDE（npx plugins targets）​

--target IDAI IDE说明
claude-codeClaude Code~/.claude
cursorCursor~/.cursor
codexCodex~/.codex
grokGrok Build~/.grok（仅 per-user）
kimiKimi Code~/.kimi-code（仅 per-user）
github-copilotGitHub Copilot CLI~/.copilot（独立 copilot CLI，不是 gh copilot）
vscodeVisual Studio CodeAgent plugins（Preview，仅 per-user）

不写 --target 时，会安装到本机所有已检测到的上述目标。查看检测结果：

npx plugins targets

只装某一个工具时：

npx plugins add TencentCloudBase/cloudbase-plugin -y --scope user --target cursor

安装后重启 / reload 对应工具即可。

Agent 总入口（决策树 + 验收）：https://docs.cloudbase.net/skill.md

Claude Code / Codex 的原生 marketplace 请用主仓库 TencentCloudBase/CloudBase-MCP；cloudbase-plugin 仓库由 CI 同步 OPS 标准内容，不含 marketplace 元数据。

⚠️ 已通过方式 2（claude plugin install / codex plugin add 等）安装过时，不要再对同一 IDE 执行 npx plugins add，以免重复实例。二选一即可。

GitHub 不可达时（CNB 镜像）​

owner/repo 短名会固定解析到 GitHub。若 git clone GitHub 失败，改用 完整 CNB URL（由 CI 从 OPS 产物同步，不含 marketplace 元数据）：

npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-plugin.git -y --scope user

# Sites 插件（可选）
npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-sites-plugin.git -y --scope user

不要用 monorepo 镜像 CloudBase-AI-ToolKit 做 npx plugins add：其 marketplace 结构与 OPS 专用仓不同，CLI 可能装不上。

若插件仍无法安装，可退回 Skills CNB 或 npm MCP，见 skill.md。

方式 2：按 IDE 手动安装​

适用于 CodeBuddy、WorkBuddy、ZCode，或希望走 IDE 原生插件机制的场景：

  1. 在 Codex App 右上角点 + → 添加插件市场
  2. 来源填 TencentCloudBase/CloudBase-MCP，Git 引用 main，稀疏路径留空
  3. 在 Tencent CloudBase 市场中安装 cloudbase
  4. 新开线程验证

其他 IDE​

不走 marketplace 的工具（Cursor、WindSurf、CodeBuddy 等）可配置 MCP + Skills。选择你的工具查看步骤：

Client

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

步骤 1：安装 / 配置 CloudBase

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

一键安装:

Add to Cursor

或手动配置:

将以下配置添加到项目目录下的 .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 控制台帮我配置短信登录方式

CodeBuddy / WorkBuddy / ZCode 尚未实现 Open Plugin Specification，因此暂不支持 npx plugins 一键安装，需用各自原生路径。

插件里有什么​

能力说明
MCP Server环境、数据库、云函数、托管、存储、云托管、认证、权限、日志等，详见 MCP 工具
Agent Skills平台、Web / 小程序、云函数、认证、数据库、AI 模型、UI 等专业知识，详见 如何使用 Skill

相关文档​