cloudbase
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.
소스 정보
- 저장소
- TencentCloudBase/CloudBase-AI-Toolkit
- 최근 소스 활동
- 2026년 10월 28일 10:10
- 감지된 SKILL.md 언어
- 중국어
- 스타
- 1,154
- 포크
- 149
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- name
- cloudbase
- 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.
- description_zh
- 腾讯云开发 CloudBase 入口技能：先判断国内站/国际站，再把任务路由到对应的 MCP 工具，细节从 CloudBase MCP 的知识库按需检索
- version
- 2.36.2
- license
- MIT
# 腾讯云 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`）。能返回环境信息就是通了；提示未登录就按提示在浏览器里授权。
## 第三步：任务 → 工具
| 要做的事 | 首选工具 |
| --- | --- |
| 看有哪些环境、环境详情 | `queryEnv` / `manageEnv` |
| 设计数据模型、建集合 | `writeNoSqlDatabaseStructure` / `manageDataModel` |
| 读写文档数据 | `writeNoSqlDatabaseContent` / `readNoSqlDatabaseContent` |
| PostgreSQL 建表、查询 | `managePgDatabase` / `queryPgDatabase` |
| 创建、更新、部署云函数 | `manageFunctions` / `queryFunctions` |
| 查函数日志、排错 | `queryLogs` / `manageLogs` |
| 静态托管上传、域名 | `manageHosting` / `queryHosting` |
| 云托管（容器） | `manageCloudRun` / `queryCloudRun` |
| 对象存储 | `manageStorage` / `queryStorage` |
| 登录与权限 | `manageAppAuth` / `queryAppAuth` |
| 从模板起项目 | `downloadTemplate` |
| 声明式部署 | `deployPlan` → `deployBuild` → `deployApply` |
| 查官方文档 / 技能配方 | `searchKnowledgeBase` |
远程 MCP 缺几个工具：`manageStorage` 的本地文件读写、`downloadTemplate`、声明式部署三件套，以及 `manageHosting` 的上传。需要这些时改用本地 stdio。
## 细节从哪来（关键）
不要凭记忆写 CloudBase 的配置和命令。**先查，再写**：
| 想要什么 | 怎么取 |
| --- | --- |
| 某个技能的完整配方 | `searchKnowledgeBase({ mode: "skill", skillName: "<技能名>" })` |
| 官方文档某一段 | `searchKnowledgeBase({ mode: "docs", action: "searchDocs", input: "关键词" })`，再用 `action: "readDoc"` + `docPath` 取全文 |
| 某个 OpenAPI 的参数 | `searchKnowledgeBase({ mode: "openapi", apiName: "<api>" })` |
可检索的技能（31 个）：
- **Web / 小程序 / 原生**：`web-development`、`miniprogram-development`、`http-api-cloudbase`、`ui-design`、`minimal-web-baas-demo`
- **数据**：`postgresql-development-cloudbase`、`postgresql-best-practices-cloudbase`、`cloudbase-document-database-web-sdk`、`cloudbase-document-database-in-wechat-miniprogram`、`relational-database-mcp-cloudbase`、`relational-database-web-cloudbase`
- **计算与部署**：`cloud-functions`、`cloudrun-development`、`cloudbase-declarative-deploy`、`cloudbase-cli`、`cloud-storage-web`
- **身份**：`auth-tool-cloudbase`、`auth-web-cloudbase`、`auth-nodejs-cloudbase`、`auth-wechat-miniprogram`
- **AI**：`ai-model-web`、`ai-model-nodejs`、`ai-model-wechat`、`cloudbase-agent`
- **运维与方法**：`ops-inspector`、`cloud-api-operations`、`cloudbase-mcp`、`cloudbase-code-review`、`cloudbase-platform`、`cloudbase-wechat-integration`、`spec-workflow`
**没有 MCP 时的兜底**：让用户在 WorkBuddy、豆包、Kimi、MiniMax 等客户端里装「腾讯云 CloudBase」连接器（同一套能力），或者直接看 <https://cloudbase.net> 文档。不要凭空编工具名和配置项。
## 三条红线
1. **先定站点**再登录、再绑环境。两站的环境、密钥、登录态互不相通。
2. **新的关系型数据库一律用 PostgreSQL**。环境里已经有 MySQL 时才走 MySQL 那条，不要主动建议开通 MySQL。
3. 删除数据、改安全规则、改权限、改配额之前**先说清后果再动手**。
## 常见失败对照
| 现象 | 多半是 |
| --- | --- |
| 登录成功但环境列表为空 | 站点选错（国内/国际） |
| 工具列表里没有某个工具 | 用的是远程 MCP，缺的工具改本地 stdio |
| 云函数部署后 404 | 触发方式选错（事件型 vs HTTP），或 `scf_bootstrap` 没配 |
| 前端直连数据库读不到 | 安全规则没放行，或没走登录态 |
GitHub에서 보기