Skip to content

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

Merged
denolehov merged 1 commit into
denolehov:mainfrom
JonasBaeumer:fix/claude-code-mcp-setup-instructions
Jun 20, 2026
Merged

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

Conversation

@JonasBaeumer

Copy link
Copy Markdown
Contributor

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
@denolehov

Copy link
Copy Markdown
Owner

thank you so much, @JonasBaeumer!

@denolehov denolehov merged commit 78508e1 into denolehov:main Jun 20, 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.

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

2 participants