Empieza aquí

Tu primera llamada

Comprueba tu API key por REST o MCP en cerca de 2 minutos y sin instalar nada. La primera llamada lista las conexiones a las que alcanza la clave.

Una API key nueva lee solo las conexiones que marcaste al crearla. Por eso la primera llamada pide esa lista: si responde con tus empresas, la clave funciona, y de ahí sale el connectionId que usan las demás herramientas. Esta página te lleva de una clave recién creada a esa respuesta y a su fila en la bitácora.

Antes de empezar

  • Una cuenta en connect.emisso.ai con tu organización creada.
  • Al menos una empresa conectada. Si todavía no tienes ninguna, sigue Conecta tu primera empresa y vuelve aquí.
  • Una API key: créala en connect.emisso.ai/api-keys, marca las conexiones que va a usar y copia el secreto connect_sk_…. Se muestra una sola vez. Guárdalo en la variable de entorno EMISSO_CONNECT_API_KEY (por ejemplo, en tu .env), no en el código ni en un chat.

¿Todavía sin cuenta?

Para ver cómo responde Emisso antes de registrarte, la UF se sirve por el canal público, sin API key: curl https://connect.emisso.ai/public/v1/indicadores/UF. No deja fila en la bitácora. El detalle está en Indicadores.

1. Pide la lista de tus conexiones

Empieza por REST: no hay nada que instalar y llega a todo el catálogo. MCP llega a la misma herramienta y deja la misma auditoría.

REST con curl

El cuerpo siempre es JSON con los argumentos dentro de input. Esta herramienta no necesita argumentos, así que input va vacío:

curl -X POST https://connect.emisso.ai/api/v1/tools/conexiones.estado.consultar/execute \
  -H "Authorization: Bearer $EMISSO_CONNECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {}}'

Salida esperada (200), recortada a los campos que importan en esta prueba:

{
  "data": {
    "conexiones": [
      {
        "id": "conn_9tKfR2mQx4Vb",
        "sistema": "sii",
        "nombre": "Comercial Aurora SpA",
        "estado": "active",
        "datosListos": true,
        "herramientas": [
          "sii.conexion.sincronizar",
          "sii.rcv.consultar"
        ]
      }
    ]
  },
  "meta": {
    "request_id": "req_8fk2mQpw31Zx",
    "tool_id": "conexiones.estado.consultar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

La respuesta completa trae más campos por conexión, como sus últimas sincronizaciones y el uso del mes. Están descritos en la referencia.

MCP

Con el servidor ya instalado (cómo), pídele a tu agente «muéstrame mis conexiones de Emisso». Va a descubrir la herramienta con search_docs y a ejecutar:

{ "tool": "conexiones.estado.consultar", "params": {} }

2. Lee la respuesta

  • conexiones trae una fila por cada empresa a la que alcanza esta clave. Si falta alguna, la clave se creó sin ella: revisa sus conexiones en API keys.
  • id es el connectionId de esa empresa. Toda herramienta de un sistema conectado lo pide, incluso si tienes una sola; por REST viaja en la cabecera X-Connect-Connection. Guárdalo junto a la clave.
  • datosListos responde «¿ya puedo leer?». En false todavía no hay datos listos: si la conexión es nueva, la primera sincronización puede tardar cerca de un minuto.
  • herramientas son los ids que ya puedes usar sobre esa conexión.

Si la lista llega vacía, la clave no alcanza ninguna conexión. Si la llamada responde 403 scope_not_granted, la clave no tiene el permiso para ver conexiones; agrégalo editándola en API keys.

Guarda también el patrón del envelope. Todo éxito llega como { data, meta }, y meta.request_id es tu correlativo para la bitácora y para soporte.

3. Comprueba la bitácora

Abre connect.emisso.ai/bitacora. Deberías ver una fila nueva: conexiones.estado.consultar, resultado ok, tu API key como actor y la latencia registrada. Cada llamada que hagas desde hoy, tuya o de tu agente, deja exactamente una fila como esta.

Con eso recorriste todo el gateway (autenticación, catálogo, ejecución y auditoría), el mismo camino que sigue cada herramienta del SII y de los bancos.

¿Y la UF?

Los indicadores (UF, dólar, euro, IPC y UTM) piden el permiso indicadores:read, que una clave nueva no trae, porque solo lleva las lecturas de las conexiones que marcaste. Para sumarlo, abre «Configuración avanzada» al crear la clave, o edita una que ya tengas, y marca «Indicadores económicos». Sin ese permiso, pedir la UF responde 403 scope_not_granted.

Próximos pasos

En esta página