メインコンテンツへスキップ
Capgo - Capacitor アプリのビルド、リリース、アップデート Capgo

ホスト型 MCP サーバー

Capgo はホスト型の Model Context Protocol (MCP) サーバーを実行します。これにより、AIアシスタントがチャット越しに Capgo アカウントと連携し、アプリやbundle の一覧表示、channel から新しい bundle への移動、rollout の一時停止、update のステータス確認、Native Build のログ確認などが可能になります。

https://api.capgo.app/mcp
  • インストールするものはありません。 URLをMCPクライアントに貼り付けてください。
  • ステートレスなストリーミングHTTP。 リモートMCPサーバーをサポートするあらゆるクライアントで動作します。
  • OAuth 2.1 サインイン対応。 MCP認証をサポートするクライアントでは Capgo コンソールが開き、アクセスを承認できます。OAuth非対応のクライアントでは、代わりに Capgo API キーを使用できます。

クライアントを接続する

「Connect your client」セクション

OAuth をサポートしているクライアントは、URL を指定するだけで動作します。Capgo のログインフローを自動的に検出し、サーバーを初めて使用する際に同意ページが開きます。

  1. 開く 設定 → コネクタ から Add custom connector を選択し、.
  2. 名前を入力して Capgo を https://api.capgo.app/mcp としてURLに貼り付けます。
  3. クリック Connect をクリックし、 同意画面が表示されたら Capgo にサインインしてください。

MCP Inspector など、MCP 認可仕様を実装している他のクライアントも同じように動作します。URL を渡し、サインインのプロンプトに従ってください。

OAuth非対応のクライアント (API key)

「OAuth非対応のクライアント (API key)」というセクション

n8n、スクリプト、CIジョブ、OAuthフローを実行できないクライアントの場合は、 Capgo API キー をベアラートークンとして送信してください：

Authorization: Bearer <your Capgo API key>

例：カスタムヘッダーを受け付けるクライアント設定：

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

アシスタントに必要な権限を満たす最小限のロールのキーを使用してください。詳細は API keyの権限.

サインインとアクセス

「サインインとアクセス」というセクション

ホストされたサーバーは、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> 作成します。

このキーの有効期限は最大 90 日です。組織がより短い API キーの有効期限ポリシーを適用している場合は、より厳しい制限が優先されます。期限が切れたら、クライアントから再度サインインして再接続してください。

アクセス権の取り消し

「アクセス権の取り消し」という見出しのセクション

接続されている各クライアントには、独自の MCP · <client name> キーがあります。クライアントを切断するには、そのキーを API キーのページ の Capgo コンソール。クライアントはアクセス権を失い、再接続するには再度同意ページを経由する必要があります。

アシスタントでできること

「アシスタントができること」セクション

ホストされたサーバーは、約50個のツールを公開しています：

項目カバー範囲
アカウントと組織自分自身、組織、メンバーと招待、監査ログ、API キー
アプリアプリの一覧表示、作成、更新、削除
BundleBundleの一覧表示、メタデータの更新、削除、使用状況の確認
ChannelとロールアウトChannelの作成・更新、ChannelへのBundle設定、段階的なロールアウト（一時停止、昇格、ロールバック）、自動一時停止
デバイスデバイスの一覧表示と詳細確認、Channelオーバーライドの設定・削除
統計情報とObserveアプリ、組織、アカウントの統計、更新状況の確認 Observe
Native BuildBuildステータス、Buildログ、Buildのキャンセル
WebhookWebhookの作成、更新、テスト、削除、配信状況の確認と再試行
プッシュ通知通知設定、プロバイダー、キャンペーン、通知の送信、統計

各ツールが以下を呼び出します： Capgoの公開API セッションのキーを使用して実行されます。権限（RBAC）、レート制限、監査ログは、そのキーを使ったREST API呼び出しとまったく同じように動作します。

データを削除・上書きするツールは破壊的（destructive）と注釈されているため、MCPクライアントは実行前に確認を求めます。

プロンプトの例

「プロンプトの例」というセクション
  • 「Capgoのアプリを一覧して、各productionチャネルのbundleを表示して」
  • “Pause the rollout on the production channel of com.example.app.”
  • 「前回のiOSネイティブビルドが失敗したのはなぜ？ログを見せて」
  • 「まだbundle 1.4.2を使っているデバイスはどれ？」

ホスト型 vs ローカル型 MCP

「Hosted vs local MCP」セクション

Capgo には2つのMCPサーバーがあります。両方を同時に使用できます。

ホスト型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 クライアントローカルプロセスを実行可能なデスクトップおよびターミナルエージェント
アカウント管理アプリ、bundle、channel、rollout、デバイス、統計、Observe、build、webhook、通知アプリ、bundle、channel、組織、統計
ビルドフォルダから bundle を upload するいいえはい
Native Build をリクエストする不可（status, logs, cancel のみ）はい
doctor, probe、プロジェクトとの互換性チェックいいえはい

日常的なアカウント操作には、どのチャットアプリからでもホスト型サーバーを使えます。追加するのは ローカルの CLI MCP サーバー アシスタントがプロジェクトのファイルを必要とする場合です。

セクション「関連」