MCP Connectors

Connect, Disconnect, and Toggle require an authenticated session (workspace owner or admin) — they’re designed for the AI Suite web app’s settings UI, not machine-to-machine API key access. List works with either a session or an API key.

List Connectors

GET /api/v1/workspaces/{workspaceId}/mcp-connectors

object[]

Show connector

string

e.g. "notion", "canva", "linear"

string

string | null

string

MCP server name, as referenced in an agent’s config.capabilities.mcp_servers

string

http · sse · stdio

string

connected · disconnected · error

boolean

string | null

boolean

string | null

curl https://suite.sundaypyjamas.com/api/v1/workspaces/ws_123/mcp-connectors \
  -H "Authorization: Bearer spj_ai_your_api_key_here"

Connect

POST /api/v1/workspaces/{workspaceId}/mcp-connectors/{connectorId}

Starts an OAuth flow for the connector. Redirect the user to the returned authorizeUrl; after they approve, the provider redirects to AI Suite’s OAuth callback, which completes the connection and redirects the user to returnTo.

string

Where to send the user after the OAuth flow completes. Defaults to the workspace’s agent settings page. Unsafe/external paths are ignored.

string

Redirect the user’s browser here to start OAuth.

curl -X POST https://suite.sundaypyjamas.com/api/v1/workspaces/ws_123/mcp-connectors/notion \
  -H "Cookie: <session_cookie>" \
  -H "Content-Type: application/json" \
  -d '{ "returnTo": "/workspace/ws_123/agents?tab=connectors" }'

{ "authorizeUrl": "https://api.notion.com/v1/oauth/authorize?client_id=...&code_challenge=...&state=..." }

Tokens are never returned to the client — they’re exchanged server-side and stored encrypted. On completion, the user lands back on returnTo with ?connected={connectorId} appended so your UI can refresh.

Disconnect

DELETE /api/v1/workspaces/{workspaceId}/mcp-connectors/{connectorId}

Revokes the stored OAuth tokens and marks the connector disconnected. Idempotent.

{ "disconnected": true }

Enable / Disable

PATCH /api/v1/workspaces/{workspaceId}/mcp-connectors/{connectorId}

Toggles whether a connected connector is available to agents, without revoking its tokens — useful for temporarily pausing access.

boolean

required

curl -X PATCH https://suite.sundaypyjamas.com/api/v1/workspaces/ws_123/mcp-connectors/notion \
  -H "Cookie: <session_cookie>" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false }'

{ "enabled": false }

Errors

Status	Error	Cause
400	`enabled boolean is required`	Toggle: missing/invalid `enabled`
401 / 403	`Only workspace owners and admins can manage skills`	Connect/Disconnect/Toggle by a non-admin
404	`Connector not found`	Unknown `connectorId`
500	`Failed to start OAuth` / `Failed to disconnect connector` / `Failed to update connector`	Server error

Chat

Agents

RAG

Artifacts

Image

Vector Store

Apps

Storage

Integrations

Insights

Platform Tools

List Connectors

Connect

Disconnect

Enable / Disable

Errors

​List Connectors

​Connect

​Disconnect

​Enable / Disable

​Errors

List Connectors

Connect

Disconnect

Enable / Disable

Errors