Skip to main content
POST
Create a connection with headers

Authorizations

Authorization
string
header
required

An org API key (gh_live_…) from Settings → API keys in the console.

Body

application/json
url
string<uri>
required

The MCP server's Streamable HTTP address.

Example:

"https://mcp.acme.com/mcp"

headers
object
required

Its sign-in. Only ever sent to this address's origin.

Example:
name
string

How the connections list it. Left out: the library entry's name, else the server's host.

Maximum string length: 80
connector
string

The library entry it's for, if any.

Response

OK

A service the org signed in to, for any of its agents. Never its sign-in.

object
enum<string>
Available options:
connection
id
string

The secret_id an agent's MCP server keeps in auth to use it.

Example:

"tsec_8Zp2kQ7wLm4x"

name
string
Example:

"Notion"

connector
string | null

The library entry it came from.

url
string<uri> | null
kind
enum<string>
Available options:
oauth,
headers
status
enum<string>
Available options:
connected,
pending,
expired
error
string | null
connected_at
string<date-time> | null
created_at
string<date-time>
used_by
object[]
deleted
boolean

On a disconnect.