[DOCS] MCP docs omit `claude mcp login` and `logout` CLI authentication commands

Resolved 💬 1 comment Opened Jun 22, 2026 by coygeek Closed Jun 25, 2026

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> or claude 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

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗