Skip to content
← リリースに戻る · 2.1.321
改善 / v2.1.321

layered policyでのmanaged MCPサーバー積算

CHANGELOG 原文(英語)

Changed policy_mode: layered in the Claude apps gateway: managed MCP servers now add up over every matching policy, match: {} included, so a gateway already on it serves more after the upgrade
公式の変更履歴を開く ↗

日本語での補足

Claude apps gatewayのpolicy_mode: layeredを変更。managed MCPサーバーはmatch: {}を含むマッチする全てのポリシーにわたって積算されるようになり、既にこのモードを使っているgatewayは更新後により多くのサーバーを提供する。

ドキュメント

ドキュメントの抜粋(参考訳)

一致するすべてのポリシーを適用する

複数のロールポリシーに一致するユーザーは、policies と並べて policy_mode: layered を設定しない限り、最初に一致したものだけが適用されます。layered にすると、ユーザーに一致するすべてのポリシーが、最初の match: {} ポリシーまで適用されます。

policy_mode には、ゲートウェイサーバー側で Claude Code v2.1.316 以降が必要です。これに対応していないバージョンのゲートウェイは、このキーを見つけると起動を拒否します。キーを追加する前にすべてのレプリカをアップグレードし、以前のバージョンにロールバックする前にキーを削除してください。次の例では、一方のグループが WebFetch を失い、もう一方のグループが Opus を得ます。

managed:
  policy_mode: layered
  policies:
    - match: { groups: [no-web] }
      cli:
        permissions: { deny: ["WebFetch"] }
    - match: { groups: [opus-users] }
      cli:
        availableModels: [opus, sonnet]
    - match: {}
      cli:
        availableModels: [sonnet]
        enforceAvailableModels: true

次の表は、no-web と opus-users の両方に属するユーザーが、デフォルトの first_match と layered のそれぞれで何を受け取るかを示します。

Setting first_match layered
availableModels sonnet opus, sonnet
enforceAvailableModels true true
permissions.deny WebFetch WebFetch

ゲートウェイは、一致した各ポリシーを、その下に列挙されたポリシーに対して、ベースレイヤーと同じマージルールでマージします。

  • 許可リスト、単一の値、sandbox のようなブロック: それを設定している、最初に列挙された一致ポリシーからまるごと適用されるため、2つのグループの availableModels リストは合算されません。
  • 拒否リストとフックの配列: これらは一致するすべてのポリシーで合算されるため、2つのグループに属するユーザーは両方のグループの拒否ルールを受け取ります。
  • env、modelOverrides、skillOverrides: エントリは名前ごとにマージされ、その名前を設定している、最初に列挙された一致ポリシーの値が使われます。
  • desktop のキー: これらはベースの desktop ブロックに関するルールでマージされます。

[!WARNING]

ポリシーを組み合わせると、どのポリシー単体よりも緩いルールになることがあります。例えば、match: {} ポリシーが sandbox.enabled: true を設定し、一方のグループのポリシーが permissions.allow: ["Bash"] を設定し、もう一方のグループのポリシーが sandbox.enabled: false を設定しているとします。両方のグループに属するユーザーは、サンドボックスが無効な状態で Bash を許可されます。このような場合は、Bash を許可するポリシーを先に列挙し、match: {} ポリシーの sandbox ブロック全体をそこにコピーしてください。

layered では、ゲートウェイは一部の設定で起動を拒否します。例えば次のような場合です。

  • ! パターン: いずれかのポリシーの permissions.deny または permissions.ask リストにある Read または Edit ルール内の! 否定(match: {} ポリシーを含む)
  • キャッチオール以外でのフックの制限: match: {} 以外のポリシーにある disableAllHooks、allowedHttpHookUrls、httpHookAllowedEnvVars

取得日 · 2026-11-20

変更の詳細