Crear grupo de conexiones
Crea un grupo vacío.
| Tool ID | conexiones.grupos.crear |
| Nombre MCP | conexiones__grupos__crear |
| Conector | conexiones |
| Plano | action |
| Scope (permiso) | conexiones:grupos:write |
| Auth | none |
| Versión | 1 |
| Sensible | no |
| Deprecado | no |
| Comportamiento | readOnly=false, destructive=false, idempotent=true, openWorld=false |
Qué hace
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.
Entrada
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
nombre | string | sí | El nombre del grupo, hasta 40 caracteres. |
icono | "folder" · "wallet" · "building-2" · "users" · "megaphone" · "briefcase-business" · … | no · default "folder" | El icono del grupo, de un catálogo cerrado. |
color | "neutral" · "red" · "orange" · "yellow" · "green" · "blue" · … | no · default "neutral" | El color del grupo, de un catálogo cerrado. |
JSON Schema de entrada
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"nombre": {
"type": "string",
"minLength": 1,
"maxLength": 40,
"description": "El nombre del grupo, hasta 40 caracteres."
},
"icono": {
"default": "folder",
"type": "string",
"enum": [
"folder",
"wallet",
"building-2",
"users",
"megaphone",
"briefcase-business",
"landmark",
"receipt",
"chart-no-axes-combined",
"shopping-bag",
"store",
"package",
"globe",
"code-xml",
"database",
"cloud",
"calendar-days",
"messages-square",
"heart-handshake",
"rocket",
"lightbulb",
"star",
"shield-check",
"layers"
],
"description": "El icono del grupo, de un catálogo cerrado."
},
"color": {
"default": "neutral",
"type": "string",
"enum": [
"neutral",
"red",
"orange",
"yellow",
"green",
"blue",
"violet",
"pink"
],
"description": "El color del grupo, de un catálogo cerrado."
}
},
"required": [
"nombre"
]
}Ejemplo
curl -X POST https://connect.emisso.ai/api/v1/tools/conexiones.grupos.crear/execute \
-H "Authorization: Bearer connect_sk_…" \
-H "Content-Type: application/json" \
-d '{"input":{"nombre":"Finanzas","icono":"wallet","color":"blue"}}'{
"tool": "conexiones.grupos.crear",
"params": {
"nombre": "Finanzas",
"icono": "wallet",
"color": "blue"
}
}Salida esperada (200):
{
"data": {
"grupo": {
"id": "cgrp_9f2c1a7d",
"nombre": "Finanzas",
"icono": "wallet",
"color": "blue",
"conexionIds": []
},
"creado": true,
"revision": 5
},
"meta": {
"request_id": "req_…",
"tool_id": "conexiones.grupos.crear",
"plane": "action",
"latency_ms": 24,
"audit_status": "recorded"
}
}Salida
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
grupo | objeto | sí | El grupo creado, o el que ya existía con ese nombre, icono y color. |
grupo.id | string | sí | El id del grupo (cgrp_…). Es lo que va en 'grupoId' de conexiones.grupos.mover. |
grupo.nombre | string | sí | El nombre del grupo, único dentro de la organización sin distinguir mayúsculas. |
grupo.icono | "folder" · "wallet" · "building-2" · "users" · "megaphone" · "briefcase-business" · … | sí | El icono del grupo, de un catálogo cerrado. |
grupo.color | "neutral" · "red" · "orange" · "yellow" · "green" · "blue" · … | sí | El color del grupo, de un catálogo cerrado. |
grupo.conexionIds | lista de string | sí | Las conexiones (conn_…) del grupo, en el orden del panel. Solo trae las que esta credencial alcanza. |
creado | booleano | sí | true si esta llamada creó el grupo; false si ya existía uno con ese nombre, icono y color y se devolvió el mismo. |
revision | entero | sí | La revisión de la estructura después de la llamada. |
JSON Schema de salida
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"grupo": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "El id del grupo (cgrp_…). Es lo que va en 'grupoId' de conexiones.grupos.mover."
},
"nombre": {
"type": "string",
"description": "El nombre del grupo, único dentro de la organización sin distinguir mayúsculas."
},
"icono": {
"type": "string",
"enum": [
"folder",
"wallet",
"building-2",
"users",
"megaphone",
"briefcase-business",
"landmark",
"receipt",
"chart-no-axes-combined",
"shopping-bag",
"store",
"package",
"globe",
"code-xml",
"database",
"cloud",
"calendar-days",
"messages-square",
"heart-handshake",
"rocket",
"lightbulb",
"star",
"shield-check",
"layers"
],
"description": "El icono del grupo, de un catálogo cerrado."
},
"color": {
"type": "string",
"enum": [
"neutral",
"red",
"orange",
"yellow",
"green",
"blue",
"violet",
"pink"
],
"description": "El color del grupo, de un catálogo cerrado."
},
"conexionIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Las conexiones (conn_…) del grupo, en el orden del panel. Solo trae las que esta credencial alcanza."
}
},
"required": [
"id",
"nombre",
"icono",
"color",
"conexionIds"
],
"additionalProperties": false,
"description": "El grupo creado, o el que ya existía con ese nombre, icono y color."
},
"creado": {
"type": "boolean",
"description": "true si esta llamada creó el grupo; false si ya existía uno con ese nombre, icono y color y se devolvió el mismo."
},
"revision": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "La revisión de la estructura después de la llamada."
}
},
"required": [
"grupo",
"creado",
"revision"
],
"additionalProperties": false
}Errores de esta tool
Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.