.mcp.json vs ~/.claude.json
People think every MCP server lives in .mcp.json. Only the team's do. A server you add for yourself, in one project or in all of them, is saved in ~/.claude.json in your home folder. So .mcp.json goes into git and every teammate sees it, while ~/.claude.json never leaves your machine.
.mcp.json
A file in a project that lists MCP servers the team shares.
.mcp.json is a file in a project's root that lists MCP servers for the whole team. It is what claude mcp add writes when you use --scope project, and it is meant to be committed. Before using a server from it, Claude Code asks each person to approve it. Servers you add for yourself go in ~/.claude.json instead.
~/.claude.json
A file Claude Code writes for itself. It holds your account and MCP servers.
~/.claude.json is a file in your home folder that Claude Code writes for itself. It holds your account details and the MCP servers you added for yourself. It also holds state, such as which folders you trust, and global config keys that /config sets. It sits next to the ~/.claude folder, not inside it. If it breaks, Claude Code saves a copy in ~/.claude/backups.
In one line
- .mcp.json
- A file in a project that lists MCP servers the team shares.
- ~/.claude.json
- A file Claude Code writes for itself. It holds your account and MCP servers.