[DOCS] MCP docs omit `claude mcp login` and `logout` CLI authentication commands
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/mcp
Section/Topic
"Managing your servers" and "Authenticate with remote MCP servers"
Current Documentation
The MCP page currently lists these management commands:
"claude mcp list" "claude mcp get github" "claude mcp remove github" "/mcp"
The authentication section then tells users to authenticate from inside Claude Code:
"In Claude code, use the command: /mcp"
The tips also say:
"Use /mcp to authenticate with remote servers that require OAuth 2.0 authentication"
What's Wrong or Missing?
Claude Code v2.1.186 added claude mcp login <name> and claude mcp logout <name> so users can authenticate and clear authentication for MCP servers from the shell without opening the interactive /mcp menu.
The page still presents /mcp as the only authentication path. It also omits the --no-browser stdin redirect flow for completing MCP authentication over SSH.
Suggested Improvement
Add the CLI authentication commands to the management command list:
claude mcp login github
claude mcp logout github
In the OAuth authentication section, document both supported paths:
- Interactive: run
/mcp, select the server, and choose Authenticate or Clear authentication. - CLI: run
claude mcp login <name>orclaude mcp logout <name>.
Also add a short SSH/headless note explaining how to use claude mcp login <name> --no-browser with the redirected callback URL on stdin.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/mcp | Primary MCP server management and OAuth authentication documentation |
| https://code.claude.com/docs/en/mcp-quickstart | Troubleshooting still points users to /mcp for authentication and re-authentication |
Total scope: 2 pages affected
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗