Skip to content

[Client] Add client ID metadata documents and a console authorization handler - #668

Draft
chr-hertel wants to merge 4 commits into
modelcontextprotocol:mainfrom
chr-hertel:client-auth-identity
Draft

chr-hertel wants to merge 4 commits into
modelcontextprotocol:mainfrom
chr-hertel:client-auth-identity

Conversation

@chr-hertel

Copy link
Copy Markdown
Member

Fourth slice of the client authorization in chr-hertel#53. Builds on #666, so please only look at the last commit until that one is merged.

  • setClientMetadataUrl() uses a client ID metadata document as the client id where the authorization server supports it, otherwise the client registers as before. The URL needs https & a path, same check as the TypeScript SDK.
  • ConsoleAuthorizationHandler for a remote shell or a container without a browser. It wants the whole redirected URL and refuses a bare code, which would skip the state & iss checks.

auth/basic-cimd leaves both conformance baselines with this. Machine grants come next.

The HTTP client gets decorated, so the transport keeps speaking plain PSR-18:
AuthenticatingHttpClient authenticates every request and retries the ones the
authenticator can act on. BearerToken sends a token you already have.

A 401 or 403 now fails with an AuthorizationException that names the challenge,
which connect() wraps in a ConnectionException without a retry.
Finds and validates the documents that say who guards an MCP server: protected
resource metadata (RFC 9728) and authorization server metadata (RFC 8414 and
OpenID Connect), plus the WWW-Authenticate challenge that points at them.

All of it is @internal, since nothing uses it until the authenticator lands.
Endpoints have to pass SecureUrl, and a document naming another issuer than it
was fetched for is discarded.
Pass OAuth::forApplication('My App')->build() as `auth` and a client answers a
401 with discovery, client registration, the authorization code flow with PKCE
and a retry. It refreshes tokens, handles step-up challenges and refuses what a
hostile server could send.

Client id metadata documents, the console handler, client credentials,
private_key_jwt and cross-app access follow in their own changes, so their
conformance scenarios stay in the baselines.
… handler

setClientMetadataUrl() uses a published document as the client id where the
authorization server supports it, and otherwise registers as before. The URL has
to be https with a path.

ConsoleAuthorizationHandler prints the authorization URL and reads back the
redirected URL, for a shell without a browser. It refuses a bare code, which
would skip the state and iss checks.
@chr-hertel chr-hertel added Client Issues & PRs related to the Client component auth Issues and PRs related to Authentication / OAuth labels Nov 5, 2026
@chr-hertel chr-hertel added this to the 1.0.0 milestone Nov 5, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auth Issues and PRs related to Authentication / OAuth Client Issues & PRs related to the Client component

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant