claude-code - 💡(How to fix) Fix [BUG] MCP server configurations in mcpServers (stored per-project in ~/.claude.json) were wiped to {} after a Claude Code update [1 comments, 2 participants]

#1: Claude should warn before updating itself

Error Messages/Logs

TL;DR

The issue can be mitigated by manually backing up the ~/.claude.json file before updating Claude Code to prevent loss of custom MCP server definitions.

Guidance

• Verify that the ~/.claude.json file is being overwritten during the update process by monitoring the file's contents before and after the update.
• Consider creating a backup mechanism for the ~/.claude.json file to prevent data loss in the future.
• Check if there are any configuration options or flags that can be used to prevent Claude Code from wiping the mcpServers settings during an update.
• Reach out to the development team to request a feature to backup local settings before any migration or update.

Example

No code example is provided as it is not explicitly supported by the issue.

Notes

The issue lacks information on the exact update process and the changes made to the ~/.claude.json file. Therefore, the guidance provided is limited to mitigating the issue rather than providing a definitive fix.

Recommendation

Apply workaround: Manually back up the ~/.claude.json file before updating Claude Code to prevent loss of custom MCP server definitions. This is recommended because it provides a safe and reliable way to prevent data loss until a more permanent fix is implemented.