[DOCS] MCP OAuth docs are missing `oauth.authServerMetadataUrl` override

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

HTTP MCP OAuth configuration options and discovery fallback behavior.

Current Documentation

OAuth examples currently show:

"oauth":{"clientId":"your-client-id","callbackPort":8080}

No documentation currently exists for oauth.authServerMetadataUrl as a discovery override.

What's Wrong or Missing?

Changelog v2.1.64 adds oauth.authServerMetadataUrl for MCP servers to specify a custom OAuth metadata discovery URL when standard discovery fails. The MCP docs currently describe client ID/secret/callback flow but not this fallback configuration, which is important for non-standard identity providers.

Suggested Improvement

Add an OAuth advanced configuration subsection in MCP docs that includes:

1. oauth.authServerMetadataUrl field definition.
2. When to use it (non-standard discovery endpoints).
3. claude mcp add-json example including the field.
4. Troubleshooting guidance for discovery failures.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/mcp | 648-653, 699-700 | OAuth examples include clientId/callbackPort only; no metadata URL override |
| https://code.claude.com/docs/en/settings | 172-173 | MCP-related settings reference exists but no mention of OAuth metadata override |
| https://platform.claude.com/docs/en/agent-sdk/mcp | n/a | Agent SDK cross-reference |

Total scope: 3 pages affected

Source: Changelog v2.1.64

• Added oauth.authServerMetadataUrl config option for MCP servers to specify a custom OAuth metadata discovery URL when standard discovery fails.