Repository navigation
Commit f0541d5
docs: MCP servers are registered in ~/.claude.json, not settings.json (#321)
CLAUDE.md's "MCP Servers" section stated that every server "is registered
in ~/.claude/settings.json". Claude Code never loads MCP servers from
settings.json -- only from ~/.claude.json (user/local scope, written by
`claude mcp add`) or a project .mcp.json. The false claim had real
consequences on the maintainer machine:
- push-gate was declared only in the settings.json mcpServers block, so it
never started; it has been re-registered with
`claude mcp add --scope user push-gate`.
- figma-api's FIGMA_ACCESS_TOKEN lived only in that inert block, so the live
figma-api server ran with no token; it was copied into ~/.claude.json.
- the 26-server inert block has been removed from ~/.claude/settings.json.
Changes in this commit:
- CLAUDE.md: the MCP Servers section now names ~/.claude.json and
`claude mcp add --scope user`, and says a server declared only in
settings.json never starts.
- CLAUDE.md, README.md, SRS.md: "Last Updated" / "Date" bumped from
2026-08-07 / 2026-08-10 to 2026-09-13, to reflect the #320 standards
removal and this fix (the bumps were already pending in the working tree).
No code changes.
Closes #321
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013u46KPovSoGvJBAxyJiFoX1 parent 97b5a79 commit f0541d5
3 files changed
Lines changed: 9 additions & 7 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
3 | 3 | | |
4 | 4 | | |
5 | 5 | | |
6 | | - | |
| 6 | + | |
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
| |||
233 | 233 | | |
234 | 234 | | |
235 | 235 | | |
236 | | - | |
237 | | - | |
| 236 | + | |
| 237 | + | |
| 238 | + | |
| 239 | + | |
238 | 240 | | |
239 | 241 | | |
240 | 242 | | |
| |||
455 | 457 | | |
456 | 458 | | |
457 | 459 | | |
458 | | - | |
| 460 | + | |
459 | 461 | | |
460 | 462 | | |
461 | 463 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
850 | 850 | | |
851 | 851 | | |
852 | 852 | | |
853 | | - | |
| 853 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
5 | | - | |
| 5 | + | |
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
| |||
1189 | 1189 | | |
1190 | 1190 | | |
1191 | 1191 | | |
1192 | | - | |
| 1192 | + | |
1193 | 1193 | | |
1194 | 1194 | | |
1195 | 1195 | | |
0 commit comments