[Bug] Incorrect `--` separator position in `claude mcp add` command documentation

Resolved 💬 3 comments Opened Apr 23, 2026 by devshah7 Closed May 28, 2026

Bug Description
Issue: The claude mcp add command documentation shows incorrect syntax for the -- separator.

Documented syntax (incorrect):

claude mcp add [options] <server-name> -- <command>
Actual working syntax:

claude mcp add [options] -- <server-name> <command>
Example that failed:

claude mcp add --transport stdio -e KEY=value myserver -- node /path/to/index.js
Example that worked:

claude mcp add --transport stdio -e KEY=value -- myserver node /path/to/index.js
The -- separator must come before the server name, not after it. The documentation currently shows it in the wrong position.

Environment Info

  • Platform: darwin
  • Terminal: Apple_Terminal
  • Version: 2.1.108
  • Feedback ID: 67abf522-8136-416e-a2e5-fceaa5381c02

Errors

Invalid environment variable format: cursor-cli-mcp, environment variables should be added as: -e KEY1=value1 -e KEY2=value2

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗