Skip to main content
POST
Begin an external MCP OAuth connection

Authorizations

Authorization
string
header
required

Use Authorization: Bearer <token>. The token is either a user token / OAuth access token, or a service-account API key (cfk_...). A key is valid on every endpoint and acts as its service account, an organization member with per-store permissions. Refused keys answer 403 with Invalid API key., API key revoked., API key expired. or API key disabled..

Body

application/json
url
string
required

MCP server URL (must match an enabled OAuth server in one of the user's stores).

redirect_back_to
string
required

Same-origin frontend URL to return to after the dance (validated against the redirect allowlist).

Response

Authorization URL

authorize_url
string