Skip to content

fix: use claude mcp add CLI for all platforms in Claude Code setup#70

Open
JonasBaeumer wants to merge 1 commit into
denolehov:mainfrom
JonasBaeumer:fix/claude-code-mcp-setup-instructions
Open

fix: use claude mcp add CLI for all platforms in Claude Code setup#70
JonasBaeumer wants to merge 1 commit into
denolehov:mainfrom
JonasBaeumer:fix/claude-code-mcp-setup-instructions

Conversation

@JonasBaeumer

Copy link
Copy Markdown

Summary

Fixes #69

The README's macOS section showed a JSON snippet instructing users to add mcpServers to ~/.claude/settings.json. This is incorrect — mcpServers is not a recognized field in Claude Code's settings.json and the validator rejects it with:

Unrecognized field: mcpServers

Per the official Claude Code MCP documentation, MCP servers are stored in ~/.claude.json and configured via the claude mcp add CLI command.

Change

  • Removes the incorrect JSON snippet for macOS
  • Replaces the three separate platform sections (macOS/Linux/Windows) with a single cross-platform claude mcp add command

The JSON snippet pointing to ~/.claude/settings.json was incorrect —
mcpServers is not a valid field there and Claude Code rejects it with
a validation error. MCP servers are stored in ~/.claude.json and
configured via the claude mcp add CLI command.

Unify all three platform sections into a single cross-platform CLI
command, consistent with the official Claude Code MCP documentation:
https://code.claude.com/docs/en/mcp

Fixes denolehov#69
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.

README: mcpServers snippet for Claude Code settings.json is incorrect

1 participant