[DOCS] MCP docs missing --client-id and --client-secret flags for OAuth servers without DCR

Resolved 💬 2 comments Opened Feb 3, 2026 by coygeek Closed Feb 5, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/mcp

Section/Topic

"Installing MCP servers" and "Authenticate with remote MCP servers"

Current Documentation

The docs currently show:

# Basic syntax claude mcp add --transport http <name> <url>

And for auth:

Use the /mcp command within Claude Code Then follow the steps in your browser to login.

What's Wrong or Missing?

Changelog v2.1.30 adds support for pre-configured OAuth clients for MCP servers that do not support Dynamic Client Registration, via new --client-id and --client-secret flags on claude mcp add. The MCP guide does not mention these flags or how to provide client credentials, so users with non-DCR servers have no documented setup path.

Suggested Improvement

Update the MCP guide to include the new flags:

  • In "Add a remote HTTP server", mention optional --client-id and --client-secret flags.
  • In the auth section, explain when to use these flags (servers without DCR) and add a short example command.
  • Mirror the options in the CLI reference for claude mcp add.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/mcp | MCP server installation + OAuth authentication sections |
| https://code.claude.com/docs/en/cli-reference | claude mcp command reference |

Total scope: 2 pages affected

Changelog reference: https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

View original on GitHub ↗

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