MCP Connectors

Begin an MCP connector OAuth install

Changed on

Begin an OAuth browser flow to install or reconnect a preset MCP connector. Open the authorization URL in the user's browser, then poll getMcpOAuthInstallAttempt with the returned connectionId and requestId to check this attempt's completion.

post/mcp-connectors/oauth/begin

Request

  • Base URL: https://api.sazabi.com/v1
  • URL: https://api.sazabi.com/v1/mcp-connectors/oauth/begin
  • Auth: none declared

Request body

targetConnectionIdstring uuid

Reconnect this existing connection in place, preserving its identity and tool policy.

projectIdstring uuid

Project to install into. Auto-filled from SDK context when omitted.

providerIdstring required

Provider ID to install, e.g. "linear".

requestedScopesstring[]

Scopes to request. Defaults to the provider's recommended scope set.

serverUrlstring uri

Server URL for multi-region providers; defaults to the provider's primary server.

readOnlyboolean

Restrict the connector to read-only tools after install. Defaults to false.

returnTostring

Path to redirect the user to after OAuth completes.

Response

OK

requestIdstring uuid required

This authorization attempt. Pass it when polling reconnect completion.

authorizationUrlstring required

Authorization URL to open in the user's browser.

connectionIdstring uuid required

Connection ID to poll for completion via getMcpOAuthInstallAttempt.

expiresAtstring date-time required

When the OAuth authorization attempt expires.

Changes

  • bf2ddbe801b3Revision changes
    • info

      added the new optional request property

    • info

      added the required property to the response with the status