Skip to main content
POST
Add a custom connector

Authorizations

Authorization
string
header
required

A Custral secret API key (sk_…), created in Settings → Applications. Sent as Authorization: Bearer sk_…. The X-Api-Key: sk_… header is also accepted and takes precedence. Never expose a secret key in a browser.

Body

application/json
displayName
string
required
Maximum string length: 80
Example:

"Linear"

serverUrl
string<uri>
required

The remote MCP server URL. https only; private and internal addresses are refused.

Example:

"https://mcp.linear.app/mcp"

authType
enum<string>
required
Available options:
oauth,
token,
none
connectionScope
enum<string>
required
Available options:
org,
user
description
string
Maximum string length: 280
tokenHeader
string

For token: the header the key goes in. Omitted = Authorization: Bearer.

Example:

"X-API-Key"

oauthClientId
string

For oauth against a server without dynamic client registration.

oauthClientSecret
string

Response

The new connector.

data
object

A connector: an MCP server Stella can use tools from — a vetted catalog entry or the workspace's own custom server.

reqId
string

A per-request id (req_…). Quote it to support when reporting a problem.

Example:

"req_2a1f9c8e7b6d5"