capgo-cli-usage

Capgo CLI の使い方

Capgo CLI のリクエストを適切に振り分け、CLI を認証し、エージェントを Capgo に接続します。

以下の情報は @capgo/cli 8.77（2026年10月）に基づいて確認済みです。あまり使われないフラグを頼りにする前に、必ず npx @capgo/cli@latest <command> --help を実行してください。

使用する場面

次の場合に使用します。

• ユーザーが「Capgo CLI の使い方を教えて」「X を実行する Capgo コマンドはどれですか」などと尋ねる場合、または CLI のログインや認証について尋ねる場合。
• Claude、Cursor、ChatGPT、または別のエージェントを Capgo アカウントに接続したい場合（MCP）。
• Capgo の複数の領域にまたがるリクエストで、適切なサブスキルがまだ明確でない場合。
• CLI が作業を開始する前に失敗する場合（認証、ディレクトリの誤り、appId の不足）。

次のいずれかに該当する場合は使用しないでください。対象範囲が明確になったら、すぐに該当するものへ切り替えてください。

• アプリのアップデーターの配線、notifyAppReady、または autoUpdate：capgo-live-updates
• バンドルのアップロード、チャンネル、段階的リリース、ロールバック、または暗号化キー：capgo-release-management
• ネイティブのクラウドビルドと署名：capgo-native-builds
• 組織、メンバー、2FA、またはセキュリティポリシー：capgo-organization-management
• Capgo の複数製品のプラン（ビルド、OTA、ストア）：capgo-cloud
• Capgo ではなく、Ionic または Capacitor 独自の MCP ツール：capacitor-mcp

シークレットと確認

• Capgo API キー、署名パスワード、.p8 キー、キーストア、またはサービスアカウントの JSON をチャットに貼り付けるようユーザーに求めないでください。ユーザー自身に npx @capgo/cli@latest login を実行してもらう（ブラウザーが開くか、マスクされたプロンプトでキーの入力を求められます）か、シェルまたは CI のシークレットストアに CAPGO_TOKEN を設定してもらいます。
• シークレットをコマンド引数に含めないでください。シェルの履歴やプロセスリストに残るためです。環境変数、保存済みのログイン情報、または CLI の対話型プロンプトを使用します。
• それでも会話にシークレットが現れた場合は、繰り返したり、ファイルに書き込んだりせず、ユーザーに失効させて新しいものを作成するよう伝えてください。
• npx @capgo/cli@latest は、npm から最新の CLI をダウンロードして実行します。ユーザーのプロジェクト内で、ユーザーの許可を得てからのみ実行してください。CI では正確なバージョンを固定します。
• リモートの状態を変更するコマンド（バンドルのアップロード、チャンネルの変更または昇格、アプリ・バンドル・チャンネル・キーの削除、ストアにアップロードするビルドのリクエスト、認証情報のエクスポートまたは削除）を実行する前に確認してください。何がどのアプリやチャンネルで変更されるかを伝えます。

コマンド一覧

グループ	コマンド	スキル
セットアップ	init [apikey] [appId]、login [apikey] [--local]、doctor、probe --platform ios|android	このスキル / capgo-live-updates
アプリ	app add、app list、app set、app delete、app debug、app setting、app todo	このスキル
バンドル	bundle upload|list|delete|cleanup|compatibility|releaseType|zip|encrypt|decrypt	capgo-release-management
チャンネル	channel add、channel list、channel set、channel promote、channel currentBundle、channel delete	capgo-release-management
キー	key create|save|delete_old	capgo-release-management
プレビュー	get-qr [appId] --bundle|--channel	capgo-release-management
ネイティブビルド	build init|request|prescan|needed|last-output|sync-ios-version|credentials ...	capgo-native-builds
アカウント / 組織	account whoami、organization list、organization add、organization members、organization set、organization delete	capgo-organization-management
監視	observe summary|metrics|events|device|versions|routes	このスキル
プッシュ通知	notifications setup [appId]	capacitor-push-notifications
デバイス	run device [ios|android] [--no-launch]	このスキル
エージェント	mcp	このスキル

これらのコマンドは存在しません。提案しないでください。capgo upload（bundle upload を使用）、channel create（channel add を使用）、bundle revert（channel set --bundle を使用）、key verify、upload --sign。

認証

ユーザーがログインを実行します。ブラウザーが開いてキーを作成するか、マスクされた入力欄でキーの入力を求められます。

npx @capgo/cli@latest login          # saves to ~/.capgo
npx @capgo/cli@latest login --local  # saves to ./.capgo (git-ignored)

CLI は次の順序でキーを選択します。

1. コマンドの -a, --apikey <key>
2. CAPGO_TOKEN 環境変数（CI ではこれを使用します）
3. ~/.capgo（グローバル）
4. ./.capgo（プロジェクト）

注意：グローバルキーはプロジェクトキーより優先されます。別のアカウントを強制的に使用するには、CAPGO_TOKEN 環境変数を設定してください。キーは https://console.capgo.app/dashboard/apikeys で作成できます。

セルフホスト可能なバックエンドの場合、対応するコマンドに --supa-host <url> --supa-anon <key> を追加してください。

エージェントを Capgo に接続する（MCP）

Capgo には 2 つの MCP サーバーがあります。利用可能な場合は、両方を使用してください。

• ホステッド MCP：https://api.capgo.app/mcp（ストリーム可能な HTTP）。インストールは不要です。クライアントは OAuth でサインインするか、Authorization: Bearer <Capgo API key> を送信します。ホステッド MCP には破壊的な操作を行うツールが含まれているため、タスクに必要な最小限の権限の API キーを使用してください（レポート作成には読み取り専用）。アプリ、バンドル、チャンネル、段階的ロールアウト、デバイス、統計情報、Observe のアップデートの健全性、ネイティブビルドのステータスとログ、Webhook、プッシュ通知に対応しています。Claude Code の例：claude mcp add --transport http capgo https://api.capgo.app/mcp を実行し、その後 /mcp でサインインします。各 OAuth クライアントには専用の MCP · <client name> API キーが発行され、有効期限は最長 90 日です。コンソールでそのキーを削除すると、クライアントを取り消せます。
• ローカル CLI MCP：npx @capgo/cli@latest mcp（stdio、login で認証）。ビルドフォルダーからバンドルをアップロードしたり、ネイティブビルドをリクエストしたり、ローカルプロジェクトファイルに対して doctor、probe、互換性チェックを実行したりする場合に使用します。ホステッド MCP はローカルファイルを読み取れません。

ローカルサーバー用の Claude Desktop 設定：

{ "mcpServers": { "capgo": { "command": "npx", "args": ["@capgo/cli@latest", "mcp"] } } }

両方のサーバーのセットアップガイド：https://capgo.app/mcp（MCP エンドポイントではなく、ページです）。

Capgo アカウントをまだお持ちでない場合は、https://console.capgo.app で登録してください（14 日間の無料トライアル、クレジットカード不要）。ドキュメント：https://capgo.app/docs/ai/mcp/

診断のクイックパス

npx @capgo/cli@latest doctor                         # versions + setup problems (add --package-json for monorepos)
npx @capgo/cli@latest app todo com.example.app       # onboarding checklist: done, skipped, pending
npx @capgo/cli@latest probe --platform android       # would the backend serve an update to this config?
npx @capgo/cli@latest app debug com.example.app      # live update events from a device
npx @capgo/cli@latest observe summary --days 7       # launch, crash, WebView findings, each with a next view

observe にセッション ID はありません。1 台のデバイスのタイムラインを取得するには、observe device DEVICE_ID --json を使用してください。

モノレポ

--package-json、--node-modules を使用し、ルート設定が動的な場合は --capacitor-config <path> も使用してください。次の例のように、環境セレクターを有効なままにしてください：CAP_APP=web npx @capgo/cli@latest init --capacitor-config ./env-configs/capacitor.config.web.ts。

検証

• npx @capgo/cli@latest account whoami を実行すると、想定されるアカウント ID とメールアドレスが表示され、認証が機能していることを確認できます。
• npx @capgo/cli@latest app list にアプリが表示されます。表示されない場合は、app add を実行してください。
• MCP：Claude Code で /mcp を実行すると、接続済みとして capgo が一覧表示されます。また、読み取り専用のプロンプト（「Capgo アプリを一覧表示して」）を実行すると、データが返されます。

エラー処理

文字列	対処方法
No Capgo API key found. Run \...` first, then retry this command.`	ユーザーが npx @capgo/cli@latest login を実行するか、CAPGO_TOKEN 環境変数を設定します
Missing argument, you need to provide a appId, or be in a capacitor project	appId を位置引数として渡すか、capacitor.config.* を含むフォルダーから実行します
Insufficient permissions for <key>	キーのロールでは、このアプリまたは組織に対する権限が不足しています。必要なロールを持つキーを使用してください
🔐 Access Denied: Two-Factor Authentication Required	組織で 2FA が必須になっています。capgo-organization-management を参照してください
App <id> not found in database	npx @capgo/cli@latest app add <id> を実行するか、アクティブなアカウントを確認してください
使用するアカウントが違う	グローバルの ~/.capgo はローカルの .capgo より優先されます。CAPGO_TOKEN を設定してください

リソース

• CLI コマンド：https://capgo.app/docs/cli/commands/
• ホステッド MCP：https://capgo.app/docs/ai/mcp/
• ローカル MCP：https://capgo.app/docs/cli/reference/mcp/