allowedMcpServers

A Claude Code settings key, read out of the shipped bundle. It has been in the build since v2.1.138, including the newest one read.

What it is

Presence across releases

A row reading never mined is a release with no archived bundle behind it. Nothing was read out of it, so nothing here says whether the name was in it. A declared type or a default is only ever what that release's own bundle stated.

Changelog entries naming it

1. v2.1.248MCP server allow and deny lists get settings keys

   You can allow or block specific MCP servers with allowedMcpServers and deniedMcpServers settings.

   named in this entry

2. v2.1.242Eval runs fail loudly when managed policy blocks the mock servers

   Eval runs stop with a clear policy error when your org's MCP rules block the mock servers.

   named in this entry

3. v2.1.223Managed-settings tier merge no longer falls through for two keys

   Two admin-managed settings now come only from the top policy tier, so lower tiers can't sneak values in.

   named in this entry

4. v2.1.221New MCP policy-predicate telemetry for allowedMcpServers matching

   Claude now tracks whether your allowed-MCP-server rules could actually be evaluated.

   named in this entry

5. v2.1.219MCP policy allow/deny entries now expand ${VAR} environment references, and unsafe URL expansions fail closed

   MCP allow and deny policy entries now expand ${VAR} references, skipping allowlist entries whose expansion looks unsafe.

   named in this entry

6. v2.1.219MCP allow/deny rules compare expanded env-var values

   Your MCP allow and deny rules now match servers whose commands or URLs use environment variables.

   named in this entry

Documentation pages

• Claude Code settings reference reference table Claude Code CLI
• Claude Code settings reference table Claude Code CLI
• Set up Claude Code for your organization mentions it Claude Code CLI
• Claude Code changelog mentions it Claude Code CLI
• Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry mentions it Claude Code CLI
• Control MCP server access for your organization mentions it Claude Code CLI
• Deploy managed settings mentions it Claude Code CLI
• Connect Claude Code to tools via MCP mentions it Claude Code CLI
• Deploy self-hosted environments to production mentions it Claude Code CLI
• Configure server-managed settings mentions it Claude Code CLI
• Example settings files mentions it Claude Code CLI
• Create custom subagents mentions it Claude Code CLI
• Code in Claude Desktop on 3P mentions it Claude Documentation

A reference table page is one whose own table defines this name, and it is where the description above came from. A page that mentions it carries the name somewhere in its text and may say nothing about it at all. Every page carrying it.

Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.