Crear grupo de conexiones
Crea un grupo vacío. Queda al final del menú de conexiones de la organización. El nombre es único sin distinguir mayúsculas: si ya existe un grupo con el mismo nombre, icono y color, lo devuelve sin crear otro; si existe con otro icono o color, falla. Exige una credencial con acceso a todas las conexiones. Para llenarlo usa conexiones.grupos.mover.
API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.
In: header
Request Body
application/json
La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/tools/conexiones.grupos.crear/execute" \ -H "Content-Type: application/json" \ -d '{ "input": { "nombre": "string" } }'{ "data": { "grupo": { "id": "string", "nombre": "string", "icono": "folder", "color": "neutral", "conexionIds": [ "string" ] }, "creado": true, "revision": -9007199254740991 }, "meta": { "request_id": "string", "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f", "tool_id": "string", "plane": "action", "latency_ms": 0, "audit_status": "recorded", "idempotency": "replayed" }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}{ "error": { "code": "alcance_not_enabled", "message": "string", "suggested_fix": "string", "request_id": "string", "details": null }}Consultar el estado de las conexiones POST
Consulta el estado de las credenciales, las sincronizaciones recientes y la disponibilidad de datos de cada conexión. Úsala después de que la persona complete un enlace, y antes de intentar leer: un listado vacío no significa que no haya nada, puede ser que todavía no sincronizó. La primera sincronización de algunos sistemas puede tardar cerca de un minuto. El campo 'herramientas' trae los ids que ya puedes invocar; si tu cliente MCP todavía no los muestra en su lista, invócalos con la herramienta 'execute' pasando el id en 'tool'. El campo 'uso' dice cuántas llamadas lleva cada conexión en su período, su límite y cuándo se renueva.
Listar grupos de conexiones POST
Lista grupos del panel. Trae el nombre, icono, color y las conexiones de cada grupo con que la organización ordena el panel, más las que no tienen grupo. Con una credencial acotada a conexiones solo aparecen las que esa credencial alcanza. Úsala para obtener el 'grupoId' antes de mover una conexión.