Sign in
connect

Create or update connection

Create or update an MCP connection with the given ID. mcpUrl is required when creating a new connection, but optional when updating (omit to keep the existing URL). Returns 409 if a different mcpUrl is provided, except while the connection is input_required and the new URL keeps the same host and path. Requires API key and namespace ownership.

put/connect/{namespace}/{connectionId}

Path parameters

namespacestring required
connectionIdstring required

Request body

mcpUrlstring uri

URL of the MCP server. Required when creating a new connection. Optional when updating — omit to keep the existing URL.

namestring

Human-readable name (optional, defaults to connection ID)

metadataobject

Custom metadata for filtering connections

headersobject

Custom headers to send with MCP requests (stored securely, not returned in responses)

Example request

{
  "mcpUrl": "https://mcp.example.com/sse",
  "name": "My MCP Server",
  "metadata": {
    "userId": "user123",
    "team": "engineering"
  },
  "headers": {
    "X-API-Key": "secret-key"
  }
}

Response

Connection updated

connectionIdstring required

Connection ID (auto-generated or developer-defined)

namestring required

Human-readable name

mcpUrlstring required

MCP server URL

metadataobject nullable required
iconUrlstring nullable
createdAtstring

ISO 8601 timestamp

Example response

{
  "connectionId": "clever-dolphin-a9X3"
}

Changes