fix: MCP servers belong in ~/.claude.json not settings.json

Claude Code reads mcpServers from ~/.claude.json (global state file),
NOT from ~/.claude/settings.json. The settings.json mcpServers key is
silently ignored for MCP loading. Using claude mcp add --scope user
writes to the correct file.

Also document correct registration commands and scope semantics in
RUNTIME.md so agents and users know how to add MCPs that actually load.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-02 21:31:22 -06:00
parent 2a91f6c202
commit 8b441c17b7
2 changed files with 22 additions and 12 deletions

View File

@@ -236,14 +236,5 @@
"cpan",
"nohup"
],
"enableAllMcpTools": true,
"mcpServers": {
"sequential-thinking": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-sequential-thinking"
]
}
}
"enableAllMcpTools": true
}