cal/claude-memory
1
0
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity
ab43330d67
claude-memory/graph/fixes/claude-code-mcp-user-scope-config-is-claudejson-not-claudemc-f01c17.md

1.5 KiB
Raw Blame History

id type title tags importance confidence created updated
f01c17f0-6641-4d11-98cb-1d182e7e98af fix Claude Code MCP user-scope config is ~/.claude.json, not ~/.claude/.mcp.json
claude-code
mcp
configuration
fix
claude-home
0.8 0.8 2026-02-25T23:12:20.651207+00:00 2026-02-25T23:12:20.651207+00:00

Claude Code MCP User-Scope Config Location

Problem

Confusion about where Claude Code stores user-scoped MCP server configurations. The file ~/.claude/.mcp.json exists but is NOT the authoritative config for user-scoped servers.

Root Cause

The actual user-scoped MCP config lives in ~/.claude.json under the "mcpServers" key. The ~/.claude/.mcp.json file appears to be a legacy or alternate config that may not be reliably loaded by Claude Code.

Fix

Always use the claude mcp CLI to manage user-scoped MCP servers:

# Add a user-scoped MCP server
claude mcp add -s user <name> <command> [args...]

# Remove a user-scoped MCP server
claude mcp remove -s user <name>

# List all MCP servers
claude mcp list

These commands write to ~/.claude.json, which is the correct location.

Current User-Scoped Servers (as of 2026-02-25)

  • cognitive-memory — python3 mcp_server.py (local skill)
  • n8n-mcp — npx n8n-mcp (npm package)
  • gitea-mcp — ~/.local/bin/gitea-mcp (local binary)

Key Takeaway

  • Correct file: ~/.claude.json → "mcpServers" key
  • Wrong file: ~/.claude/.mcp.json (do not use directly)
  • Always use claude mcp add/remove -s user for user-scope changes