設定のエクスポートおよびインポート

組織設定はポータブルなバンドルとしてエクスポートでき、別の組織に適用可能です。該当項目は以下の場所で確認できます：設定 → データ → 設定をエクスポート。

この機能が利用されるケースは3つあります。既存の組織と同じ構成にするための第2の組織の作成、試用ワークスペースの構成を本番環境に移行する場合、およびワークスペースの構成内容を履歴として残す場合です。

エクスポートされる内容#

このバンドルには組織レベルの構成が含まれます：

インポート処理ではサービスアカウントは作成されません。同名のアカウントが既に存在する場合、そのアカウントが資格のある作業を自動的に開始するかどうかはバンドル内の設定に従います。

エクスポートされない内容#

シークレットは一切エクスポートされません。プロバイダーキー、トークン、認証情報はプレースホルダーとしてエクスポートされます。バンドルにはそれらキーが存在することとその使用先が記録されますが、値自体は含まれません。インポート後には再度シークレットを入力する必要があります。

除外されるのは、構成ではなくワークスペースの識別情報（組織名、メンバー、課金関係）や、タスク、実行履歴、監査イベントなどの運用履歴です。

ルールとして、バンドルはワークスペースが「構成されている」様式を記述するものであり、実際に起きた事象を記述するものではありません。

バンドルの適用方法#

ポータルではバンドルをエクスポートできますが、インポート機能は備わっていません。バンドルを適用するには、HermesなどのエージェントをCoroidのMCPサーバーに接続します。エージェントがバンドルをプレビューした後で適用します。また、スクリーンショット、ファイル、説明内容からバンドルを作成し、組織を構成することも可能です。

バンドルを適用するにはオーナーが所有する接続が必要で、適用の承認はオーナーまたは管理者が行います。coroid.ai上ではこれらの管理ツールはまだ有効化されていません。詳細はMCPを利用した組織設定。

適用前のプレビュー#

バンドルを適用する際にはまずプレビューが実行され、各セクションでの変更内容が表示されます：

プレビュー内容をよく確認してください。needsRebindが最も重要な項目です。これはターゲット環境に同一のものが存在しない設定を指摘するもので、主にリポジトリ接続やシークレットに関するものです。構成が完全に同等になる前にこれらの項目に対処する必要があります。

バンドルをバージョン管理システムに保存する#

エクスポートされたバンドルはファイル形式のため、リポジトリに格納したり差分を確認したりレビューしたりできます。構成をコードとして扱うチームにとって、これは組織ポリシーの変更が単なるクリック操作ではなくレビュー可能な差分となるという価値があります。

シークレットはプレースホルダーとして扱われるため、バンドルをコミットしても問題ありません。ただし、公開する前に自身の構成内に特定情報が含まれていないか確認してください。

関連項目#

• 設定の概要
• プロバイダーキー
• データ保持