/.well-known/oauth-authorization-serverOAuth 2.1 authorization server metadata (RFC 8414)
Discovery document for third-party clients (Claude Desktop, Cursor, the ProductCraft MCP server). PKCE with `S256` is mandatory; no other code-challenge method is advertised or accepted. `scopes_supported` lists **presets**, not scopes: authority is the policy document on the grant (`authority_model`).
Response · 200
issuer*stringIssuer identifier. Matches the `iss` claim on every access token this server mints.
Example: "https://api.platform-auth.productcraft.co"
authorization_endpoint*stringRFC 6749 authorization endpoint.
token_endpoint*stringRFC 6749 token endpoint.
registration_endpoint*stringRFC 7591 dynamic client registration endpoint.
revocation_endpoint*stringRFC 7009 token revocation endpoint.
introspection_endpoint*stringRFC 7662 token introspection endpoint.
jwks_uri*stringJWKS the access-token signature verifies against.
response_types_supported*arrayOnly `code` — the implicit and password grants do not exist here.
Example: ["code"]
grant_types_supported*arrayOAuth grant types the token endpoint accepts (RFC 8414).
Example: ["authorization_code","refresh_token"]
code_challenge_methods_supported*arrayS256 only. `plain` is rejected, and an authorization request without a challenge is rejected.
Example: ["S256"]
token_endpoint_auth_methods_supported*arrayClient authentication methods the token endpoint accepts (RFC 8414).
Example: ["none","client_secret_basic","client_secret_post"]
scopes_supported*arrayPreset names accepted in the `scope` parameter. A preset is a policy *template*, never authority in itself — see `authority_model`. Ordinary OAuth scopes do not exist on this server.
Example: ["readonly","mail","support","full"]
scope_descriptions*objectPlain-language description per preset. Non-standard, published so a client can render the same wording the consent screen uses.
scope_labels*objectNon-standard. Display name per preset (`readonly` is shown as "Read-only"), the same names the consent screen uses.
Example: {"readonly":"Read-only","mail":"Email","support":"Support assistant","full":"Full access"}
authority_model*stringNon-standard. Declares that authority on this server is an IAM policy document stored on the grant, intersected per request with the authorizing human’s current workspace policy — so a demotion or an offboarding takes effect on the next call rather than at token expiry. The `scope` parameter only names a preset the human then narrows.
Example: "policy"
resource_indicators_supported*arrayRFC 8707 resource indicators this server will mint an audience for.
service_documentation*stringHuman-readable documentation for this authorization server.
Example
Request
GET https://api.platform-auth.productcraft.co/.well-known/oauth-authorization-serverResponse
{
"issuer": "https://api.platform-auth.productcraft.co",
"authorization_endpoint": "string",
"token_endpoint": "string",
"registration_endpoint": "string",
"revocation_endpoint": "string",
"introspection_endpoint": "string",
"jwks_uri": "string",
"response_types_supported": [
"code"
],
"grant_types_supported": [
"authorization_code",
"refresh_token"
],
"code_challenge_methods_supported": [
"S256"
],
"token_endpoint_auth_methods_supported": [
"none",
"client_secret_basic",
"client_secret_post"
],
"scopes_supported": [
"readonly",
"mail",
"support",
"full"
],
"scope_descriptions": {},
"scope_labels": {
"readonly": "Read-only",
"mail": "Email",
"support": "Support assistant",
"full": "Full access"
},
"authority_model": "policy",
"resource_indicators_supported": [
"string"
],
"service_documentation": "string"
}