Follow Discord
Sweep 09 Oct 2026 · 17:27Z Build v2.1.296 517 read Stable v2.1.287 Latest v2.1.296 Next v2.1.296 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.296 ·

Project .mcp.json files can now be skipped when loading MCP servers

Claude Code has a new condition under which it skips reading project .mcp.json files and uses a server list from elsewhere

Nothing to try yet Improvements
JSON All of v2.1.296
Nothing to try yetTier: how much it should matter to you
2Useful: my rating, 1 to 5
3Signal: worth watching, 1 to 5
MCPArea: what it touches
ImprovementsKind: in v2.1.296,
ImprovementsSection of the release

Unclear What the check tests, and so when project .mcp.json files are skipped, is not stated.

What

MCP servers are external tool servers that give Claude extra tools. Project ones are listed in .mcp.json files, which Claude Code finds by looking in your folder and the folders above it. Before, those files were always read. Now, when a new check passes, Claude Code skips that search and uses a list of servers from another source, with no errors reported.

Why

In practice, project MCP servers defined in .mcp.json may not load in some modes.

How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtWhat the check tests, and so when project `.mcp.json` files are skipped, is not stated.
Anthropic's release notes agreeFixed headless sessions starting a folder's .mcp.json or plugin MCP server that was switched off for that folder, after changing directory…

See this entry in the whole of v2.1.296 →

Feedback