capgo-organization-management

Capgo 組織管理

CLI から Capgo アカウントと組織を安全に管理します。

以下の情報は、@capgo/cli 8.77（2026年10月）で確認済みです。すべてのコマンドで -a, --apikey を使用できます。

使用する場面

次の場合に使用します。

• サポートへの問い合わせに必要な Capgo アカウント ID またはメールアドレスを確認する場合（account whoami）。
• 組織の一覧表示、作成、名前変更、削除を行う場合。
• メンバーや 2FA の状態を監査する場合、または 2FA、パスワードポリシー、API キーの有効期限、ハッシュ化された API キーを強制する場合。
• アプリを所有する組織を確認する場合（app list --show-org --show-org-id）。
• 組織レベルの 2FA または権限エラーでコマンドが失敗する場合。

次の場合は使用しないでください。

• バンドル、チャンネル、またはロールアウトに関する作業の場合。capgo-release-management を使用してください。
• ネイティブのクラウドビルドが必要な場合。capgo-native-builds を使用してください。
• エージェントを Capgo アカウントに接続したい場合（MCP）。capgo-cli-usage を使用してください。

コマンド一覧

目的	コマンド（npx @capgo/cli@latest ...）
自分のアカウントを確認	account whoami（エイリアス account id）
組織の一覧表示	organization list
組織の作成	organization add --name "My Company" --email [email protected]
メンバーと 2FA の状態	organization members ORG_ID（2FA の状態の確認には super_admin が必要）
名前／メールアドレスの変更	organization set ORG_ID --name "New Name" --email [email protected]
2FA の強制	organization set ORG_ID --enforce-2fa（解除するには --no-enforce-2fa）
パスワードポリシー	organization set ORG_ID --password-policy --min-length 12 --require-uppercase --require-number --require-special
API キーの有効期限	organization set ORG_ID --require-apikey-expiration --max-apikey-expiration-days 90（1～365）
ハッシュ化された API キー	organization set ORG_ID --enforce-hashed-api-keys
組織ごとのアプリ	app list --show-org --show-org-id または app list --filter-by-org-id ORG_ID --output-text
組織の削除	organization delete ORG_ID（オーナーのみ、取り消し不可）

organization を使用してください。organisation の表記は非推奨で、今後削除されます。

手順

1. 対象範囲とロールを確認する

npx @capgo/cli@latest account whoami
npx @capgo/cli@latest organization list

対象の ORG_ID を確認してください。セキュリティ設定には super_admin ロールが必要です。組織の削除にはオーナー権限が必要です。

2. 強制する前に確認する

npx @capgo/cli@latest organization members ORG_ID

2FA が無効なメンバーを一覧表示し、強制する前にユーザーへ報告してください。2FA を強制すると、対象メンバーは 2FA を有効にするまで CLI と API にアクセスできなくなります。

3. ポリシーを一度に1つ変更する

organization set の変更を1つ適用して確認してから、次の変更に進んでください。組織がロックアウトされないよう、2FA が有効で有効なキーを持つ管理者を少なくとも1人確保してください。

4. API キーポリシーの副作用

• --require-apikey-expiration ／ --max-apikey-expiration-days は新しいキーに適用されます。ホスト型 MCP が OAuth 用に作成するキー（MCP · <client>）の有効期限はすでに最長90日で、組織の制限がより厳しい場合はそちらが優先されます。
• --enforce-hashed-api-keys を有効にすると、キーは作成時に一度だけ表示されます。既存の CI シークレットは引き続き機能しますが、キーを紛失した場合は再作成が必要です。

注意事項

• organization delete は取り消せず、オーナーのみが実行できます。まず app list --filter-by-org-id ORG_ID を実行し、ユーザーがその組織に何があるかを確認できるようにしてから、組織名を明示して確認を取ってください。
• organization members で 2FA の状態を表示するには super_admin が必要です。下位のロールでは一部のデータしか表示されません。
• 管理作業のために、ユーザーに API キーをチャットへ貼り付けるよう求めないでください。代わりに npx @capgo/cli@latest login を実行するか、シェルで CAPGO_TOKEN を設定してもらってください。

確認

1. もう一度 organization list を実行します。名前とメールアドレスの変更が反映されています。
2. 2FA を強制した後、もう一度 organization members ORG_ID を実行します。残っているすべてのメンバーで 2FA が有効になっています。
3. 管理者ではないメンバーのキーを使って、読み取り専用のコマンド（例：app list）を実行します。そのメンバーが 2FA を有効にした後であれば、コマンドは成功するはずです。

エラー処理

文字列	対処方法
🔐 Access Denied: Two-Factor Authentication Required / This organization requires all members to have 2FA enabled.	https://console.capgo.app（アカウント設定）で2FAを有効にしてから、再試行してください。ドキュメント：https://capgo.app/docs/webapp/2fa-enforcement/
Insufficient permissions for <key>	操作を行うユーザーまたはキーに必要なロールがありません。セキュリティ設定には super_admin が必要です。削除にはオーナー権限が必要です
No organizations available	キーのユーザーにはまだ組織がありません。organization add で作成してください
No Capgo API key found. Run ... first, then retry this command.	npx @capgo/cli@latest login を実行するか、CAPGO_TOKEN を設定するか、-a を渡してください

リソース

• 組織リファレンス：https://capgo.app/docs/cli/reference/organization/
• アカウントリファレンス：https://capgo.app/docs/cli/reference/account/
• 2FA の適用：https://capgo.app/docs/webapp/2fa-enforcement/