Discovery
The server advertises its authorization server per RFC 9728. An unauthenticated request returns401 with a WWW-Authenticate header pointing at:
Flow
- Dynamic client registration (RFC 7591) — the assistant registers itself and gets a
client_id. No manual setup. - Authorization code + PKCE (
S256) — you sign in to Take App, choose which store to connect, and approve. The connection is scoped to that one store. - Token exchange — the assistant exchanges the code for an access token and a refresh token.
Permissions
Connections use theall scope for full access to read and manage products, orders, customers, and inventory, and to send messages. It includes token refresh for up to one year from approval; after that, reconnect the assistant. Granular tool permissions will come later.