[DOCS] MCP docs missing --client-id and --client-secret flags for OAuth servers without DCR
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-idand--client-secretflags. - 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
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗