Listar grupos de conexiones


Tool ID	`conexiones.grupos.listar`
Nombre MCP	`conexiones__grupos__listar`
Conector	`conexiones`
Plano	`action`
Scope (permiso)	`conexiones:grupos:read`
Auth	`none`
Versión	`1`
Sensible	no
Deprecado	no
Comportamiento	readOnly=true, destructive=false, idempotent=true, openWorld=false

Qué hace

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.

Entrada

Sin parámetros: envía {}.

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {}
}

Ejemplo

curl

curl -X POST https://connect.emisso.ai/api/v1/tools/conexiones.grupos.listar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'

MCP · meta-tool execute

{
  "tool": "conexiones.grupos.listar",
  "params": {}
}

Salida esperada (200):

{
  "data": {
    "revision": 4,
    "grupos": [
      {
        "id": "cgrp_9f2c1a7d",
        "nombre": "Finanzas",
        "icono": "wallet",
        "color": "blue",
        "conexionIds": [
          "conn_9tKfR2mQx4Vb"
        ]
      }
    ],
    "sinGrupo": [
      "conn_4hPq7Lm2Zx8N"
    ]
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "conexiones.grupos.listar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

Salida

Campo	Tipo	Requerido	Descripción
`revision`	entero	sí	La revisión de la estructura. Sube con cada cambio guardado, desde el panel o por estas tools.
`grupos`	lista de objeto	sí	Los grupos de la organización, en el orden del panel.
`grupos[].id`	string	sí	El id del grupo (cgrp_…). Es lo que va en 'grupoId' de conexiones.grupos.mover.
`grupos[].nombre`	string	sí	El nombre del grupo, único dentro de la organización sin distinguir mayúsculas.
`grupos[].icono`	`"folder"` · `"wallet"` · `"building-2"` · `"users"` · `"megaphone"` · `"briefcase-business"` · …	sí	El icono del grupo, de un catálogo cerrado.
`grupos[].color`	`"neutral"` · `"red"` · `"orange"` · `"yellow"` · `"green"` · `"blue"` · …	sí	El color del grupo, de un catálogo cerrado.
`grupos[].conexionIds`	lista de string	sí	Las conexiones (conn_…) del grupo, en el orden del panel. Solo trae las que esta credencial alcanza.
`sinGrupo`	lista de string	sí	Las conexiones (conn_…) que esta credencial alcanza y no están en ningún grupo.

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "revision": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "La revisión de la estructura. Sube con cada cambio guardado, desde el panel o por estas tools."
    },
    "grupos": {
      "type": "array",
      "items": {
        "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": "Los grupos de la organización, en el orden del panel."
    },
    "sinGrupo": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Las conexiones (conn_…) que esta credencial alcanza y no están en ningún grupo."
    }
  },
  "required": [
    "revision",
    "grupos",
    "sinGrupo"
  ],
  "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.