> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Local Agent Controls

> ルートレベルのベースラインと組織ごとのオーバーライドを使用して、Enterprise 全体の Devin Desktop と Devin CLI の設定を構成します。

Enterprise 管理者は、メンバーによるローカルエージェント ([Devin Desktop](/ja/desktop/devin-local) と [Devin CLI](/ja/cli/enterprise/team-settings)) の利用方法を、次の 2 層構造で設定できます。

* **ルートレベルの設定**では、Enterprise 内のすべての組織に適用されるベースラインを設定します。
* **組織レベルのオーバーライド**では、他の組織に影響を与えずに、特定の組織向けに個々のコントロールを調整できます。

どちらのレベルでも、同じコントロール (機能、モデル、権限とセキュリティ、MCP/ACP、コードベースインテリジェンス、共有、コンプライアンス) を設定できます。このページでは、2 つのレベルがどのように連携するかを説明します。

<Note>
  これらのコントロールは、メンバーのマシン上で実行されるローカルエージェントに適用されます。メンバーがローカルで設定するユーザーレベルまたはプロジェクトレベルの設定よりも優先され、Enterprise で強制されるルールが常に優先されます。各設定とその意味については、[CLI チーム設定](/ja/cli/enterprise/team-settings)を参照してください。
</Note>

<div id="root-level-configuration">
  ## ルートレベルの設定
</div>

ルートレベルの設定は、Enterprise 全体のベースラインです。組織が特定の設定を明示的にオーバーライドしない限り、Enterprise 内のすべての組織がこれらの値を継承します。

Enterprise settings からルートレベルの設定を管理します。

* **Settings → Enterprise → Devin Desktop**

まず、ここで Enterprise 全体のデフォルトを設定します。このレベルで設定した内容は、オーバーライドしていないすべての組織に適用される有効な値になります。

<div id="organization-level-overrides">
  ## 組織レベルのオーバーライド
</div>

<Warning>
  組織固有のオーバーライドを適用するには、ローカルエージェントの請求先を特定の下位組織に割り当てる必要があります。組織レベルのオーバーライドを使用する前に、**アカウントチームに連絡して有効化を依頼してください**。
</Warning>

どの組織でも、管理者は同じ設定ページを開き、その組織に限り個別のコントロールをオーバーライドできます。組織レベルのページでは、各コントロールにルートから継承している現在の値がグレーアウトされ、編集できない状態で表示され、その横に **オーバーライド** アクションが表示されます。

<Steps>
  <Step title="組織の設定を開く">
    組織の **Devin Desktop** 設定ページに移動します。ルートから継承されているコントロールは表示されますが、編集できません。
  </Step>

  <Step title="コントロールをオーバーライドする">
    変更するコントロールの **オーバーライド** をクリックします。コントロールが編集可能になり、その値が組織レベルで設定されます。
  </Step>

  <Step title="継承に戻す">
    オーバーライドされたコントロールの **リセット** をクリックして、オーバーライドを解除します。コントロールは現在のルートレベルの値を再び継承します。
  </Step>
</Steps>

<div id="overrides-are-a-pure-replacement-lists-are-not-merged">
  ### オーバーライドは完全に置き換えられます。リストはマージされません
</div>

組織レベルのオーバーライドでは、そのコントロールのルートレベルの値が**完全に置き換えられます**。これは特に、次のようなリストを含むコントロールで重要です。

* 許可されるモデル
* MCPサーバーと許可リストに登録されたMCPサーバー
* MCP レジストリ URL
* 権限ルール (`allow` / `ask` / `deny`)
* Command の許可リスト／拒否リスト
* サンドボックスのドメイン許可リストと拒否リスト

これらのリスト型コントロールのいずれかをオーバーライドすると、組織のリストが**そのまま**使用されます。ルートレベルのリストとの和集合が取られたり、項目が追加されたり、その他の方法で結合されたりすることはありません。組織レベルで設定した内容が、そのまま有効なリスト全体になります。

<Warning>
  リストはマージではなく置換されるため、組織レベルのオーバーライドでルートリストのエントリが**継承されることはありません**。その組織でもルートのエントリを有効にしたい場合は、オーバーライドに明示的に含めてください。
</Warning>

たとえば、ルートで MCPサーバー `A` と `B` が許可されており、ある組織が許可される MCPサーバーを `C` のみにオーバーライドした場合、その組織のメンバーが利用できるのは `C` のみであり、`A` や `B` は利用できません。

<div id="each-control-is-independent">
  ### 各コントロールは独立しています
</div>

オーバーライドはコントロールごとに適用されます。あるコントロールをオーバーライドしても、他のコントロールには影響しません。

* オーバーライドしたコントロールには、組織レベルの値が適用されます。
* オーバーライドしていないコントロールはすべて、ルートレベルの設定を引き続き継承します。

これにより、組織に必要なコントロールだけをEnterpriseのベースラインから変更し、それ以外はすべてルートと同期した状態に保てます。後でルートレベルの値を変更すると、そのコントロールをオーバーライドしていないすべての組織に変更が反映されます。

<div id="reset-to-inherit">
  ### 継承に戻す
</div>

どのオーバーライドも、**リセット**で解除できます。コントロールをリセットすると、組織レベルの値が削除され、ルートの設定を再び継承するようになります。つまり、オーバーライドされたことがない状態に戻ります。リセットの対象はリセットしたコントロールのみであり、同じ組織内の他のオーバーライドには影響しません。

<div id="when-changes-take-effect">
  ## 変更が反映されるタイミング
</div>

コントロールの変更は即座には適用されません。ルートレベルと組織レベルの値はいずれもキャッシュされるため、更新がメンバーのクライアントに反映されるまでに**最大15分**かかります。

<div id="which-organizations-controls-apply-to-a-user">
  ## ユーザーに適用される組織のコントロール
</div>

Enterprise ユーザーに適用される組織のコントロールは、**プライマリ課金組織**に基づいて設定されます。

プライマリ課金組織は、ユーザーの ローカルエージェント 使用量が請求される組織です。次の順序で決定されます。

1. **明示的な割り当て** — 管理者がユーザーに課金組織を割り当てます。
2. **自動解決** — それ以外の場合、ユーザーがアクセスできる最初の組織 (直接のメンバーシップまたは Identity Provider グループを通じてアクセスできる組織) が使用されます。

実際には、ユーザーにはルートレベルの設定に加え、プライマリ課金組織で設定されたオーバーライドが適用されます。そのため、同じ Enterprise 内のユーザーでも、プライマリ課金組織が異なる場合や異なる設定がオーバーライドされている場合は、実際に適用されるコントロールが異なることがあります。

<Tip>
  組織固有のコントロールを利用する場合は、自動解決に依存せず、**各ユーザーにプライマリ課金組織を明示的に割り当てることを推奨します**。明示的に割り当てることで、各ユーザーにどの組織のオーバーライドが適用されるかを確実に決定できます。
</Tip>

<div id="further-reading">
  ## 関連資料
</div>

* [Devin CLI チーム設定](/ja/cli/enterprise/team-settings) — 各コントロールとその機能
* [Devin Local agent](/ja/desktop/devin-local) — Devin Desktop のローカルエージェント
* [権限](/ja/cli/reference/permissions) — 権限コントロールで使用する権限ルールの構文
* [構成](/ja/cli/reference/configuration/config-file) — ローカル (ユーザー／プロジェクト) 構成と強制適用される設定の関係