搭建过程不到一天。基于 Channel 的发布机制让我能在推送到生产环境之前，先在自己的设备上测试。
Capgo CLI + MCP
一个 CLI + MCP，一统天下
一个工具搞定 Live Updates、Native Build、兼容性检查、设备运行，以及通过 MCP 实现的 AI 辅助 Capgo 自动化。
Capgo CLI
在一个终端会话中完成发布检查、受保护上传和原生构建。
动画示例 — 选项卡切换命令流程
CLI 用户证言
从终端到生产环境，值得信赖的发布工作流
来自使用 Capgo 进行 Capacitor 更新、Native Build 和发布控制的团队简短反馈。
能把 Device ID 加入指定分组，并只向特定分组推送变更，这简直太救命了。
客观对比
Capgo CLI 与其他方案对比。
相同的发布工作，不同的自动化方式。
| Capgo CLI | DIY / 手动 脚本、Fastlane 和仪表盘点击 | 竞品云服务 | |
|---|---|---|---|
| 发布 CLI | 只需一个 CLI。 在同一个终端完成 OTA upload、Native Build、channels、兼容性检查、设备运行和 MCP。 | 需要自行维护各种独立的脚本、curl 任务、Fastlane lanes 以及零散的 API 调用。 | 缺乏原生 CLI 支持。发布流程仅限于 dashboard 或由 git 触发的工作流。 |
| AI Agent 自动化 | 内置 MCP。 将应用、bundles、channels、builds、统计数据和诊断信息开放给 Codex、Cursor、Claude Code 及其他 Agent。 | 除非你自己构建并维护工具链，否则无法实现自动化。 | 没有 MCP server。Agent 无法为你驱动发布流程。 |
| OTA 与 Native 的决策 | 显式命令。 bundle releaseType 会告诉你 OTA 是否安全，还是发布前需要 Native Build。 | 手动检查 native diffs，靠经验判断。 | Dashboard 最多给点提示，压力下容易猜错。 |
| 受保护的 OTA upload | 来自 CI。 带兼容性门禁、delta 支持、加密和 QR 预览链接的 bundle upload。 | 手动 zip upload，或用自定义 API 脚本，检查逻辑自己写。 | Portal upload 或 git hook。终端预检很有限。 |
| Native Build 请求 | 就在同一个终端。 build 请求包含输出记录、QR 链接，logs 会流式传回你的 shell。 | 在你自己盯着的 Mac 上打开 Xcode、Android Studio 或 Fastlane。 | 推送到 git 或在 dashboard 中点击。CI 没有可脚本化的构建记录。 |
| CI 集成 | 支持脚本化输出。 JSON 构建记录、退出码和 QR 产物，pipeline 可据此设置门禁。 | 每个步骤、secret 和产物路径都得你自己串联。 | 只有零散的 Webhooks。大多数团队仍需手动协调发布。 |
| 兼容性检查 | 在 upload 之前。 CLI 会扫描 native 依赖，并在 OTA 可能存在风险时提前报错。 | 除非你自己搭建，否则没有任何防护机制。 | 仅支持基础的 bundle 校验。native drift 很容易被忽略。 |
| 先试后买 | 是的。 14 天无限免费试用。无需信用卡。 | 如果算上维护脚本运行的时间成本，所谓的“便宜”其实并不划算。 | 分级方案。试用期因供应商而异。 |
对比数据反映了典型的 DIY/手动配置方案及竞品公开的云端文档。
来自 Martin
为什么 Capgo CLI 至关重要
Capgo 创始人 Martin 谈从终端发布 Capacitor、推送前检查兼容性，以及让 Native Build 留在同一工作流中。
Martin，Capgo 创始人
命令流程
从环境搭建到选对发布类型
Capgo CLI 命令把关键的发布分叉讲清楚：Web 层有变更就用 live update，App 二进制需要更新就走 Native Build。
OTA 路径
当 Web bundle 可以安全更新时，使用兼容性门禁和预览二维码链接。
Native 路径
当依赖、权限或原生 code 有变更时，请求签名构建。
- 1
初始化更新、上传、构建和验证流程
npx @capgo/cli@latest init - 2
询问发布该走 OTA 还是原生
npx @capgo/cli@latest bundle releaseType com.acme.app --channel production - 3
上传带预览二维码的受保护 live update
npx @capgo/cli@latest bundle upload --channel production --fail-on-incompatible --qr-preview - 4
请求 Native Build，并保留产物供 CI 或 PR 使用
npx @capgo/cli@latest build request com.acme.app --platform ios --build-mode release --output-upload --output-record .capgo/build.json
自动化
作用域密钥进，发布事件出
为 CI 和 AI 代理提供仅能执行特定任务的密钥，并将所有 bundle 和 channel 变更推送至团队已在监控的工具。
为 CI、脚本和 AI 代理提供范围受限的密钥
创建仅限单个组织或应用的密钥，支持 upload、read 或 write 模式，并设置过期日期。密钥可以哈希存储，且创建后不再显示明文。
- 用于 CI 流水线的仅上传密钥
- 每个密钥均设有过期日期
- 当组织要求时，支持哈希存储
将发布事件发送至 Slack、Datadog 或您自有的服务
订阅 bundle、channel、成员和组织变更事件，并检查每次投递的状态和响应。
- 选择每个端点接收的事件
- 包含响应码和重试记录的投递日志
- 在正式上线前发送测试事件
Native Build 与 MCP
让 CLI 处理应用实际所需的发布工作
当兼容性检查显示变更为 OTA 安全时，直接发布受保护的 live update。若 native code、权限或依赖发生变化，请请求 Native Build，并确保输出结果对 CI、PR 和评审人员可见。
应用
Bundle
通道
兼容性
原生 build
统计数据
Doctor
投递探测
然后向你的 Agent 提问
- 上传这个 build 到生产环境，不兼容就报错
- 发起一个 iOS release build 并保存输出记录
- 运行 Capgo doctor 并修复发现的问题
添加 Capgo Agent Skills，让你的 Agent 了解每个 workflow：
npx skills add Cap-go/capgo-skills 安装 MCP
安装 Capgo CLI MCP
在 Codex、Cursor、Claude Code、Windsurf、VS Code、Zed 或 Gemini CLI 中注册 CLI 服务器。
npx install-mcp 'npx @capgo/cli@latest mcp' --client codex
替换 codex 用你团队正在使用的客户端。
托管 MCP
通过 Claude、ChatGPT 或 Cursor 使用 Capgo
无需安装。把 URL 粘贴到任意远程 MCP 客户端，用 OAuth 登录，就能在对话中管理应用、频道、灰度发布、设备和构建。
https://api.capgo.app/mcp
上传和原生构建请求仍通过上述 CLI MCP 执行。 阅读托管 MCP 设置指南
构建记录
iOS 发布构建
已保存的输出，用于 CI、PR 检查和移动端审查。
- 平台
- iOS
- 模式
- 发布版
- 输出
- IPA 和安装二维码
- 记录
- .capgo/build.json
npx @capgo/cli@latest build request com.acme.app --platform ios --output-upload --output-record .capgo/build.json 在发布更新日志前即可查看状态。
QR 码输出可用于设备验证。
错误可在有风险的发布上线前让 CI 失败。
