跳转至正文
Cursor logo

通过 Capgo 在 Cursor 中交付您的移动应用

Cursor 可实现 Capacitor 应用的构建、发布与 Live Update：无需 Mac 即可构建 iOS 和 Android 版本，分钟级 OTA 修复，支持一键回滚。

  • IDE
  • 托管 MCP
  • 本地 MCP
  • 技能
  • CLI

在 Cursor 中配置 Capgo

只需三步。直接复制每个代码块即可。

  1. 第 1 步

    添加托管的 Capgo MCP

    将其添加到 ~/.cursor/mcp.json 以应用于所有项目，或添加到 .cursor/mcp.json 以应用于单个项目。Cursor 会在 server 旁显示 Needs login：点击即可登录。无需 API key。

    ~/.cursor/mcp.json 
    {
  "mcpServers": {
    "capgo": {
      "url": "https://api.capgo.app/mcp"
    }
  }
}

  2. 第 2 步

    添加用于 build 和 upload 的本地 CLI MCP

    在终端运行一次 npx @capgo/cli@latest login，然后将 capgo-cli 条目添加到 capgo 旁边。

    ~/.cursor/mcp.json 
    {
  "mcpServers": {
    "capgo": {
      "url": "https://api.capgo.app/mcp"
    },
    "capgo-cli": {
      "command": "npx",
      "args": [
        "@capgo/cli@latest",
        "mcp"
      ]
    }
  }
}

  3. 第 3 步

    安装 Capgo skills

    Cursor 会从 .agents/skills 和 .cursor/skills 中读取技能。

    终端
    $ npx skills add Cap-go/capgo-skills

你可以向 Cursor 提问的内容

复制 Prompt 并粘贴到 Cursor 中。请将 App ID 和版本号替换为你自己的。

  • 构建

    “使用 Capgo Build 为此应用构建一个已签名的 iOS release 版本。”

  • 发布

    “请求一个 Android release 构建，并发送到 Google Play 内部测试轨道。”

  • 更新

    “检查这个改动是否需要 Native Build，还是可以直接作为 live update 发布。”

  • 更新

    “构建 Web 应用，并将这个修复推送到 production 渠道。”

  • 回滚

    “回滚 production channel 上的最后一个 bundle。”

  • Observe

    “显示 v2.3.0 的更新统计数据：有多少设备已安装，有多少安装失败。”

  • Observe

    “为什么我上次的 iOS build 失败了？请阅读 build logs 并提供修复建议。”

  • 构建

    “在构建前，先在这个项目上运行 Capgo doctor，并修复它报告的问题。”

完整的发布闭环

一个账号就能覆盖从首次 build 到下一次线上修复的每一步。

  1. 1

    构建

    在云端完成 iOS 和 Android 的签名 build。你这边无需 Mac，也无需 Xcode。

    Capgo Build（原生应用）
  2. 2

    发布

    将 build 发送到 TestFlight 和 Google Play，或提交给应用商店审核。

    无需 Mac 即可构建并发布 iOS 应用
  3. 3

    更新

    几分钟内即可将 JavaScript、HTML 和 CSS 修复推送至 Channel。支持一键回滚。

    Capgo 实时更新
  4. 4

    Observe

    查看更新覆盖情况、失败原因以及每次发布的性能表现。

    使用 Capgo Observe

Cursor 说明与限制

  • Cursor agent 可以运行终端命令，因此也能直接调用 Capgo CLI。
  • Cursor Cloud Agents 无法获取仅存在于本地机器上的 skills。请将 .agents/skills 提交至仓库以实现共享。
  • 在 Cursor 设置中关闭不需要的 tools，以保持工具列表简洁。

常见问题

Capgo 与 Cursor：常见问题

Cursor 能在没有 Mac 的情况下构建我的 iOS 应用吗？

可以。Cursor 会运行 Capgo CLI，将您的项目上传到 Capgo Build。Capgo 会在云端进行 iOS 和 Android 应用的签名与构建，并能将其发送至 TestFlight 和 Google Play。

Native Build 文档

我需要为 Cursor 提供 Capgo API 密钥吗？

托管版 MCP 不需要 API 密钥：它通过 OAuth 登录。本地 CLI MCP 和 CLI 使用您通过 npx @capgo/cli@latest login 保存一次的 API 密钥。您可以在 Capgo 控制台的 Settings > Organization > API keys 下创建该密钥。

创建 Capgo API 密钥

Cursor 可以回滚错误的更新吗？

可以。只需让 Cursor 将 channel 指向之前的 bundle 即可。设备会在下次检查更新时自动切换。此外，当新 bundle 启动失败时，Capgo updater 也会自动执行回滚。

Live update 文档

App Store 和 Google Play 允许使用 Live Updates 吗？

可以，但仅限 Web 层：JavaScript、HTML、CSS 和静态资源。Native code、新权限和新插件仍需通过应用商店发布，Capgo Build 可以帮你完成。

在 Cursor 中使用 Capgo 的费用是多少？

MCP servers、skills 和 CLI 均可免费使用。你需要 Capgo 方案，每个方案都提供 14 天免费试用，无需信用卡。Build、Live Updates 和 Observe 都包含在每个方案中。

定价

在 Cursor 中发布你的下一个版本

立即创建 Capgo 账号，连接 Cursor，并推送你的第一个 build 或 live update。

文档

相关页面