CloudBase AI Plugins
Plug CloudBase into your AI coding assistant in one step: it bundles the MCP Server and Agent Skills together, so once installed you can query databases, manage cloud functions, deploy hosting, and more — no separate configuration needed.
Compared with installing Skills alone, the plugin also ships Hooks and more, which makes Skill activation more reliable. Prefer the plugin.
Fastest start: copy the AI prompt below and paste it into your AI IDE.
Set up CloudBase for me, as follows:
1. Open https://docs.cloudbase.net/skill.md and follow the instructions to connect.
2. When you're done, tell me and suggest the most relevant next step.
Installation
Option 1: one-line install (recommended)
Install through the plugins CLI, which is compatible with the Open Plugin Specification and auto-detects the AI tools on your machine. Prefer this path over hand-writing MCP JSON.
Defaults to --scope user (global):
npx plugins add TencentCloudBase/cloudbase-plugin -y --scope user
# Sites plugin (optional)
npx plugins add TencentCloudBase/cloudbase-sites-plugin -y --scope user
Supported AI IDEs (npx plugins targets)
--target ID | AI IDE | Notes |
|---|---|---|
claude-code | Claude Code | ~/.claude |
cursor | Cursor | ~/.cursor |
codex | Codex | ~/.codex |
grok | Grok Build | ~/.grok (per-user only) |
kimi | Kimi Code | ~/.kimi-code (per-user only) |
github-copilot | GitHub Copilot CLI | ~/.copilot (the standalone copilot CLI, not gh copilot) |
vscode | Visual Studio Code | Agent plugins (Preview, per-user only) |
Without --target, the plugin installs into every detected target above. To see what was detected:
npx plugins targets
To install for a single tool:
npx plugins add TencentCloudBase/cloudbase-plugin -y --scope user --target cursor
Restart / reload the tool after installing.
When GitHub is unreachable (CNB mirror)
The owner/repo short name always resolves to GitHub. If git clone against GitHub fails, use the full CNB URL instead (synced by CI from the OPS artifacts, without marketplace metadata):
npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-plugin.git -y --scope user
# Sites plugin (optional)
npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-sites-plugin.git -y --scope user
Don't use the
CloudBase-AI-ToolKitmonorepo mirror fornpx plugins add: its marketplace layout differs from the OPS-dedicated repo, and the CLI may fail to install from it.
If the plugin still won't install, fall back to Skills via CNB or the npm MCP — see skill.md.
No git, or git cannot be installed
The plugins CLI runs git clone for owner/repo and for https:// URLs alike — CNB URLs are git too. On a machine without git, download the tarball over HTTPS and install from the local directory instead:
# Plugin: download → extract → install from the local directory
curl -L https://codeload.github.com/TencentCloudBase/cloudbase-plugin/tar.gz/refs/heads/main -o cloudbase-plugin.tgz
tar xzf cloudbase-plugin.tgz
npx plugins add ./cloudbase-plugin-main -y --scope user --target <target>
# Skills: an archive URL is downloaded and unpacked — no git either
npx skills add https://codeload.github.com/TencentCloudBase/cloudbase-skills/tar.gz/refs/heads/main -y
Three differences to know before you install:
--targetis required — without a detected client the CLI fails withNo supported targets detected- The marketplace is registered under the directory name
cloudbase-plugin-main, nottencent-cloudbase - There is no git repo behind it, so auto-update does not work — updating means downloading and reinstalling
Windows 10+ ships curl and tar. If you can install Git for Windows, do — future updates are simpler.
Option 2: install per client
For tools not in the targets list above, pick yours here — use the plugin marketplace where one exists, otherwise connect via the MCP config:
This client ships CloudBase built in. Setup follows its own marketplace or connectors, and the site follows your login state — nothing to pick here.
Configure your AI tool to connect with CloudBase capabilities. Supports local and remote connection. See connection modes.
Step 1: Install / Configure CloudBase
Install from the plugin marketplace (recommended)
1. In the Codex app, click the `+` button in the top right 2. Choose 添加插件市场 (Add plugin marketplace) 3. Fill in source `TencentCloudBase/CloudBase-MCP`, Git ref `main`, sparse path left empty 4. Once added, install the `cloudbase` plugin from the Tencent CloudBase marketplace 5. Start a new Codex thread so the plugin, skills and MCP tools load fully
Full steps: Codex setup guide.
Step 2: Chat with AI
Enter the following in your AI chat in order:
Read https://docs.cloudbase.net/skill.md and tell me what it can doUse CloudBase Skills: 配置 CloudBase 云函数的 HTTP 访问What's in the plugin
| Capability | Description |
|---|---|
| MCP Server | Environments, databases, cloud functions, hosting, storage, cloud hosting, authentication, permissions, logs, and more — see MCP tools |
| Agent Skills | Domain knowledge for the platform, Web / Mini Programs, cloud functions, auth, databases, AI models, UI, and more — see How to use Skills |