What
Two settings keys, allowedMcpServers and deniedMcpServers, are now paired with validation schemas in a table, so MCP servers can be permitted or blocked from settings files.
Details
- New arrays group the settings tiers:
policySettings,flagSettingsanduserSettingson one side,localSettingsandprojectSettingson the other, with a map labelling the first threepolicy,flaganduser. - A separate map ties the decisions
allow,denyandaskto the rule listsalwaysAllowRules,alwaysDenyRulesandalwaysAskRules.
Evidence
{ key: "allowedMcpServers", schema: tzt }
Strings lifted out of the shipped bundle, so the claim above can be checked against them.
Names in the bundleallowedMcpServersdeniedMcpServers
The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.
Added since
A small documentation edit on Control MCP server access for your organization touched a line naming deniedMcpServers after this was published.
* [Server-managed settings](/docs/en/server-managed-settings): deliver `allowedMcpServers` and `deniedMcpServers` from the claude.ai admin consolemanaged-mcp see the edit
Added since
A small documentation edit on Control MCP server access for your organization touched a line naming allowedMcpServers after this was published.
* [Server-managed settings](/docs/en/server-managed-settings): deliver `allowedMcpServers` and `deniedMcpServers` from the claude.ai admin consolemanaged-mcp see the edit
Confirmed since
Anthropic's documentation has since written up deniedMcpServers, on Claude Code changelog.
* Fixed `allowManagedMcpServersOnly`, `deniedMcpServers` and `disableClaudeAiConnectors` set via MDM or `managed-settings.json` being ignored when server-managed settings are also presentchangelog see the edit
Confirmed since
Anthropic's documentation has since written up allowedMcpServers, on All settings.
| Restriction allowlists | Takes the list whole from the highest source that sets it, without adding entries from lower sources. When the highest source doesn't set one, takes it whole from the next source down | [`availableModels`](#avail…settings-reference see the edit
One source agreesOne thing we can check says the same as this entry.
Anthropic's documentation agrees
Anthropic's documentation has since written up allowedMcpServers, on All settings.