用途
CloudBase MCP 是一份关于腾讯云开发（CloudBase）MCP 服务器的参考技能，主要解决三类问题：连接本地或远程 MCP 服务器；在代理没有原生 MCP 工具时，通过 mcporter 从 shell 调用 CloudBase 工具；在调用工具前读取工具 schema。它也用于说明站点（国内/国际）、区域、云模式与插件开关的选择方式。
本技能明确不用于创建或更改云资源，这类操作应使用对应的领域技能，或在 MCP 工具未加载时使用 ../cloudbase-cli/SKILL.md。云平台、权限或账号问题也不属于代码范畴，应提交 issue 而非 pull request。
连接方式
提供三种连接入口：
- 远程国内站：https://tcb-api.cloud.tencent.com/mcp/v1
- 远程国际站：https://tcb-api.tencentcloud.com/mcp/v1
- 本地：npx @cloudbase/cloudbase-mcp@latest（需 Node.js 18.15+）
主机名决定站点，远程 URL 不接受站点查询参数。交互式客户端在 IDE 配置中只需填 URL，IDE 会打开浏览器进行登录。CI 场景需添加 env_id 及 X-TencentCloud-SecretId / X-TencentCloud-SecretKey 请求头。国际站的本地 stdio 需设置 TCB_SITE=intl 与 TCB_REGION=ap-singapore。
模式选择规则：远程为默认模式，适用于交互式浏览器 OAuth 登录及完全在云端运行的任务。本地模式适用于以下任一情况：账号使用 CloudBase API key（CLOUDBASE_API_KEY）登录，而远程仅支持 OAuth 或腾讯云 SecretId/SecretKey；一个会话需同时覆盖国内站与国际站；任务需要远程未注册的工具，如 manageStorage、downloadTemplate、manageCloudRun 或声明式 deployBuild/deployPlan/deployApply。部署函数或应用本身不要求本地模式，远程可通过 queryFunctions(action="getFunctionUploadUrl") 或 queryApps(action="getUploadUrl") 获取上传地址、PUT 上传 zip，再用 manageFunctions 或 manageApps(action="deployApp") 完成部署；远程缺少的是声明式 cloudbaserc 执行器及执行前的 dry-run。国际站两种模式均不提供 NoSQL 工具。
使用 mcporter 调用工具
当会话没有原生 MCP 工具时使用 mcporter。先检查服务器是否已配置：npx mcporter list | grep cloudbase。若缺失，在 config/mcporter.json 中添加名为 cloudbase 的 stdio 服务器，command 为 npx，args 为 @cloudbase/cloudbase-mcp@latest。
首次调用前应先读取 schema：npx mcporter describe cloudbase --all-parameters 与 npx mcporter list cloudbase --schema，因为不带 --all-parameters 的 describe 会省略参数。调用格式为 server.tool 加 key=value 参数，例如 npx mcporter call cloudbase.queryEnv action=list --output json。注意不得将 Secret ID、Secret Key 或环境 ID 写入 mcporter.json，登录通过 cloudbase.auth 或 tcb login 完成。
环境变量与插件
- TCB_SITE：domestic 或 intl；ap-singapore 在两个站点均存在，国内站的新加坡环境须设 TCB_SITE=domestic。
- TCB_REGION：API 区域，如 ap-shanghai 或 ap-singapore。
- CLOUDBASE_MCP_CLOUD_MODE 或 MCP_CLOUD_MODE：设为 true 时对自托管调用方禁用本地文件与进程工具。
- CLOUDBASE_MCP_PLUGINS_ENABLED / CLOUDBASE_MCP_PLUGINS_DISABLED：本地服务器的逗号分隔插件名。
- enable_plugins / disable_plugins：远程 URL 上的同类开关，逗号分隔。
插件名取自 mcp/src/server.ts（env、database、functions、hosting、storage 等）。本地服务器与托管远程服务器默认启用相同插件集，可针对特定调用方通过远程 URL 的 disable_plugins 或本地的 CLOUDBASE_MCP_PLUGINS_DISABLED 关闭某个插件。
参与贡献
仓库根目录的 CONTRIBUTING.md 说明了流程：fork、使用功能分支、遵循其中列出的提交类型（feat、fix、docs 等），使用 corepack 与 pnpm install 安装。MCP、技能或 CLI 的缺陷可提交 pull request；云平台、权限或账号问题应提交 issue，且文本中不得包含环境 ID 或密钥。prepareFeedback 仅返回当前站点的新建 issue 页面，正文在聊天中撰写，由用户登录后提交。
适用场景与限制
适用于配置 CloudBase MCP 连接、通过 mcporter 调用工具、查询 schema、切换站点与插件、以及为仓库缺陷提交修复。需注意：远程 URL 绑定单一站点；远程无 API key 登录路径；国际站不提供 NoSQL 工具；云资源变更与账号问题不在本技能范围内。