Skip to main content
POST
Error

Authorizations

fastapiusersauth
string
cookie
required

Path Parameters

workspace_id
string<uuid>
required

Body

application/json

Request model for creating an HTTP MCP integration.

name
string
required

MCP integration name

Required string length: 3 - 255
server_uri
string
required

MCP server endpoint URL (required for http type)

description
string | null

Optional description

Maximum string length: 512
timeout
integer | null
default:30

Timeout in seconds

Required range: 1 <= x <= 300
catalog_slug
string | null

Platform MCP catalog slug this workspace config is created from

Maximum string length: 255
server_type
string
default:http
Allowed value: "http"
auth_type
enum<string>
default:NONE

Authentication type (for http type)

Available options:
OAUTH2,
CUSTOM,
NONE
oauth_integration_id
string<uuid> | null

OAuth integration ID (required for oauth2 auth_type)

custom_credentials
string<password> | null

HTTP headers as a JSON object. Required for custom auth type; optional additional headers for OAuth2 auth type.

oauth_client_credentials
string<password> | null

OAuth client credentials as a JSON object (client_id / client_secret) for catalog OAuth2 rows that declare an 'oauth_client' credential. Kept separate from custom_credentials so one connect can carry both a user-created OAuth client and extra HTTP headers.

Response

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.

auth_url
string | null
provider_id
string | null