Connect Platform Mcp Catalog

Create or return a workspace MCP integration from catalog defaults.

POST /workspaces/{workspace_id}/mcp-integrations/catalog/{catalog_slug}/connect

Error

A valid request URL is required to generate request examples

201

{
  "mcp_integration": {
    "id": "<string>",
    "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "description": "<string>",
    "slug": "<string>",
    "server_uri": "<string>",
    "oauth_integration_id": "<string>",
    "stdio_command": "<string>",
    "stdio_args": [
      "<string>"
    ],
    "timeout": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "has_stdio_env": false,
    "tools": [
      {
        "name": "<string>",
        "description": "<string>",
        "enabled": true,
        "requires_approval": false,
        "status": "available"
      }
    ]
  },
  "auth_url": "<string>",
  "provider_id": "<string>"
}

Authorizations

APIKeyCookieServiceAccountApiKeyBearer

fastapiusersauth · string · cookie · required

Path Parameters

catalog_slug · string · required

workspace_id · string<uuid> · required

Body

application/json

Request for one-click connecting a platform MCP catalog entry.

Carries no connection fields, so the recipe cannot be inferred from the payload; the caller names the connection option it offered.

connection_option_id · string | null

Platform MCP catalog connection option to connect

Maximum string length: 80

Response

201

application/json

Successful Response

Response for connecting a platform MCP catalog entry.

status · enum<string> · required

Available options: configured, connected, oauth_redirect

mcp_integration · MCPIntegrationRead · object | null

Response model for MCP integration.

Show child attributes

auth_url · string | null

provider_id · string | null