Skip to content

Commit f0541d5

Browse files
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_013u46KPovSoGvJBAxyJiFoX
1 parent 97b5a79 commit f0541d5

3 files changed

Lines changed: 9 additions & 7 deletions

File tree

‎CLAUDE.md‎

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
**Project:** Claude Workflow Engine
44
**Version:** 2.1.0
55
**Type:** LangGraph Orchestration Pipeline with Call Graph Intelligence + Template Fast-Path
6-
**Last Updated:** 2026-08-07
6+
**Last Updated:** 2026-09-13
77

88
---
99

@@ -233,8 +233,10 @@ unversioned: if that machine is lost, so are they.
233233

234234
All 13 MCP servers have been extracted to individual private repos under
235235
[`techdeveloper-org`](https://github.com/orgs/techdeveloper-org/repositories)
236-
for independent versioning, testing, and reuse. Each is registered in `~/.claude/settings.json`
237-
and points to `mcp-{name}/server.py` in the local workspace.
236+
for independent versioning, testing, and reuse. Each is registered at user scope in `~/.claude.json`
237+
(via `claude mcp add --scope user`) and points to `mcp-{name}/server.py` in the local workspace.
238+
Claude Code does not load MCP servers from `~/.claude/settings.json`; a server declared only there
239+
never starts (#321).
238240

239241
> **Note:** `session-mgr` also keeps an in-engine copy in `src/mcp/` because
240242
> it is imported in-process by `session_hooks.py`.
@@ -455,7 +457,7 @@ See environment variables in `.env.example`:
455457

456458
---
457459

458-
**Last Updated:** 2026-08-07
460+
**Last Updated:** 2026-09-13
459461

460462

461463
<!-- execution-insight- -->

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -850,4 +850,4 @@ Key rules:
850850

851851
---
852852

853-
**Version:** 2.1.0 | **Last Updated:** 2026-08-10
853+
**Version:** 2.1.0 | **Last Updated:** 2026-09-13

‎SRS.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
**Project:** Claude Workflow Engine
44
**Version:** 2.1.0
5-
**Date:** 2026-08-07
5+
**Date:** 2026-09-13
66
**Author:** Claude Workflow Engine Team
77

88
---
@@ -1189,7 +1189,7 @@ User Prompt
11891189

11901190
---
11911191

1192-
**Last Updated:** 2026-08-07
1192+
**Last Updated:** 2026-09-13
11931193
**Next Review:** 2026-06-21
11941194

11951195
---

0 commit comments

Comments
 (0)