跳转到正文
Capgo - 构建、发布并更新 Capacitor 应用 Capgo

托管 MCP 服务器

Capgo 运行托管的 模型上下文协议 (Model Context Protocol) (MCP) 服务，让 AI 助手能直接通过对话操作您的 Capgo 账号：列出 apps 和 bundles、将 channel 迁移至新 bundle、暂停 rollout、检查 update 健康状态或读取 Native Build logs。

https://api.capgo.app/mcp
  • 无需安装。 将 URL 粘贴到您的 MCP 客户端中。
  • 支持流式 HTTP，无状态。 适用于任何支持远程 MCP server 的客户端。
  • 支持 OAuth 2.1 登录。 支持 MCP 鉴权的客户端会打开 Capgo 控制台以供您授权。不支持 OAuth 的客户端可以使用 Capgo API 密钥代替。

连接你的客户端

章节标题为“连接你的客户端”

支持 OAuth 的客户端只需要 URL。它们会自行发现 Capgo 登录流程，并在你首次使用服务器时打开同意页面。

  1. 打开 设置 → 连接器 并选择 添加自定义连接器.
  2. 输入名称 Capgo 并粘贴 https://api.capgo.app/mcp 作为 URL。
  3. 点击 连接 当授权页面打开时，请登录 Capgo。

其他实现了 MCP 授权规范的客户端（例如 MCP Inspector）工作方式相同：提供 URL 并按照登录 prompt 操作即可。

不使用 OAuth 的客户端（API 密钥）

标题为“不使用 OAuth 的客户端 (API 密钥)”

对于 n8n、脚本、CI 任务或任何无法运行 OAuth 流程的客户端，请发送 Capgo API 密钥 作为 Bearer Token：

Authorization: Bearer <your Capgo API key>

例如，支持自定义 Header 的客户端配置：

{
  "mcpServers": {
    "capgo": {
      "url": "https://api.capgo.app/mcp",
      "headers": {
        "Authorization": "Bearer <your Capgo API key>"
      }
    }
  }
}

请使用权限最小化且能满足助手需求的密钥。请参阅 API 密钥权限.

登录与访问

标题为“登录与访问”

托管服务器实现了基于 PKCE 的 OAuth 2.1，遵循 MCP 授权规范 (2025-11-25).

  1. 你的 MCP 客户端会打开 Capgo 控制台同意页面（console.capgo.app/oauth/authorize).
  2. 使用你的 Capgo 账号登录。
  3. 你选择客户端可以访问哪些组织。
  4. Capgo 会创建一个名为的专用 API 密钥 MCP · <client name> 用于该客户端。

该 key 最长有效期为 90 天。如果组织强制执行更短的 API key 过期策略，则以更严格的限制为准。过期后，请从客户端重新登录以重新连接。

撤销访问权限

标题为“撤销访问权限”的章节

每个已连接的客户端都有自己的 MCP · <client name> key。要断开某个客户端，请在 API 密钥页面 在 Capgo 控制台中。客户端将失去访问权限，必须重新通过授权页面进行连接。

助手功能

标题为“助手功能”的部分

托管服务器提供了约 50 个工具：

领域覆盖范围
账号与组织身份查询、组织、成员与邀请、审计日志、API 密钥
应用列出、创建、更新及删除 App
Bundle列出 bundle、更新元数据、删除、检查用量
Channels 与 rollouts创建与更新 channels、为 channel 设置 bundle、渐进式 rollouts（暂停、晋升、回滚）、自动暂停
设备列出并检查设备、设置或移除 channel overrides
统计数据与 ObserveApp、组织及账号统计，更新来自 Observe
原生 buildBuild 状态、build logs、取消 build
Webhooks创建、更新、测试与删除 webhooks，检查并重试投递
推送通知通知设置、提供商、营销活动、发送通知、统计数据

每个工具都会调用 Capgo 公共 API 并使用您会话中的密钥。权限 (RBAC)、速率限制和审计日志的行为与使用该密钥的 REST API 调用完全一致。

执行删除或覆盖操作的工具会被标记为“破坏性 (destructive)”，因此 MCP 客户端在运行它们之前会请求您的确认。

示例 Prompt

标题为“示例 Prompt”的章节
  • “列出我的 Capgo 应用，并显示每个生产渠道 (production channel) 上的 bundle。”
  • “Pause the rollout on the production channel of com.example.app.”
  • “为什么我上次的 iOS Native Build 失败了？请显示 logs。”
  • “哪些设备仍在使用 bundle 1.4.2？”

托管版 vs 本地 MCP

章节标题：“托管式 vs 本地 MCP”

Capgo 提供两个 MCP server。你可以同时使用它们。

托管 MCP本地 CLI MCP
端点https://api.capgo.app/mcpnpx @capgo/cli@latest mcp (stdio)
安装无需填写，直接粘贴 URL在你的机器上运行 Capgo CLI
身份验证OAuth 登录，或 Authorization: Bearer <API key>npx @capgo/cli@latest login
支持Claude.ai, ChatGPT, Cursor, VS Code, Lovable, n8n 以及其他远程 MCP 客户端可以启动本地进程的桌面端和终端 Agent
账号管理应用、bundle、channel、rollout、设备、统计数据、Observe、build、webhook、通知应用、bundle、channel、组织、统计数据
从 build 文件夹上传 bundle否是
请求 Native Build不支持（仅限状态查询、logs 查看及取消）是
doctor, probe，并针对您的项目进行兼容性检查否是

通过任何聊天应用使用托管服务器处理日常账户工作。添加 本地 CLI MCP 服务器 当助手需要您的项目文件时。

标题为“相关”的章节