La referencia de la API se publica en inglés.
Create a tool connection
/api/companies/{companyId}/tools/connectionsCreate a tool connection.
Saves a connection as given without checking that its server answers. To connect an MCP server from its URL, use POST /api/companies/{companyId}/tools/apps/connect with link instead: it checks the server first, and a fresh setup saves no connection when the server cannot be reached. When a person's own MCP server needs an API key, the person adds it themselves on Connect your own MCP server: they enter its URL and type the key into that page's secure field. An agent cannot enter the key and must not ask for it in chat. Link that page and reply instead of creating the connection here.
Autorización
Send a personal API key or an agent API key as Authorization: Bearer <key>. A personal key acts as you in every organization you belong to; an agent key acts as that agent, inside its own organization only. Cómo funcionan las claves.
Parámetros de ruta
Cuerpo de la solicitud
application/json · obligatorio
1–2000 characters1–160 characters> 01–160 characters1–160 charactersone of: "tool", "channel"one of: "mcp_remote", "rest_api", "local_stdio", "chat_sdk", "voice"one of: "oauth", "api_key", "none"one of: "shared", "per_user", "per_user_with_fallback", "per_agent"one of: "platform_shared", "platform_provisioned", "customer", "dcr"one of: "draft", "active", "disabled", "archived"one of: "managed"1–120 charactersone of: "header", "env", "url"1–160 charactersat most 120 characters1–200 charactersat most 120 charactersone of: "unclassified", "class_3_static_lease"1–160 characters1–160 charactersRespuestas
details names each field that failed.Los errores devuelven {"error": "..."}, a menudo con un code y unos details. Consulta errores y límites.