Skip to content

Fix Claude global MCP config path: ~/.claude/mcp.json → ~/.claude.json#269

Closed
CheeYuTan wants to merge 1 commit intodatabricks-solutions:mainfrom
CheeYuTan:fix/claude-mcp-config-path
Closed

Fix Claude global MCP config path: ~/.claude/mcp.json → ~/.claude.json#269
CheeYuTan wants to merge 1 commit intodatabricks-solutions:mainfrom
CheeYuTan:fix/claude-mcp-config-path

Conversation

@CheeYuTan
Copy link
Contributor

Summary

  • Fixes the Claude global MCP config path in install.sh
  • Was writing to ~/.claude/mcp.json but Claude Code expects ~/.claude.json per official docs
  • Project-level path (.mcp.json) is unaffected

Fixes #203

Test proof

Verified the fix by inspecting the installer logic:

# Before (line 896):
[ "$SCOPE" = "global" ] && write_mcp_json "$HOME/.claude/mcp.json" || write_mcp_json "$base_dir/.mcp.json"

# After:
[ "$SCOPE" = "global" ] && write_mcp_json "$HOME/.claude.json" || write_mcp_json "$base_dir/.mcp.json"
Test Result
No other references to ~/.claude/mcp.json in install.sh PASS — grep returns 0 matches
README references are project-level .claude/mcp.json (correct) PASS — not affected by this change
Claude docs confirm ~/.claude.json for global scope PASS — docs link

The installer was writing global Claude MCP config to ~/.claude/mcp.json
but Claude Code expects it at ~/.claude.json per the official docs.

Fixes databricks-solutions#203
@calreynolds
Copy link
Collaborator

Thanks for looking into this, but the current path (~/.claude/mcp.json) is actually correct — ~/.claude.json is a different config file. Closing to avoid a breaking change.

@calreynolds calreynolds closed this Mar 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Bug: global Claude MCP config is written to ~/.claude/mcp.json instead of ~/.claude.json

2 participants