Authentication

Begin the OAuth handshake for an External MCP Connection

Changed on

Runs RFC 9728 discovery, dynamic client registration if needed, and returns an authorize URL to redirect the admin's browser to.

get/v1/mcp-connections/{connectionId}/connect/start

Request

  • Base URL: https://api.openworklabs.com
  • URL: https://api.openworklabs.com/v1/mcp-connections/{connectionId}/connect/start
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

connectionIdstring typeid required

Den TypeID with 'emc_' prefix and a 26-character base32 suffix.

Response

Authorize URL, or already connected.

status'connected' | 'needs_auth' required
authorizeUrlstring nullable required

Changes

  • b3e69054b120Revision changes
    • info

      added the optional property //// to the response with the status

  • bb8ff73e4ad3Revision changes
    • info

      the endpoint scheme security bearerAuth was added to the API

    • info

      the endpoint scheme security denApiKey was added to the API