Setup · Connections

Connect a remote MCP server by URL

Discovers the MCP server's authorization server, registers a client, and returns the browser OAuth consent URL. Completing the flow stores the tokens as a connection with provider "mcp"; grants on it list MCP tool names in allowed_actions.

post/connections/mcp/start

Request

  • Base URL: https://api.ziggsai.com
  • URL: https://api.ziggsai.com/connections/mcp/start
  • Auth: HTTP bearer

Request body

serverUrlstring

Remote MCP server URL (https). Required unless requestId is set.

agreementIdstring

First-hop connection consent agreement to approve: its server URL is used, and completing OAuth records the owner's approval and mints the grant. Required unless serverUrl is set.

expectedUpdatedAtstring

With agreementId: the agreement updatedAt the person was shown when they chose to approve and connect. Carried through the OAuth state; the approval recorded on callback is refused if the agreement changed meanwhile.

returnTostring

Frontend URL to redirect after OAuth

Response

OK

authorizeUrlstring required

Changes

No recorded changes to this operation across all 1 revision of this API.