claude-memory/graph/configurations/mcp-servers-go-in-claudejson-not-claudemcpjson-d746c5.md

1.6 KiB

id type title tags importance confidence created updated relations
d746c584-c625-4710-b2a7-bba205e2e92d configuration MCP servers go in ~/.claude.json, NOT ~/.claude/.mcp.json
claude-code
mcp
configuration
troubleshooting
0.9 0.8 2026-03-02T02:14:27.994062+00:00 2026-03-02T02:14:29.458261+00:00
target type direction strength edge_id
f01c17f0-6641-4d11-98cb-1d182e7e98af RELATED_TO outgoing 0.86 68659ca8-6d75-48d8-8de0-3f8b5f7b4e7e
target type direction strength edge_id
b3c2d454-3b8e-4d3d-b24c-6241f12d03e6 RELATED_TO outgoing 0.85 94d49cef-b3c7-4721-a856-2bfc3158d323
target type direction strength edge_id
a2488459-bc9e-4005-969c-44eef486ebc2 RELATED_TO outgoing 0.87 afaa906e-805f-4e2e-8b52-0ac2659cfe54

Claude Code MCP Server Configuration Location

Global MCP servers must be defined in ~/.claude.json under the top-level mcpServers key.

~/.claude/.mcp.json is NOT read by Claude Code for global servers. Servers placed there will silently fail to register.

Correct locations:

  1. Global (always-on): ~/.claude.jsonmcpServers key (cognitive-memory, gitea-mcp, n8n-mcp, tui-driver)
  2. Project (on-demand): <project-root>/.mcp.jsonmcpServers key

How to add a global MCP server:

  • Edit ~/.claude.json and add to the mcpServers object, OR
  • Use claude mcp add <name> -- <command> [args]

Discovered 2026-03-01

tui-driver was configured in ~/.claude/.mcp.json and silently failed to load. Moving it to ~/.claude.json fixed registration.