# Cloudbase

Use when the user builds, deploys, debugs, or troubleshoots anything on 腾讯云开发 CloudBase...

- Repository: https://github.com/TencentCloudBase/CloudBase-AI-Toolkit (1153 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase -g -a claude-code -y`
Codex: `npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase -g -a codex -y`
Cursor: `npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase -g -a cursor -y`
Gemini CLI: `npx skills add TencentCloudBase/CloudBase-AI-Toolkit --skill cloudbase -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add TencentCloudBase/CloudBase-AI-Toolkit`

## Description

Use when the user builds, deploys, debugs, or troubleshoots anything on 腾讯云开发 CloudBase / 云开发 / TCB / 微信云开发, Web, 微信小程序, uni-app, 原生 App. Triggers on: 建站, 页面, 表单, 后台, 原型, 登录, 注册, 鉴权, 数据库, 集合, 建表, 云函数, 云托管, 云存储, 静态托管, 上传, 部署, 上线, 域名, 日志, 报错, 巡检, 大模型, AI 对话, 流式输出, 智能体, 小程序. This is an entry skill: it routes the task to the right CloudBase MCP tool and then pulls the detailed recipe from the CloudBase MCP knowledge base. Do NOT use for non-CloudBase stacks or self-hosted backends.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 腾讯云 CloudBase（云开发）入口技能

这个技能只做三件事：**确认站点**、**把任务路由到对的工具**、**告诉你细节去哪取**。配方正文不放在包里，连上 CloudBase MCP 后用知识库检索拿（见「细节从哪来」）。

CloudBase 是给开发者的后端云：数据库（NoSQL 文档库 / PostgreSQL）、云函数、云托管（容器）、云存储、静态托管、身份认证、内置大模型，以及把这些串起来的 CLI 与控制台。

## 第一步：先确认站点，别猜

CloudBase 有**两套互不相通的账号体系**。站点弄错的表现不是报错，而是「登录了但看不到环境」。能推断就推断（控制台域名、envId、已有报错），推不出来就问一次。

| | 国内站 | 国际站 |
| --- | --- | --- |
| 远程 MCP | `https://tcb-api.cloud.tencent.com/mcp/v1` | `https://tcb-api.tencentcloud.com/mcp/v1` |
| 本地 stdio | 默认即国内 | `TCB_SITE=intl` + `TCB_REGION=ap-singapore` |
| CLI | 默认 | `TCB_IS_INTL=true` |
| 控制台 | `tcb.cloud.tencent.com` | `tcb.tencentcloud.com` |
| 默认地域 | `ap-shanghai` | `ap-singapore` |
| NoSQL 文档库 | 有 | **没有** |

## 第二步：接上 CloudBase MCP

**技能包里不能携带 MCP 配置。** 技能市场把两件事分开：Skill 给「怎么做」，MCP 给「用什么工具」，ZIP 规范里只有 `SKILL.md`（可带脚本和参考资料），没有声明 MCP 的字段。所以这一步必须显式做，做完再谈调用。

先确认站点（见上表），再按客户端能力选一条：

**A. 客户端能执行命令（Claude Code 等）**

```bash
# 远程，推荐
claude mcp add --transport http cloudbase https://tcb-api.cloud.tencent.com/mcp/v1
```

国际站把域名换成 `tcb-api.tencentcloud.com`。

**B. 手动加（Cursor、Qoder 这类图形客户端）**

Agent 改不了这类客户端的配置，把参数给用户：

- 远程：设置 → MCP → 新增 → 类型 `HTTP` / `Streamable HTTP` → 地址填上面的 `/mcp/v1`
- 本地：类型 `stdio` → 命令 `npx` → 参数 `-y @cloudbase/cloudbase-mcp@latest`

**C. 客户端不支持 MCP，但有终端**（兜底，实测可用）

用 mcporter 当桥，不需要客户端理解 MCP：

```bash
# 列工具（42 个）
npx -y mcporter@0.16.1 list --stdio "npx -y @cloudbase/cloudbase-mcp@latest"

# 调工具
npx -y mcporter@0.16.1 call --stdio "npx -y @cloudbase/cloudbase-mcp@latest" auth action=status
```

注意：mcporter 走远程地址会失败（它先用 SSE GET 探测，CloudBase 的 `/mcp/v1` 只收 POST，报 `SSE error: Non-200 status code (405)`），所以这条只走 stdio。

**验证连上没有**：调一次 `queryEnv`（或上面的 `auth action=status`）。能返回环境信息就是通了；提示未登录就按提示在浏览器里授权。

## 第三步：任务 → 工具

The rest: https://github.com/TencentCloudBase/CloudBase-AI-Toolkit/blob/HEAD/connectors/cloudbase/qianwen/entry/cloudbase/SKILL.md