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 entornoEMISSO_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
conexionestrae 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.ides elconnectionIdde esa empresa. Toda herramienta de un sistema conectado lo pide, incluso si tienes una sola; por REST viaja en la cabeceraX-Connect-Connection. Guárdalo junto a la clave.datosListosresponde «¿ya puedo leer?». Enfalsetodavía no hay datos listos: si la conexión es nueva, la primera sincronización puede tardar cerca de un minuto.herramientasson 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
- Sincronizar y consultar: por qué leer datos reales son dos pasos.
- Consultar desde tu código: un programa que lee las ventas de una empresa conectada.
- Autenticación: los permisos de las API keys y OAuth para MCP.
Preguntas frecuentes
Qué sistemas puedes conectar, qué documentos emitimos, cuánto histórico trae cada sistema, cada cuánto se actualiza, qué clave del SII usar, cómo pedir una beta y quiénes somos.
Con tu asistente de IA
El texto que le entregas a ChatGPT, Claude o Cursor para que arme tu software sobre Emisso sin pedirte nunca la clave. Pensado para quien no programa.