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