{"name":"allowedMcpServers","slug":"allowedmcpservers","family":"setting","title":"Settings keys","noun":"settings key","description":"Allowlist which [MCP servers](\/docs\/en\/mcp.md) users can add","description_source":"docs","described_by":{"doc":"claude-code\/settings-reference","title":"All settings"},"presence":{"first_seen":"2.1.138","removed_in":"2.1.284","in_current_build":false,"newest_mined":"2.1.308","builds":126,"mined_builds":149,"first_cited":{"version":"2.1.248","released_at":"2026-08-27 20:35:36","spans":5}},"aliases":[],"entries":[{"version":"2.1.305","anchor":"managed-mcp-allowlist-doc-var-rule-narrowed","heading":"allowedMcpServers description narrows which managed entries are exempt","line":"The `allowedMcpServers` setting now says managed-mcp.json entries are exempt unless ${VAR} appears in their command, args, url or header values","released_at":"2026-10-20 19:29:36","reason":"found in this entry's text, named in this entry"},{"version":"2.1.288","anchor":"launch-folder-settings-keys-stripped-before-merge","heading":"Sensitive settings from the launch folder can now be dropped before they apply","line":"Unless a launch-folder policy allows them, settings such as enabledPlugins and modelOverrides from the launch folder are now removed","released_at":"2026-10-02 18:30:40","reason":"found in this entry's text"},{"version":"2.1.285","anchor":"managed-settings-helper-merge-doc-allowedproviders-is-a-w","heading":"Managed settings docs: allowedProviders is replaced, not merged","line":"The settings description now says allowedProviders, like the other restriction allowlists, is taken whole from the helper and not merged","released_at":"2026-09-29 17:32:09","reason":"found in this entry's text, named in this entry"},{"version":"2.1.282","anchor":"empty-strictknownmarketplaces-array-now-counts-as-an-activ","heading":"An empty strictKnownMarketplaces list now counts as a restriction","line":"Setting `strictKnownMarketplaces` to an empty list is now treated as a restriction in force, like other managed allowlists","released_at":"2026-09-24 15:56:22","reason":"found in this entry's text"},{"version":"2.1.282","anchor":"parent-process-managed-settings-now-pass-blockedmarketplaces","heading":"Marketplace restrictions now carry over to Claude Code processes started by another","line":"`blockedMarketplaces` and `strictKnownMarketplaces` from managed settings now pass to child Claude Code processes","released_at":"2026-09-24 15:56:22","reason":"found in this entry's text"},{"version":"2.1.282","anchor":"managed-settings-strictknownmarketplaces-added-to-the-admin","heading":"strictKnownMarketplaces is now an admin-only managed setting","line":"strictKnownMarketplaces now joins allowedMcpServers and availableModels as a setting only the admin policy can set, and failed policy loads are tracked","released_at":"2026-09-24 15:56:22","reason":"found in this entry's text"},{"version":"2.1.273","anchor":"enterprise-mcp-server-allowlist-policy-can-now-be-inherited","heading":"Enterprise MCP-server-allowlist policy can now be inherited from lower-priority settings sources","line":"MCP server allowlist policies can now be inherited from lower-priority settings sources, with new diagnostics","released_at":"2026-09-15 18:06:34","reason":"found in this entry's text, named in this entry"},{"version":"2.1.273","anchor":"mcp-server-allowdeny-list-computation-refactored-into-named","heading":"MCP server allow\/deny-list computation refactored into named helpers","line":"Internal code for computing which MCP servers are allowed or blocked was reorganized into separate functions","released_at":"2026-09-15 18:06:34","reason":"found in this entry's text"},{"version":"2.1.273","anchor":"mcp-server-allowlist-can-now-be-sourced-from-admin-tiers-eve","heading":"MCP server allowlist can now be sourced from admin tiers even without an explicit slot override","line":"MCP server allowlist can now fall back to an org admin tier's setting when local settings don't override it","released_at":"2026-09-15 18:06:34","reason":"found in this entry's text, named in this entry"},{"version":"2.1.269","anchor":"fixed-a-bug-in-mcp-server-enumeration-that-ignored-the-calle","heading":"Fixed a bug in MCP server enumeration that ignored the caller's arguments","line":"Fixed a bug where the list of enabled MCP servers ignored the caller's actual allowlist and managed-server settings","released_at":"2026-09-11 18:12:49","reason":"found in this entry's text"}],"entries_total":27,"docs":[{"source":"claude-code","path":"settings-reference","title":"All settings","documented":true},{"source":"claude-code","path":"settings","title":"Claude Code settings","documented":true},{"source":"claude-code","path":"admin-setup","title":"Set up Claude Code for your organization","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"claude-apps-gateway","title":"Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry","documented":false},{"source":"claude-code","path":"managed-mcp","title":"Control MCP server access for your organization","documented":false},{"source":"claude-code","path":"managed-settings","title":"Deploy managed settings","documented":false},{"source":"claude-code","path":"mcp","title":"Connect Claude Code to tools via MCP","documented":false},{"source":"claude-code","path":"monitoring-usage","title":"Monitoring","documented":false},{"source":"claude-code","path":"plugins\/org","title":"Manage Claude Code plugins for your organization","documented":false}],"docs_total":14,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/allowedmcpservers","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}