docs(ENG-4143): say sign-in takes a client ID metadata document as well as dynamic registration

Merged
GL
7d ago
+2-2

The README and the .mcp.json note say sign-in uses dynamic client registration. Since auth#760 (turned on in prod by auth#780), idp-api.stackone.com also accepts a client ID metadata document (URL-based client ID, MCP SEP-991), so a host that supports it signs in without registering a client. This PR updates the two places that describe the sign-in. No change to the server URL, manifests or versions.

Live metadata, fetched 2026-11-12:

GET https://idp-api.stackone.com/.well-known/oauth-authorization-server/api/auth
{"issuer":"https://idp-api.stackone.com/api/auth",
 "registration_endpoint":"https://idp-api.stackone.com/api/auth/oauth2/register",
 "client_id_metadata_document_supported":true,
 "token_endpoint_auth_methods_supported":["none","client_secret_basic","client_secret_post","private_key_jwt"]}

Context: raised while fixing ENG-4143 (StackOne as an MCP client could not connect to Luma, whose auth server offers only CIMD): StackOneHQ/unified-cloud-api#9678. That fix needs nothing from this plugin, which is a client of StackOne's own server.

GateResult
Forge, security scan, Codex security, /security-reviewnot run: docs-only (README prose and a JSON note string)
Demono runtime change, no demo
JSON.mcp.json parses; no em or en dashes

Not changed here, worth a look: validate.yml asserts registration_endpoint is present ("no DCR"). That passes today, but it would fail the day auth drops DCR in favour of CIMD (MCP 2026-07-28 deprecates DCR). Workflow files cannot be pushed by the s2d2 App, so that edit is left for a person.

Requested by guillaume@stackone.com in Slack (#C094LSQ6BNV thread 1794477428.490329).

šŸ¤– Generated with Claude Code


Summary by cubic

Updates the sign-in documentation in the README and .mcp.json to mention that idp-api.stackone.com now accepts a client ID metadata document (CIMD) in addition to dynamic client registration. The docs previously described only dynamic registration, so hosts that support URL-based client IDs can now sign in without registering a client. Docs-only change: the server URL, manifests, and versions are unchanged.