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 tofollowed 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.
Names in the bundleclaude mcp addclaude mcp remove
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubt
It is not confirmed that the check runs for both user-scope and local-scope servers.
Anthropic's release notes agree
Fixed claude mcp add, add-json, and remove reporting success when the user or local config file could not be written, for example inside a…