AI writes the code. CloudBase runs the backend. The CloudBase integration layer for AI coding tools: Plugin installs the stack, Skills steer how code is written, MCP operates databases, functions, storage, and deploys from chat.
> /plugin marketplace add TencentCloudBase/CloudBase-AI-Toolkit
Repo: TencentCloudBase/CloudBase-AI-Toolkit
What's inside
AI writes the code. CloudBase runs the backend.
The CloudBase integration layer for AI coding tools: Plugin installs the stack, Skills steer how code is written, MCP operates databases, functions, storage, and deploys from chat.
English ยท ็ฎไฝไธญๆ ยท Docs ยท Changelog ยท Issues
v2.25.x (2026-08)
minimal-web-baas-demo to searchKnowledgeBase skill guidance for minimal Web+database demos without cloud-function CRUD (#886)cloudbase-mcp --cloud-mode crash from a cloud-modeโlogger circular dependency (#879)tcb policy (modifyEnvAuthzConfig) when ModifyResourcePermission is unsupported (#865)upstreamResourceType and path transmissiongetPrivilege / enableService / authSwitch); SMS login works out of the box via the default channelReleases ยท Star ยท Watch โ Releases
AI IDEs (Cursor, Claude Code, Codex, CodeBuddy, and others) are strong at generating code. What usually blocks you is the backend: schemas, permissions, functions, storage, environments, and release.
CloudBase is Tencent Cloudโs AI-native all-in-one backend (database, storage, auth, cloud functions, Cloud Run, and more). This repo is the Toolkit that connects that backend to AI tools:
| Piece | Role |
|---|---|
| Plugin | Installs MCP Server, Agent Skills, and Hooks togetherโless per-IDE wiring |
| Agent Skills | Scenario skills (Web / Mini Program / database / auth / functions, etc.) toward workable CloudBase practice |
| MCP | Login, query and change data, manage functions and hosting, read logsโfrom the conversation |
This repository ships the npm package @cloudbase/cloudbase-mcp, Skills, and AI plugins.
You still need your own CloudBase environment, and you should confirm sensitive actions the AI proposes. The Toolkit provides capability and pathโnot judgment.
Publishing and sync repos live under TencentCloudBase. Directly related to this Toolkit:
| Repository | Contents | Typical entry |
|---|---|---|
| CloudBase-AI-Toolkit (this repo) | MCP Server source; marketplace source for Claude Code / Codex | npx @cloudbase/cloudbase-mcp@latest |
| cloudbase-plugin | Open Plugin Spec publish repo (CI-synced): MCP + Skills + Hooks | npx plugins add TencentCloudBase/cloudbase-plugin ยท CNB fallback: npx plugins add https://cnb.cool/tencent/cloud/cloudbase/cloudbase-plugin.git |
| cloudbase-sites-plugin | Sites plugin: Vite Web create & deploy | npx plugins add TencentCloudBase/cloudbase-sites-plugin ยท CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-sites-plugin.git |
| cloudbase-skills | Agent Skills collection | npx skills add TencentCloudBase/cloudbase-skills ยท CNB: https://cnb.cool/tencent/cloud/cloudbase/cloudbase-skills.git |
| skills | Per-skill install catalog (also on skills.sh) | npx skills add tencentcloudbase/skills --skill <name> |
| awesome-cloudbase-examples | CloudBase examples and case studies | Browse / clone examples |
| OpenVibeCoding | Vibecoding template on CloudBase | Use as a project starter |
Prefer Plugin for the full stack; Skills alone when you only need knowledge constraints. For marketplace IDEs use this repoโdo not also run npx plugins add on the same tool.
Pick one default path for your tool.
| Your tool | Suggested path |
|---|---|
| Claude Code / Codex (native marketplace) | Add this repo as marketplace, then install the cloudbase plugin (plugin docs) |
| Open Plugin Spec tools | npx plugins add TencentCloudBase/cloudbase-plugin |
| Prefer one CLI for many tools | CloudBase AI CLI: npm i -g @cloudbase/cli && tcb ai |
| CodeBuddy / WorkBuddy / ZCode (built-in) | Use the IDEโs built-in CloudBase plugin or connector; for CodeBuddy you can also install via plugin marketplace |
| Other MCP-capable IDEs | MCP config only (below) |
npx plugins add TencentCloudBase/cloudbase-plugin
Details and IDE differences: AI plugin docs.
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"]
}
}
}
Hosted HTTP, self-hosted Cloud Mode, and plugin scoping: Install & connect.
Login to CloudBase
Use CloudBase Skills to build a todo app with login, database and permissions, then deploy
Skills shape structure and practice; MCP handles environment and resources. You should be able to verify data and APIs in your own environmentโnot only get local source files.
| Tool | Platform | Guide |
|---|---|---|
| CloudBase AI CLI | CLI | Guide |
| OpenClaw | CLI | Guide |
| WorkBuddy | Standalone IDE | Guide |
| ZCode | Standalone IDE (โฅ 3.4.1 built-in) | Guide |
| Codex App | App | Guide |
| Cursor | Standalone IDE | Guide |
| WindSurf | IDE / plugins | Guide |
| CodeBuddy | Standalone IDE (built-in) | Guide |
| CLINE | VS Code plugin | Guide |
| GitHub Copilot | VS Code plugin | Guide |
| Trae | Standalone IDE | Guide |
| Tongyi Lingma | IDE / plugins | Guide |
| RooCode | VS Code plugin | Guide |
| Baidu Comate | Plugins | Guide |
| Augment Code | Plugins | Guide |
| Claude Code | CLI | Guide |
| Gemini CLI | CLI | Guide |
| Codex CLI | CLI | Guide |
| OpenCode | CLI | Guide |
| Qwen Code | CLI | Guide |
Full setup: IDE guides.
After setup, the AI can do typical backend work in your environment (confirm critical steps):
Fits Web, WeChat Mini Programs, and backend services. Platform overview: CloudBase docs.
Under controlled conditions, the same Todo application brief and frontend scaffold were used to compare two backend paths: a traditional cloud VM (self-managed runtime, process, and network exposure) and CloudBase (managed database, anonymous auth, and related backend services). An AI agent performed end-to-end development and verification. Given the model and task setup, the CloudBase path was more favorable in completion latency, token usage, and tool-call count. These outcomes are conditioned on the model, agent framework, and task definition, and should not be generalized beyond that scope.
Methods, data, and limits: Same-task evaluation: cloud VM vs CloudBase
npx plugins add TencentCloudBase/cloudbase-pluginnpm i -g @cloudbase/cli && tcb ai{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"]
}
}
}
{
"mcpServers": {
"cloudbase": {
"command": "npx",
"args": ["@cloudbase/cloudbase-mcp@latest"]
}
}
}
CloudBase is built in (MCP / Skills); manual config is usually unnecessary.
You can also install via the plugin marketplace: see the CodeBuddy setup guide.
Others: IDE setup guide.
Local (default): npx on your machineโfull features, including local filesystem upload/templates.
Hosted: IDE connects over HTTP to Tencent Cloud MCP; no local Node. Some local-file features are unavailable.
{
"mcpServers": {
"cloudbase": {
"type": "http",
"url": "https://tcb-api.cloud.tencent.com/mcp/v1?env_id=<env_id>",
"headers": {
"X-TencentCloud-SecretId": "<Tencent Cloud Secret ID>",
"X-TencentCloud-SecretKey": "<Tencent Cloud Secret Key>"
}
}
}
}
Hosted URLs can use enable_plugins / disable_plugins. Canonical names live in mcp/src/server.ts.
Self-hosted Cloud Mode: set CLOUDBASE_MCP_CLOUD_MODE=true (or MCP_CLOUD_MODE=true) so local file and process tools are disabled for remote callers.
| Scenario | Suggestion |
|---|---|
| Personal | Local npx |
| Team / zero ops | Hosted HTTP |
| Self-hosted MCP | Cloud Mode required |
Online Gomoku: describe the need; get Web + cloud database / realtime and deploy.
Demo: Gomoku ยท More: tutorials
Those focus on shipping frontends or containers. CloudBase provides backend building blocks (database, auth, functions). The Toolkit lets AI tools use them in chat. Deploy is only part of the path.
Yes. Any tool that can configure an MCP Server or install the matching Plugin / Skills worksโincluding Claude Code, Gemini CLI, OpenCode. Support list
Deploy targets your own CloudBase environment. In local mode MCP runs on your machine; code need not leave until you deploy. Cloud traffic uses HTTPS.
Local npx is equivalent to running tools yourself. For remote hosts, set CLOUDBASE_MCP_CLOUD_MODE=true to disable local file/process tools. Tencent Cloud hosted HTTP includes this protection.
The Toolkit (including MCP) is open source under MIT. CloudBase has free quotas; usage beyond that is billedโsee billing.
Confirm an environment exists and is healthy in the console, then login again and pick the right one.
| Docs | docs.cloudbase.net |
| Issues | GitHub Issues |
| Releases | Changelog |
.agents/
plugins/
marketplace.json
skills/
api-contract-review
doc-freshness-review
docs-workflows
git-workflows
manage-local-skills
mcp-attribution-worktree
planning-workflows
review-automation-orchestrator
skill-authoring
.claude/
.claude-plugin/
marketplace.json
plugin.json
settings.local.json
skills/
api-contract-review
doc-freshness-review
manage-local-skills
mcp-attribution-worktree
review-automation-orchestrator
skill-authoring
.codebuddy/
.DS_Store
artifacts/
doc-freshness-review-2026-04-09.md
final-copy-proposal.md
final-readme-proposal.md
release-note-v2.17.0.md
steve-jobs-apple-perspective-review.md
steve-jobs-review.md
tech-style-review.md
automations/
automation/
memory.md
mcp/
memory.md
settings.local.json
skills/
api-contract-review
doc-freshness-review
docs-workflows
git-workflows
manage-local-skills
mcp-attribution-worktree
planning-workflows
review-automation-orchestrator
skill-authoring
worktrees/
.DS_Store
.cursor/
.cursor-plugin/
marketplace.json
plans/
auth-flow-review-plan_bfbeb6cc.plan.md
auth-tool-simplification_92430c80.plan.md
rules/
project.mdc
.github/
ISSUE_TEMPLATE/
ai_ide_support.md
bug_report.md
config.yml
discussion.md
feature_request.md
workflows/
ai-dev.yaml
build-zips.yml
compat-check.yml
crawl-docs.yml
issue-auto-processor-simple.yml
nightly-build.yaml
npm-publish.yaml
npm-tarball-smoke.yaml
open-plugin-spec-check.yml
publish-clawhub-registry.yml
push-allinone-skill.yml
push-plugin-repos.yaml
push-skills-repo.yaml
stale.yml
static.yml
sync-branch.yml
sync-claude-skills-mirror.yml
sync-cloudbase-plugin-skills.yml
sync-derived-branches.yml
sync-main-to-examples.yml
sync-to-cnb.yml
.gitignore
.husky/
pre-commit
.npmrc
.versionrc
.vscode/
launch.json
settings.json
tasks.json
.workbuddy/
expert-history.json
memory/
2026-03-31.md
2026-04-01.md
2026-04-07.md
2026-04-08.md
2026-04-09.md
2026-05-13.md
2026-05-14.md
2026-05-15.md
MEMORY.md
plans/
fix-compat-baseline_dd18e467.md
narrow-compat-baseline-check_b64333fc.md
skills/
docs-workflows
git-workflows
manage-local-skills
mcp-attribution-worktree
planning-workflows
skill-authoring
AGENTS.md
CHANGELOG.md
CLAUDE.md
cloudbaserc.json
CODE_OF_CONDUCT.md
CODEBUDDY.md
config/
.claude/
skills/
ai-model-nodejs/
SKILL.md
ai-model-web/
SKILL.md
ai-model-wechat/
SKILL.md
auth-nodejs-cloudbase/
SKILL.md
auth-tool-cloudbase/
checklist.md
references/
extended-guide.md
SKILL.md
auth-web-cloudbase/
references/
extended-guide.md
SKILL.md
auth-wechat-miniprogram/
references/
extended-guide.md
SKILL.md
cloud-functions/
checklist.md
references/
references.md
event-functions.md
http-function-credentials.md
http-functions-custom-image.md
http-functions.md
operations-and-config.md
vpc-and-tcp-database.md
SKILL.md
cloud-storage-web/
SKILL.md
cloudbase-agent/
py/
adapter-coze.md
adapter-development.md
adapter-langgraph.md
agent-deployment.md
authentication.md
references/
observability.md
recipes.md
server.md
storage.md
tools.md
server-quickstart.md
skill.md
SKILL.md
ts/
adapter-development.md
adapter-langchain.md
adapter-langgraph.md
agent-deployment.md
agui-protocol.md
server-quickstart.md
skill.md
ui-clients.md
ui-miniprogram.md
cloudbase-cli/
references/
access.md
app.md
cloudrun.md
core.md
functions.md
hosting.md
mysql.md
nosql.md
permission.md
storage.md
SKILL.md
cloudbase-code-review/
references/
lint-rules/
README.md
rules/
RULES_INDEX.md
cross-cutting/
AUTH001.md
SKILL001.md
postgresql/
PG-CR001.md
PG-CR002.md
PG-CR003.md
PG-CR004.md
PG-CR005.md
storage/
STORAGE001.md
SKILL.md
cloudbase-document-database-in-wechat-miniprogram/
aggregation.md
complex-queries.md
crud-operations.md
geolocation.md
pagination.md
security-rules.md
SKILL.md
cloudbase-document-database-web-sdk/
aggregation.md
complex-queries.md
crud-operations.md
geolocation.md
pagination.md
realtime.md
security-rules.md
SKILL.md
cloudbase-platform/
references/
protocols/
change-safety-protocol.md
deployment-gate.md
SKILL.md
cloudbase-wechat-integration/
references/
mini-program-pay.md
native-qr-pay.md
official-account-jsapi-pay.md
official-account-oauth.md
overview.md
troubleshooting.md
SKILL.md
cloudrun-development/
references/
vpc-and-database.md
SKILL.md
data-model-creation/
SKILL.md
http-api-cloudbase/
checklist.md
references/
extended-guide.md
SKILL.md
minimal-web-baas-demo/
SKILL.md
miniprogram-development/
references/
cloudbase-integration.md
devtools-debug-preview.md
pitfalls.md
wxide-vs-cloudbase-mcp.md
SKILL.md
ops-inspector/
SKILL.md
postgresql-development-cloudbase/
references/
app-workflow.md
auth-and-rls.md
http-api.md
index.md
pg-mode-overview.md
rls-patterns.md
storage-pg.md
troubleshooting.md
SKILL.md
relational-database-mcp-cloudbase/
SKILL.md
relational-database-web-cloudbase/
SKILL.md
spec-workflow/
SKILL.md
ui-design/
checklist.md
SKILL.md
web-development/
browser-testing.md
frameworks.md
SKILL.md
codebuddy-plugin/
.codebuddy-plugin/
plugin.json
rules/
cloudbase_rules.md
README.md
source/
editor-config/
claude/
commands/
no_spec.md
prototype.md
spec.md
settings.local.json
compat-baseline.json
files/
aider.mcp.json
codex.toml
comate.mcp.json
cursor.mcp.json
gemini.settings.json
iflow.settings.json
kiro.mcp.json
opencode.json
qwen.settings.json
roo.mcp.json
root.mcp.json
vscode.mcp.json
vscode.settings.json
guides/
cloudbase-rules.mdc
guideline/
cloudbase/
references/
activation-map.yaml
console-links.md
deployment-workflow.md
mcp-setup.md
scenarios.md
tooling-fallback.md
SKILL.md
skills/
ai-model-nodejs/
SKILL.md
ai-model-web/
SKILL.md
ai-model-wechat/
SKILL.md
auth-nodejs-cloudbase/
SKILL.md
auth-tool-cloudbase/
checklist.md
references/
extended-guide.md
SKILL.md
auth-web-cloudbase/
references/
extended-guide.md
SKILL.md
auth-wechat-miniprogram/
references/
extended-guide.md
SKILL.md
cloud-functions/
checklist.md
references/
references.md
event-functions.md
http-function-credentials.md
http-functions-custom-image.md
http-functions.md
operations-and-config.md
vpc-and-tcp-database.md
SKILL.md
cloud-storage-web/
SKILL.md
cloudbase-agent/
py/
adapter-coze.md
adapter-development.md
adapter-langgraph.md
agent-deployment.md
authentication.md
references/
observability.md
recipes.md
server.md
storage.md
tools.md
server-quickstart.md
skill.md
SKILL.md
ts/
adapter-development.md
adapter-langchain.md
adapter-langgraph.md
agent-deployment.md
agui-protocol.md
server-quickstart.md
skill.md
ui-clients.md
... 1367 moreFAQ
cloudbase-ai-toolkit is a Claude Code plugin with 98 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes ai-model-nodejs, ai-model-web, ai-model-wechat. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.