腾讯云 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 等）

# 远程，推荐
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：

# 列工具（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 没配
前端直连数据库读不到	安全规则没放行，或没走登录态