Connect

Listar propósitos de operación Global66

Propósitos válidos para preparar una operación MCP; usa el id real.

Tool IDglobal66.propositos_operacion.listar
Nombre MCPglobal66__propositos_operacion__listar
Conectorglobal66
Planoaction
Scope (permiso)global66:read
Authconnection_credentials
Versión1
Sensibleno
Deprecadono
ComportamientoreadOnly=true, destructive=false, idempotent=true, openWorld=true

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Entrada

CampoTipoRequeridoDescripción
operation"TRANSFER" · "P2P"síTipo de operación.
searchstringnoTexto a buscar.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "TRANSFER",
        "P2P"
      ],
      "description": "Tipo de operación."
    },
    "search": {
      "description": "Texto a buscar.",
      "type": "string",
      "maxLength": 100
    }
  },
  "required": [
    "operation"
  ]
}

Salida

CampoTipoRequeridoDescripción
datosvalornullsí
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "datos": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "array",
              "items": {}
            }
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Respuesta de la tool MCP de Global66 sin reinterpretar."
    }
  },
  "required": [
    "datos"
  ],
  "additionalProperties": false
}

Errores de esta tool

CódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
connection_credential_required428noCrea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior.
connection_busy409síEspera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.
upstream_error502síReintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.
timeout504síReintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo.

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.

En esta página