Skip to content

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

Description

@coygeek

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

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions