适合谁
- 使用 Capacitor 构建 Android/iOS 应用并希望绕过应用商店审核发布 Web 资源更新的团队
- 使用 Claude Code、Codex 或 VS Code 并希望由代理协助发布 OTA 更新的开发者
- 需要自托管 OTA 更新平台的组织
O
57FMRS · C
OtaKit 是由上游项目官方维护的开源 Capacitor OTA 更新框架，其 MCP 服务器让编码代理能够检查、上传、发布、监控和回滚更新，并在发布到设备前请求人工批准。适合使用 Capacitor 并希望绕开应用商店审核发布 Web 资源更新的团队；不适用于非 Capacitor 项目或需要修改原生代码的场景。使用时需注意授予的账号权限、上传与发布操作对线上渠道的影响，以及自托管带来的运维成本。
OtaKit 是一个完全开源、可自托管的 Capacitor 应用空中更新（OTA）框架，让开发者无需经过应用商店审核即可直接向 Capacitor 应用发布更新。其 MCP 服务器用于检查、上传、发布、监控和回滚 OtaKit 的 Capacitor OTA 更新。可从 npm 包 @otakit/cli 以 stdio 方式启动（通过 mcp 子命令），也可通过 https://console.otakit.app/mcp 使用 streamable-http 远程连接。当用户要求 Claude Code、Codex 或 VS Code 发布更新时，它可以读取 Capacitor 项目、判断改动是否适合通过 OTA 下发、上传构建产物，并在内容到达设备前停下来等待用户批准。
安装接入
在项目目录下运行一条命令：npx -y @otakit/cli@latest connect。它会检测你的客户端、在需要时登录，并在写入任何内容之前打印解析出的控制台、组织、项目和应用信息，以及将要写入的确切文件。使用 --dry-run 可以只查看计划而不写入。Claude Code 另有插件可同时提供服务器与 OtaKit Agent Skill：先运行 npx -y @otakit/cli@latest login，再运行 claude plugin marketplace add OtaKit/otakit 和 claude plugin install otakit@otakit。
选型与风险
不适合谁
- 非 Capacitor 项目或未使用 OtaKit 的应用
- 需要修改原生代码而非 Web 资源的更新场景
- 不愿授予代理上传与发布权限的团队
所需权限
- 需要 OtaKit 账号登录（npx @otakit/cli login），以获得访问控制台、组织和项目的权限
- CLI 会写入客户端配置文件（connect 会打印将要写入的确切文件）
- 上传构建产物并创建发布需要对应项目的写入权限
- 远程连接 https://console.otakit.app/mcp 时涉及 OAuth 授权
风险与副作用
- 在未审批的情况下发布，可能把有问题的构建推送到真实设备
- 上传与发布操作会修改线上渠道的清单，影响后续启动或恢复的应用
- 自托管部署需要自行维护 Postgres、兼容 S3 的存储桶、CDN，以及可选的 ingest 服务与 Tinybird 工作区
- 配置文件写入由 CLI 执行，需先核对 connect 打印的目标文件路径
常见排障
- 先运行带 --dry-run 的 connect，确认解析到的控制台、组织、项目与应用是否正确
- 确认已登录：运行 npx -y @otakit/cli@latest login
- 确认已在 capacitor.config.* 中填入正确的 appId
- 远程连接失败时检查 https://console.otakit.app/mcp 的 OAuth 授权是否完成
- 自托管环境下检查 Postgres 与兼容 S3 存储桶的配置，参考 packages/console/.env.example
- 若担心 OTA 更新兼容性，检查插件中配置的运行时版本（runtime version）
使用场景
在编辑器或编码代理中检查、上传并发布 Capacitor 应用的 OTA 更新
发布前判断改动是否适合通过 OTA 下发
发布后监控更新状态并在需要时回滚
在发布到设备前设置人工审批环节
支持客户端
Claude Code完整支持
Codex完整支持
VS Code完整支持