メインコンテンツへスキップ

ホスト型 MCP サーバー

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のログインフローを自分で検出し、サーバーを初めて使うときに同意ページを開きます。

  1. 開く 設定 → コネクタ を選択します カスタムコネクタを追加.
  2. 名前を付ける Capgo をコピーして、 https://api.capgo.app/mcp をURLとして貼り付けてください。
  3. クリック 接続して、 同意画面が開いたら Capgo にサインインしてください。

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

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 コンソールのキーページ。クライアントはアクセス権を失い、再接続するには再度同意ページを経由する必要があります。

ホスト型サーバーは、以下の領域でアカウントツールを公開します:

項目カバー範囲
アカウントと組織Who am I、組織、メンバーと招待、監査ログ、API キー
アプリアプリの一覧表示、作成、更新、削除
Bundle署名付きURLでアップロードを準備、バンドル一覧、メタデータ更新、削除、使用状況の確認
ChannelとロールアウトChannelの作成・更新、ChannelへのBundle設定、段階的なロールアウト(一時停止、昇格、ロールバック)、自動一時停止
デバイスデバイスの一覧表示と詳細確認、Channelオーバーライドの設定・解除
統計情報とObserveアプリ、組織、アカウントの統計、更新状況の確認 Observe
Native Buildビルドのリクエスト、アップロード、開始、保存済み認証情報の管理、ステータスと有界ログスナップショットの読み取り、ビルドのキャンセル
WebhookWebhookの作成、更新、テスト、削除、配信の確認と再試行
MCP イベント署名付き HTTPS Webhook を介して、ビルド、バンドル、およびアップデーターの障害スパイクイベントを購読します(MCP イベント)
プッシュ通知通知設定、プロバイダー、キャンペーン、通知の送信、統計

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

OpenAI などのリモート MCP クライアントは、ツールアノテーション (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) を参照して、ツール実行前に確認を求めるタイミングを判断します。ホスト型サーバーは、これらのヒントが各ツールの実際の動作と一致するように保ちます。

ツールアノテーション備考
capgo_prepare_bundle_uploaddestructiveHint: true未完成のバージョンと署名付きアップロード URL を作成できます。 version_exists_ok が true でバージョンが既に存在する場合、レスポンスは { skipped: true, reason: "VERSION_EXISTS" } となり、アップロード URL は含まれません: 処理を停止し、PUT を実行したり capgo_complete_bundle_upload.
capgo_prepare_build_credentials_uploaddestructiveHint: true暗号化された認証情報用の署名付き PUT URL を返します。省略すると mode デフォルトでは replace、PUT 後にそのプラットフォームの保存済みキーを上書きします。アップロード前にユーザーに確認してください。 mode: merge JSON に存在するキーのみを更新します。
capgo_get_build_statusreadOnlyHint: 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: true
  • timeout_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 契約 を参照してください。フィールド、権限、制限について。

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 クライアントローカルプロセスを起動できるデスクトップおよびターミナルエージェント
アカウント管理アプリ、バンドル、チャネル、ロールアウト、デバイス、統計、Observe、ビルド、Webhook、通知アプリ、バンドル、チャネル、組織、統計、Observe、クラウドビルドのステータスとログ
ビルドフォルダからバンドルをアップロードローカルエージェントがファイルをパッケージ化した後、アップロードと署名付き URL を準備はい
Native Buildをリクエストローカルエージェントがプロジェクトをパッケージ化した後のリクエスト/アップロード/開始はい
doctor, probe、プロジェクトとの互換性チェックいいえはい

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

エージェントは、ビルド、バンドルライフサイクル、および update.failure_spike (チャネルのアップデータ失敗率)をサブスクライブし、ポーリングの代わりに署名付きのStandard Webhooksを受信できます。

失敗の急増には、各サブスクリプションが独自の閾値(min_failures, failure_rate_percent, min_checks, window_minutes, cooldown_minutes)を持ちます。Capgoはデフォルト値(10 / 10 / 50 / 15 / 60)を提案します。デバイス数に合わせて調整し、ノイズではなく実際のリグレッションでエージェントがアラートを出せるようにしてください。

詳細は MCP イベント カタログ、急増時のチューニング例、プロトコルメソッド、検証、TTL、制限については、