[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=value2This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗