Skip to content

Architecture Decision Records ​

Key design decisions with context and rationale.

ADRDecision
001No refresh tokens (superseded by 006)
002Token exchange inside redirectToAuthorization() (by 006)
003Immutable client metadata across DCR (by 006)
004Every flow has a state; only exact, unambiguous callbacks win
005Credential store holds opaque text; one slot per MCP server
006The MCP SDK owns OAuth; the adapter owns browser and flow
007One redirect URI concept; builder form; URL validation
008Callback pages never render callback data; security headers