Sweep 19 Sep 2026 · 02:36Z Build v2.1.278 500 read Stable v2.1.267 Latest v2.1.278 Next v2.1.278 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.271 ·

Enterprise-managed MCP config now degrades gracefully when it can't be read

When an org's managed MCP or settings policy file is broken or unreadable, Claude Code fails closed with a clear explanation instead of an unclear failure

TierYou'll noticehow much it should matter to you
Useful2my rating, 1 to 5
Signal1worth watching, 1 to 5
AreaMCPwhat it touches
KindImprovementsin v2.1.271,
Group of 7 You'll notice

When an org's managed MCP or settings policy file is broken or unreadable, Claude Code fails closed with a clear explanation instead of an unclear failure

What

  • If the enterprise-managed MCP configuration (which controls which MCP servers are allowed) is unreadable or fails to parse, Claude Code now says so explicitly, with a message like "Enterprise MCP config ... cannot be read or parsed (...), so it keeps exclusive control."
  • When the managed config is valid, dynamically-configured MCP servers that conflict with it are still refused as before; when the managed config is broken, individual conflicting servers are instead dropped one at a time (with a warning listing which ones), rather than refusing the whole run.
  • A new unusableManagedMcpConfigMessage app-state field surfaces this parse failure in the UI.
  • More generally, managed/enterprise settings loading now reports parse and read errors via a fatalErrors() method, and unreadable managed settings makes hook editing (edit_hook) refuse every edit and locks host editing controls.
  • New schema fields policyUnreadable (on the hook-editing status) and remote_control_policy_lock_reason (explaining why org policy locks remoteControlAtStartup) describe this same fail-closed behavior.

Why Previously a broken or unreadable enterprise policy file could produce a confusing, undifferentiated failure. Now Claude Code fails closed (locking things down rather than silently ignoring policy) but tells the user specifically what's wrong, so admins and users can fix the underlying config instead of guessing.

See this entry in the whole of v2.1.271 →