Skip to main content
POST
Start the OAuth login flow for an MCP connection

Body

application/json

MCP OAuth login request

server_url
string
required

ServerURL is the MCP endpoint to authorize against (the OAuth resource).

Example:

"https://mcp.figma.com/mcp"

client_id
string

ClientID is an optional pre-registered OAuth client id. When empty the gateway registers a client dynamically.

client_secret
string

ClientSecret is an optional pre-registered OAuth client secret, paired with ClientID.

scopes
string

Scopes is an optional space-delimited scope string. When empty the scopes advertised by the authorization server are requested.

Example:

"openid profile"

Response

OK

authorization_url
string

AuthorizationURL is the upstream OAuth authorization URL to open.

Example:

"https://www.figma.com/oauth?client_id=...&state=..."

flow_id
string

FlowID identifies this login flow; used to redeem the token afterwards.

Example:

"7c8a1234-5678-9abc-def0-123456789abc"