Follow Discord
Sweep 10 Nov 2026 · 02:18Z Build v2.1.322 539 read Stable v2.1.311 Latest v2.1.322 Next v2.1.322 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeReleasesv2.1.283entry #146

Claude Code v2.1.283 ·

claude mcp add and claude mcp remove now check that the change was saved

After adding or removing a user or local MCP server, Claude Code rereads its config file and fails with an error if the change did not stick

You'll notice Improvements
JSON All of v2.1.283
You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
MCPArea: what it touches
ImprovementsKind: in v2.1.283,
ImprovementsSection of the release

Unclear It is not confirmed that the check runs for both user-scope and local-scope servers.

What

An MCP server is an outside program that gives Claude extra tools. When you add or remove a user-scope or local-scope MCP server, Claude Code saves the change to its global configuration file. When that save step does not report success, Claude Code now reads the file back to check the result, retrying if the read fails.

  • If the server is missing after adding it, or still there after removing it, the command fails with MCP server "<name>" was not saved to followed by the file's location. The message suggests the file may be read-only or protected by a sandbox, which is a restricted environment that limits which files a program can change. It tells you to make the file writable or run the command outside the sandbox.
  • If the file cannot be read back at all, the command warns that the change may not have been saved.
Why

A save that quietly did nothing, for example inside a sandbox, used to look like it had worked. You now find out straight away and know which file to look at.

Read from
Names in the bundleclaude mcp addclaude mcp remove
Since it was published

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 Connect Claude Code to tools via MCP touched a line naming claude mcp add after this was published. * **Reserved names**: Claude Code reserves the names of its built-in servers, including `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview`, and `Claude Browser`. If your configuration defines a server with a reserved name, C… mcp see the edit
Confirmed since Anthropic's documentation has since written up claude mcp remove, on Claude Code changelog. * Fixed `claude mcp list` and `claude mcp get`, and the not-found error of `claude mcp remove`, `login` and `logout`, printing line breaks and terminal escape sequences from MCP server names and values changelog see the edit
Confirmed since Anthropic's documentation has since written up claude mcp add, on Claude Code changelog. * Fixed `claude mcp add` reporting success when managed settings restrict MCP servers to plugins; it now refuses and says what to do, instead of saving a server that never loads changelog see the edit
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 doubtIt is not confirmed that the check runs for both user-scope and local-scope servers.
Anthropic's documentation agreesAnthropic's documentation has since written up claude mcp add, on Claude Code changelog.
Anthropic's release notes agreeFixed claude mcp add, add-json, and remove reporting success when the user or local config file could not be written, for example inside a…

See this entry in the whole of v2.1.283 →

Feedback