Skip to main content
POST
Connect a remote MCP server as a custom integration

Authorizations

Authorization
string
header
required

An aik_… programmatic API key (app.atako.ai → Settings → API keys) or a Supabase session JWT.

Body

application/json
url
string<uri>
required
displayName
string
Maximum string length: 80
visibility
enum<string>
Available options:
company,
personal
auth
object

How the platform authenticates to the MCP server. The token is encrypted at rest and never returned nor shown to agents.

tools
object[]

Response

Never includes credential material.

id
string<uuid>
required
providerKey
string
required
displayName
string
required
authType
enum<string>
required
Available options:
api_key,
oauth2,
mcp,
internal
status
enum<string>
required
Available options:
active,
error,
revoked
createdAt
string<date-time>
required
companyId
string<uuid> | null
visibility
enum<string>

'company' = shared with the whole company, managed by its admins; 'personal' = visible to, managed and grantable (to their own agents) by its creator only. Another member's personal connections are never returned.

Available options:
company,
personal
isMine
boolean

Created by the caller.

actions
object[]

List endpoint, custom MCP connections only (providerKey 'mcp', no catalog entry): the active tools, catalog-shaped.

mcp
object

List endpoint, custom MCP connections only.

externalLabel
string | null
config
object | null
scopes
string[]
lastUsedAt
string<date-time> | null
createdBy
string<uuid>