Zeno

npx add-mcp 'https://app.zeno-works.ch/mcp'

Trabajar a través de un asistente de IA (MCP)

Conecta el asistente de IA que ya utilizas a tus libros de Zeno mediante MCP: cómo conectarlo, qué puede alcanzar y qué nunca podrá superar.

---

La aplicación web no es la única forma de acceder a Zeno. Si ya utilizas un asistente de IA —ya sea de escritorio o de línea de comandos—, puedes apuntarlo a tus libros y describir lo que quieres con tus propias palabras en lugar de hacer clic entre pantallas. Este capítulo cubre qué es la conexión, qué puede y qué no puede alcanzar un asistente, cómo configurarla y qué significa para la seguridad de tus libros.

Qué es MCP

MCP es una convención publicada que permite a un asistente de IA usar un sistema externo como herramienta, y Zeno la implementa. Una vez conectados, tu asistente puede consultar información en tus libros y realizar trabajo en ellos, de la misma manera que ya usa las otras herramientas que le has dado. No necesitas aprender nada sobre la convención en sí: solo un asistente que la soporte, una dirección y una clave.

Qué puede alcanzar un asistente

La aplicación web de Zeno no tiene una puerta trasera privada: cada pantalla que usas funciona llamando a la interfaz de Zeno, y las herramientas que se ofrecen a tu asistente se generan desde esa misma interfaz cuando se inicia la conexión. Ninguna de las dos superficies es una copia mantenida a mano de la otra, por lo que no se desincronizan, y un asistente alcanza casi todo lo que hace la aplicación: leer y contabilizar los libros, conciliación bancaria, partidas abiertas, facturas de proveedores y clientes, recordatorios de pago, nóminas, períodos de IVA, activos fijos y el cierre de ejercicio.

Algunas cosas se mantienen deliberadamente fuera, y merece la pena nombrarlas en lugar de ocultarlas:

• Algunas subidas de archivos no tienen equivalente. Los recibos adjuntos a gastos y a entradas de caja registradora, el formulario de recibos de gastos por empleado, el logotipo de tu perfil de emisor de facturas, el archivo de importación de empleados de nómina, una importación de configuración completa y el archivo de tarifas ESTV Quellensteuer solo se pueden subir en la aplicación. Los documentos en general están bien: una factura de proveedor, un recibo, un extracto bancario o las cuentas anuales del año pasado entran por la misma puerta que Documentos → Bandeja de entrada.
• Las claves no pueden gestionar claves. Crear, listar o revocar una clave de API requiere una sesión de navegador iniciada. Un asistente que tenga una clave no puede crear otra, y eso es deliberado.

Una cosa sorprende a la gente. A tu asistente se le muestra una lista corta de acciones cotidianas, no todo Zeno. Varios cientos más están conectadas y se pueden llamar, pero no están en esa lista, y se le indica al asistente que busque una acción por nombre antes de concluir que algo no es compatible. Algunos lo olvidan. Si el tuyo te dice alguna vez que Zeno no puede hacer algo que sabes que sí puede, pídele que busque la acción por nombre.

Por qué merece la pena hacerlo

El trabajo que modela Zeno tiene forma de cola, y una cola es algo en lo que un asistente es bueno. Cuando llegan documentos, cualquier cosa de la que el contable de IA no estuviera seguro se retiene en lugar de contabilizarse, y vaciar esa cola en la aplicación significa abrir los elementos uno a uno. Un asistente puede recorrerla entera y decirte qué ha aceptado y qué te ha dejado a ti.

El tipo de instrucción que se adapta a esto:

• “Revisa las facturas de proveedores del mes pasado y dime cuáles parecen incorrectas: tipo de IVA equivocado, un proveedor al que nunca hemos pagado antes, un importe fuera de línea con el anterior.”
• “Todo lo que el contable de IA haya retenido para aprobación este mes: muéstrame cada uno con el documento, contabiliza los que sean claramente correctos y lista el resto.”

Una clave de acceso completo también cubre cada empresa a la que perteneces, lo que se adapta a un Treuhänder que trabaja con una cartera de clientes sin cambiar de empresa para cada uno.

Sé claro sobre lo que no cambia. Tu rol gobierna a un asistente exactamente igual que te gobierna a ti en la pantalla: puede hacer lo que tú puedes hacer en esa empresa, y nada más. Lo que no se transmite es Configuración → Autonomía, que decide cuánto puede contabilizar el contable de IA sin supervisión a partir de los documentos que llegan a Zeno —no lo que un asistente externo puede contabilizar—. Una contabilización que hace un asistente se hace cuando la hace, así que si te consulta primero es un hábito de tu cliente y no un control de Zeno. Tampoco un backlog completo viaja de esta manera: los documentos se mueven a través del asistente uno a uno, bien para un puñado y inútil para un año de papeleo. Para un backlog, conecta un buzón o una carpeta en Configuración → Integraciones, o suelta los archivos en Documentos → Bandeja de entrada, y deja que el asistente trabaje la cola que eso produce.

Configurarlo

Cualquier cliente compatible con MCP servirá, siempre que pueda añadir un servidor HTTP y establecer una cabecera de solicitud. Un cliente que no puede establecer cabeceras no puede enviar tu clave en absoluto: consulta la última viñeta de solución de problemas.

Configuración de la cuenta → Claves de API: cada clave con su alcance, su prefijo público, cuándo se usó por última vez y Revocar.

1. Abre el menú de usuario en la parte inferior de la barra lateral → Configuración de la cuenta → Claves de API y elige Crear clave de API.
2. Dale un Nombre que reconozcas más tarde: nómbrala según el asistente que estás conectando.
3. Elige un Alcance. Las opciones son Acceso completo: todas tus empresas, que “actúa con tu acceso completo a la cuenta en todas las empresas a las que perteneces”, o una de tus empresas por nombre, que está “limitada a esta única empresa, con tu rol en ella”. Elige una sola empresa a menos que tengas una razón para no hacerlo.
4. Establece una Caducidad si quieres una. El valor predeterminado es nunca, y el consejo de la propia pantalla merece la pena seguirlo: “Prefiere una caducidad para una clave que pegues en un agente de IA o una herramienta de terceros.”
5. Copia el secreto ahora. Se muestra una sola vez, inmediatamente después de la creación, y nunca más. Zeno guarda solo un hash del mismo.
6. En la configuración de conexión de tu asistente, añade un servidor HTTP. La dirección es tu dirección web habitual de Zeno con /mcp al final. Envía la clave como una cabecera llamada X-API-Key; los clientes que solo ofrecen un token de portador pueden poner la clave ahí en su lugar.

La mayoría de los clientes aceptan una lista de servidores con esta forma:

{
  "mcpServers": {
    "zeno": {
      "type": "http",
      "url": "https://your-zeno-address/mcp",
      "headers": {
        "X-API-Key": "paste-your-key-here"
      }
    }
  }
}

Algunas instalaciones también ofrecen aprobación en el navegador en lugar de una clave pegada: añades la dirección sin credencial, Zeno te envía a una página para aprobar, y el token llega al cliente sin aparecer nunca en la conversación. Si eso está activado pertenece a tu instalación de Zeno más que al asistente, así que pregunta a quien gestione la tuya. Donde está desactivado, la clave es la vía de entrada.

Comprobar que funcionó

La clave solo se comprueba cuando el asistente realmente hace algo, así que un cliente que informe de “conectado” no te dice nada sobre si puede actuar. Pruébalo pidiendo algo que necesite tus datos: “lista mis empresas” o “¿cuál es mi liquidez?”. Una respuesta correcta significa que la dirección, la clave y tu acceso coinciden.

Seguridad y control

• Una clave nunca supera tu propio acceso. Zeno la resuelve de vuelta a ti, y cada puerta de rol y empresa se aplica exactamente igual que en el navegador. Un asistente conectado con la clave de un miembro puede leer pero no contabilizar: contabilizar requiere el rol de contable o propietario.
• Un alcance de una sola empresa es un límite real. Una clave limitada a la empresa A es rechazada en la empresa B, incluso una a la que pertenezcas. La pantalla no ofrece un alcance más fino que estos dos, y el alcance solo reduce tu acceso, nunca lo amplía: una clave de acceso completo “puede hacer todo lo que tu cuenta puede, en todas las empresas a las que perteneces. Trátala como tu contraseña.”
• Lo que hace se hace de verdad. No hay sandbox, ni modo de prueba, ni ejecución en seco. Una contabilización que hace tu asistente es una contabilización en tus libros, bajo tu nombre en el registro de auditoría. Las correcciones son reversiones contabilizadas hacia adelante, como en cualquier otro lugar de el libro mayor.
• El trabajo se marca como trabajo de máquina. Una contabilización hecha a través de esta conexión lleva el origen MCP, que Contabilidad → Diario muestra en el asiento y filtra por él, para que puedas ver después qué asientos decidió una máquina.
• Revocar lo corta de inmediato. Usa Revocar en la fila de la clave: “Cualquier script que use esta clave dejará de funcionar inmediatamente. Esto no se puede deshacer.” Revocar detiene llamadas futuras; no revierte nada ya contabilizado. Las claves no se pueden recuperar: crea una nueva.
• Lo que almacena Zeno. El Prefijo público, para que puedas distinguir las claves, y el secreto solo como hash. Último uso registra cuándo una solicitud se autenticó por última vez con ella. La conexión no guarda nada entre solicitudes: tu asistente envía la clave cada vez.

Dilo claramente para ti mismo antes de pegar una clave en cualquier lugar: un asistente que tenga una puede actuar en tus libros. Limítala a una empresa, dale una caducidad, revócala cuando el trabajo esté hecho.

Cómo se relaciona esto con el contable de IA

El contable de IA ya está dentro de la aplicación y no necesita nada de esto. Un cliente externo es una segunda vía de entrada.

El contable de IA que conociste en Primeros pasos ya está conectado y no necesita clave. Es el más limitado de los dos por diseño: lee texto de documentos que cualquiera puede enviar por correo a tu empresa, por lo que su alcance está deliberadamente restringido. Un asistente externo, autenticado con una clave que tú mismo has provisionado, tiene un alcance de escritura más amplio. Ninguno reemplaza al otro, y Configuración → Autonomía gobierna solo al primero de ellos: cuánto puede contabilizar el contable de IA sin supervisión. Un asistente externo está sujeto a tu rol en su lugar. Consulta Configuración e integraciones.

Si algo sale mal

• Un mensaje sobre una clave de API faltante. El cliente no envió ninguna clave, o la envió con un nombre de cabecera distinto de X-API-Key o un token de portador. Recuerda que la conexión se establece sin una; es la primera llamada a herramienta la que falla.
• “No autorizado”, o una negativa en una empresa pero no en otra. O la clave está revocada o caducada, o tiene alcance de empresa y el asistente intentó acceder a una empresa diferente. Caducada y revocada dan mensajes distintos, porque los remedios difieren.
• Una negativa que menciona tu rol. Contabilizar, registrar pagos y aceptar trabajo retenido requieren el rol de contable o propietario en esa empresa. La clave no puede levantar eso.
• El cliente se conecta pero no ofrece ninguna acción de Zeno. Nunca llegó al servidor: comprueba que la dirección termina en /mcp antes de sospechar de la clave.
• El asistente dice que una función no existe. Pídele que busque la acción por nombre. La lista cotidiana es corta a propósito; la mayor parte de Zeno está detrás de esa búsqueda.
• Añadir Zeno desde un conector que no puede establecer cabeceras no hace nada. Algunos conectores se autentican solo en el navegador y no pueden enviar una clave en absoluto. Usa un cliente que te permita establecer una cabecera, o una instalación con la aprobación en el navegador activada.