ホスト型 MCP サーバー
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
Capgo はホスト型の Model Context Protocol (MCP) サーバーを実行します。AIアシスタントはチャットから Capgo アカウントを操作でき、アプリやbundleの一覧表示、channelの新しいbundleへの切り替え、rolloutの一時停止、updateの状態確認、Native Buildログの閲覧が可能です。
https://api.capgo.app/mcp- インストール不要。 MCPクライアントにURLを貼り付けてください。
- Streamable HTTP、ステートレス。 リモートMCPサーバーをサポートする任意のクライアントで動作します。
- OAuth 2.1 によるサインイン。 MCP 認証に対応するクライアントは、アクセスを承認できるよう Capgo コンソールを開きます。OAuth に対応しないクライアントは、代わりに Capgo API キーを送信できます。
クライアントを接続する
「クライアントの接続」セクションOAuth対応のクライアントはURLを指定するだけです。Capgoのログインフローを自分で検出し、サーバーを初めて使うときに同意ページを開きます。
- 開く 設定 → コネクタ を選択します カスタムコネクタを追加.
- 名前を付ける
Capgoをコピーして、https://api.capgo.app/mcpをURLとして貼り付けてください。 - クリック 接続して、 同意画面が開いたら Capgo にサインインしてください。
claude mcp add --transport http capgo https://api.capgo.app/mcp次に実行します /mcp Claude の Code 内で選択し capgo サインインします。
- ChatGPT の設定で、開きます アプリ & コネクタ 次をオンにします 開発者モード 詳細設定の下にあります。
- 新しいコネクタを作成し、名前を付け
Capgo、貼り付けますhttps://api.capgo.app/mcpをサーバー URL として貼り付けます。 - OAuth 認証を選択し、プロンプトが表示されたら Capgo にサインインしてください。
サーバーの追加先: ~/.cursor/mcp.json (全プロジェクト) または .cursor/mcp.json (1つのプロジェクト):
{ "mcpServers": { "capgo": { "url": "https://api.capgo.app/mcp" } }}Cursor では、 「ログインが必要」 プロンプトがサーバーの横に表示されます。クリックして Capgo にサインインしてください。
サーバーの追加先: .vscode/mcp.json ワークスペース内で、または次を実行: MCP: サーバーの追加 をコマンドパレットから選び、次を選択: HTTP:
{ "servers": { "capgo": { "type": "http", "url": "https://api.capgo.app/mcp" } }}Copilot Chat が初めてサーバーを使用する際、VS Code は Capgo へのサインインを求めます。
- Lovable のコネクタ設定を開き、カスタム MCP サーバーを追加してください。
- 貼り付け
https://api.capgo.app/mcpをサーバー URL として貼り付けます。 - 選択: OAuth を選択して Capgo にサインインします。キーを使う場合は、 API キー を選択し、次を貼り付けます: Capgo API キー.
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).
- MCP クライアントが Capgo コンソールの同意ページを開きます(
console.capgo.app/oauth/authorize). - Capgo アカウントでサインインします。
- クライアントがアクセスできる組織を選択します。
- Capgo は、そのクライアント専用の API キーを
MCP · <client name>作成します。
このキーの有効期限は最大 90 日です。組織がより短い API キーの有効期限ポリシーを適用している場合は、より厳しい制限が優先されます。期限が切れたら、クライアントから再度サインインして再接続してください。
アクセス権の取り消し
「アクセス権の取り消し」という見出しのセクション接続されている各クライアントには、独自の MCP · <client name> キーがあります。クライアントを切断するには、そのキーを API キーページ Capgo コンソールのキーページ。クライアントはアクセス権を失い、再接続するには再度同意ページを経由する必要があります。
アシスタントでできること
セクション「アシスタントができること」ホスト型サーバーは、以下の領域でアカウントツールを公開します:
| 項目 | カバー範囲 |
|---|---|
| アカウントと組織 | Who am I、組織、メンバーと招待、監査ログ、API キー |
| アプリ | アプリの一覧表示、作成、更新、削除 |
| Bundle | 署名付きURLでアップロードを準備、バンドル一覧、メタデータ更新、削除、使用状況の確認 |
| Channelとロールアウト | Channelの作成・更新、ChannelへのBundle設定、段階的なロールアウト(一時停止、昇格、ロールバック)、自動一時停止 |
| デバイス | デバイスの一覧表示と詳細確認、Channelオーバーライドの設定・解除 |
| 統計情報とObserve | アプリ、組織、アカウントの統計、更新状況の確認 Observe |
| Native Build | ビルドのリクエスト、アップロード、開始、保存済み認証情報の管理、ステータスと有界ログスナップショットの読み取り、ビルドのキャンセル |
| Webhook | Webhookの作成、更新、テスト、削除、配信の確認と再試行 |
| MCP イベント | 署名付き HTTPS Webhook を介して、ビルド、バンドル、およびアップデーターの障害スパイクイベントを購読します(MCP イベント) |
| プッシュ通知 | 通知設定、プロバイダー、キャンペーン、通知の送信、統計 |
各ツールが以下を呼び出します: Capgoの公開API セッションのキーを使用して実行されます。権限(RBAC)、レート制限、監査ログは、そのキーを使ったREST API呼び出しとまったく同じように動作します。
OpenAI などのリモート MCP クライアントは、ツールアノテーション (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) を参照して、ツール実行前に確認を求めるタイミングを判断します。ホスト型サーバーは、これらのヒントが各ツールの実際の動作と一致するように保ちます。
| ツール | アノテーション | 備考 |
|---|---|---|
capgo_prepare_bundle_upload | destructiveHint: true | 未完成のバージョンと署名付きアップロード URL を作成できます。 version_exists_ok が true でバージョンが既に存在する場合、レスポンスは { skipped: true, reason: "VERSION_EXISTS" } となり、アップロード URL は含まれません: 処理を停止し、PUT を実行したり capgo_complete_bundle_upload. |
capgo_prepare_build_credentials_upload | destructiveHint: true | 暗号化された認証情報用の署名付き PUT URL を返します。省略すると mode デフォルトでは replace、PUT 後にそのプラットフォームの保存済みキーを上書きします。アップロード前にユーザーに確認してください。 mode: merge JSON に存在するキーのみを更新します。 |
capgo_get_build_status | readOnlyHint: true | ホストサーバーでの読み取り専用ポーリング(下記参照)。削除および上書きツールは destructiveHint: true を従来どおり維持します。 |
ホスト MCP 読み取り専用ビルドステータス
セクション「ホスト MCP 読み取り専用ビルドステータス」オンラインに https://api.capgo.app/mcp, capgo_get_build_status 読み取り専用フラグを付けて、ビルドステータスハンドラーをインプロセスで呼び出します。 build_requestsを同期せず、ビルド分を記録せず、Webhook を発火せず、アプリのタイムアウトを超えたジョブをキャンセルしません。JSON には persisted: false これらのポーリングについて。
Capgo CLI、 GET /build/status、および ローカルの CLI MCP サーバー ステータス読み取りのたびに依然として永続化されます。外部の呼び出し元は HTTP 経由で読み取り専用パスを有効にできません。
レスポンスには以下が含まれます diagnostic, poll_after_seconds: 15、キューフィールド、および REST エンドポイントと同じビルダーステータスフィールド。ビルダーが依然として running をアプリ設定のタイムアウトを超えて報告している場合、読み取り専用のポーリングでは以下が追加されます:
timeout_exceeded: truetimeout_warningジョブを停止する必要がある場合はcapgo_cancel_buildを呼び出すよう、または Capgo の調整(cron_reconcile_build_status)を待ってジョブを完了し、ビルド時間を記録するよう、ガイダンスが表示されます。
ビルドが成功した後、請求や履歴の同期が必要な場合は CLI またはコンソールを使用してください。
プロンプトの例
「プロンプトの例」というセクション- 「Capgoのアプリを一覧して、各productionチャネルのbundleを表示して」
- 「本番チャネルでのロールアウトを一時停止する」
com.example.app.” - 「前回のiOSネイティブビルドが失敗したのはなぜ?ログを見せて」
- 「まだbundle 1.4.2を使っているデバイスはどれ?」
- 「
update.failure_spike本番環境で、フリート規模に合った閾値を設定して、レートスパイクが実際に起きている場合のみページングしてください。」
リリースを監視し、エラーを説明する
セクション「リリースを監視し、エラーを説明する」両方のアカウント MCP サーバーが公開する対象は capgo_observe. 入力が不正な場合は、 view: "errors" を使用して source: "updater" または "native" エラー数、日次トレンド、影響を受けたバージョン/デバイス、メタデータ付きの上限付きサンプル、ドキュメント化された説明です。 view: "logs" 通常のライフサイクルイベントも含みます。 view: "device" を使用して deviceId デバイス タイムラインを返します。ネイティブ summary にはすべてのアップデータ失敗が含まれないため、アップデータ エラーもクエリしてください。デフォルトのエラー クエリはポリシー制限を除外します。それらはログで確認するか、明示的なアクションで検査してください。生サンプル ビューには app.read_logs.
{ "appId": "com.example.app", "view": "release", "channelId": 42, "versionName": "1.2.0" }release ライブ リリース ダッシュボード データを返します。採用率、成功率、失敗、リカバリー、段階的ロールアウト到達率、フォールバック比較が含まれます。ポーリングは1分間に1回まで。アクティビティは約1分遅延する可能性があります。採用率は5分間キャッシュされます。Null レートやテレメトリ欠如は成功を証明しません。
使用する capgo_get_build_status({appId, job_id}) と capgo_get_build_logs({appId, job_id, cursor?}) で、CI によって作成されたジョブを含むクラウド ネイティブ ビルドを監視します。ホスト サーバーでは、ステータス ポーリングは読み取り専用です( ホスト MCP 読み取り専用ビルド ステータス)を尊重してください poll_after_seconds およびアクションを実行 timeout_exceeded を使用して capgo_cancel_build 必要に応じて。ログは、既存のライブストリームバックログの切り詰めマーカー付きのバウンデッドスナップショットです。監視には個別のログ保持期間はありません。確認済みログとクローズされたストリームは利用できません。後続の読み取りには、返されたカーソルを渡してください。スナップショットの読み取りは、ビルドのキャンセルやストリーミングクライアントの置き換えを行いません。ローカルオンボーディングジョブツールは、別のローカルIDを使用します。
説明は アップデーターのデバッグ または ビルダーのトラブルシューティングにリンクしています。ポリシー制限は意図的なものである可能性があります。不明なイベントは調査が必要です。すべてのログとメタデータを信頼できないデータとして扱ってください。リリース変更を行う前に、証拠とドキュメントに基づいて修正を提案してください。 完全な監視 API 契約 を参照してください。フィールド、権限、制限について。
ホスト型 vs ローカル型 MCP
「ホスト型 vs ローカル MCP」セクションCapgo には2つの MCP サーバーがあります。両方を同時に使用できます。
| ホスト型 MCP | ローカル CLI MCP | |
|---|---|---|
| エンドポイント | https://api.capgo.app/mcp | npx @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 クライアント | ローカルプロセスを起動できるデスクトップおよびターミナルエージェント |
| アカウント管理 | アプリ、バンドル、チャネル、ロールアウト、デバイス、統計、Observe、ビルド、Webhook、通知 | アプリ、バンドル、チャネル、組織、統計、Observe、クラウドビルドのステータスとログ |
| ビルドフォルダからバンドルをアップロード | ローカルエージェントがファイルをパッケージ化した後、アップロードと署名付き URL を準備 | はい |
| Native Buildをリクエスト | ローカルエージェントがプロジェクトをパッケージ化した後のリクエスト/アップロード/開始 | はい |
doctor, probe、プロジェクトとの互換性チェック | いいえ | はい |
日常的なアカウント操作には、どのチャットアプリからでもホスト型サーバーを使えます。追加するのは ローカルの CLI MCP サーバー アシスタントがプロジェクトのファイルを必要とする場合です。
MCP イベント
セクション「MCP Events」エージェントは、ビルド、バンドルライフサイクル、および update.failure_spike (チャネルのアップデータ失敗率)をサブスクライブし、ポーリングの代わりに署名付きのStandard Webhooksを受信できます。
失敗の急増には、各サブスクリプションが独自の閾値(min_failures, failure_rate_percent, min_checks, window_minutes, cooldown_minutes)を持ちます。Capgoはデフォルト値(10 / 10 / 50 / 15 / 60)を提案します。デバイス数に合わせて調整し、ノイズではなく実際のリグレッションでエージェントがアラートを出せるようにしてください。
詳細は MCP イベント カタログ、急増時のチューニング例、プロトコルメソッド、検証、TTL、制限については、