CloudBase AI Plugin

One-click integration of CloudBase capabilities into your AI coding assistant.

CloudBase Plugin for AI Coding Agents is a one-click installation package that gives your AI coding assistant full access to the CloudBase platform. It bundles CloudBase MCP Server and Agent Skills together — after installation, the AI can directly query databases, manage cloud functions, deploy static hosting, and operate cloud storage without manual configuration.

Why Use a Plugin?

A plugin for AI coding assistants is a packaged collection of AI extensions. A single plugin can bundle:

MCP Services — External tool integrations that let AI interact with the CloudBase platform
Skills — On-demand professional knowledge and context for more accurate AI work
Hooks — Event handlers that auto-run at specific points in the AI lifecycle
Agents — Specialized sub-agents with specific roles and tool configurations
Slash Commands — Custom commands invocable directly within conversations

Packaging MCP Server and Agent Skills into a single plugin means one installation gives you both tool connectivity and domain expertise. You can also install them separately. Plugins can be installed globally (cross-project) or per-project (isolated).

Installation Guide

Preferred: one-click via plugins CLI

Install with the Open Plugin Spec plugins CLI (auto-detects local AI tools). Prefer this path; do not hand-write MCP JSON.

Default --scope user (global):

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

# Optional: Sites plugin
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` (standalone `copilot` CLI, not `gh copilot`)
`vscode`	Visual Studio Code	Agent plugins (Preview, per-user only)

Omit --target to install into all detected targets above. Inspect detection:

npx plugins targets

Install for one tool only:

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

Restart / reload the target tool after install.

Agent entry (decision tree + verify): https://docs.cloudbase.net/skill.md

If you already installed via marketplace / native plugin for the same IDE, do not also run npx plugins add (duplicate instances).

When GitHub is unreachable (CNB mirror)

Short owner/repo forms always resolve to GitHub. If git clone fails, use the full CNB URL (OPS artifacts synced by CI; no marketplace metadata):

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

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

Do not use the monorepo mirror CloudBase-AI-ToolKit with npx plugins add — its marketplace layout is not the same as the dedicated OPS plugin repos.

If the plugin still cannot install, fall back to Skills on CNB or npm MCP — see https://docs.cloudbase.net/skill.md.

Codex marketplace (fallback)

Codex supports installing plugins from the marketplace. You can use the Codex App GUI or the command line.

通过 Codex App 的图形界面添加 CloudBase 插件市场并安装插件。

打开插件目录

在 Codex App 中点击右上角的 + 按钮。

添加插件市场

在菜单中选择 添加插件市场。

填写市场信息

在弹窗中填写以下信息：

来源：TencentCloudBase/CloudBase-MCP

Git 引用：main

稀疏路径：留空

点击添加市场

添加成功后，在插件列表中找到 Tencent CloudBase 市场。

安装 CloudBase 插件

点击 cloudbase 插件旁的安装按钮。

新开线程验证

安装后建议新开一个 Codex 线程，让插件、技能和 MCP 工具完整加载。

Claude Code

Claude Code also supports marketplace plugin installation. After installation, MCP connections and Skills are automatically available:

# Add the CloudBase plugin marketplace
claude plugin marketplace add TencentCloudBase/cloudbase-mcp

# Install the CloudBase plugin
claude plugin install cloudbase@tencent-cloudbase

After installation, run /reload-plugins in Claude Code to activate the plugin. Default --scope user makes it globally available; use --scope project to share within a team.

Other IDEs

For IDEs that don't directly support a marketplace, you can configure MCP connections and use Skills. Select your tool below for detailed steps:

Client

Configure your AI tool to connect with CloudBase capabilities. Supports local and hosted connection. See connection modes.

Step 1: Install / Configure CloudBase

Use project template (recommended) - Template includes MCP configuration and AI rulesView templates

Install in one click:

Add to Cursor

Or manual configuration:

Or add this configuration to .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}

Need help?View Cursor docs

Step 2: Chat with AI

Enter the following in your AI chat in order:

prompt

Install CloudBase Skills: run npx skills add tencentcloudbase/cloudbase-skills -y

Use CloudBase Skills: 在微信小程序中使用 CloudBase Auth 实现用户登录功能

What's Included

CloudBase MCP Server

CloudBase MCP Server connects your AI coding assistant directly to the CloudBase platform. After authentication, the AI can:

Capability	Description
Environment Management	Login, environment query, security domain configuration
NoSQL Database	Read/write database content, manage collection structure
MySQL Database	Query and manage relational databases
Data Model	Create and manage data models
Cloud Functions	Query, create, update, and deploy functions
Static Hosting	File upload, domain management, deployment
Cloud Storage	File management and operations
CloudBase Run	Service deployment and management
API Gateway	Cloud function access entry and route management
App Authentication	Authentication configuration management
Permission Management	Roles, permissions, and security rules
Log Service	Log search and status query
AI Agent	Agent listing, details, and management
Knowledge Base	CloudBase knowledge base intelligent search
Cloud API	General Tencent Cloud API calls

See the complete MCP Tool Documentation for detailed parameters of each tool.

Agent Skills

Skills provide AI with domain-specific knowledge about CloudBase:

Skill	Description
`cloudbase-platform`	CloudBase platform core knowledge: environment config, authentication, resource management
`web-development`	Web project development best practices (React/Vue/native JS)
`miniprogram-development`	WeChat Mini Program cloud development full workflow guide
`cloud-functions`	Cloud function development, debugging, and deployment
`cloudrun-development`	CloudBase Run backend service development
`auth-*`	Identity authentication (Web/Mini Program/Node.js/HTTP API)
`no-sql-*`	NoSQL database development (Web SDK/Mini Program SDK)
`relational-database-*`	Relational database development
`data-model-creation`	Data model design and modeling guidance
`ai-model-*`	AI model integration (Web/Node.js/WeChat)
`ui-design`	UI/UX design rules and standards
`http-api`	HTTP API cloud development
`spec-workflow`	AI-assisted specification-driven development workflow

See the complete Skill Documentation for installation and usage.

Quick Start — First-time user guide
MCP Tool Details — Complete parameters for each tool
How to Use Skills — Skill installation and usage
Connection Modes — Local mode vs hosted mode
FAQ — Plugin configuration and troubleshooting

Why Use a Plugin?​

Installation Guide​

Preferred: one-click via plugins CLI​

Supported AI IDEs (npx plugins targets)​

When GitHub is unreachable (CNB mirror)​

Codex marketplace (fallback)​

Claude Code​

Other IDEs​