Frihet llega al catálogo de Hermes Agent de Nous Research

La interoperabilidad abierta entre sistemas de gestión y modelos de inteligencia artificial da hoy un paso firme. La integración oficial de Frihet para Hermes Agent ha sido aceptada e incorporada al catálogo oficial de plugins del repositorio de Nous Research. En paralelo, publicamos la versión 1.0.2 del plugin de Frihet para ChatGPT, diseñada con habilidades guiadas de flujo de trabajo sobre el estándar Model Context Protocol (MCP).

Ambos hitos comparten una misma premisa de ingeniería: conectar la contabilidad y la facturación con agentes inteligentes sin comprometer la seguridad, sin exponer claves en texto plano y con barreras de confirmación humana obligatorias antes de cualquier cambio de estado.

Integración en Nous Research: historia y límites verificables

El proceso de incorporación a Hermes Agent se consolidó a través de dos aportaciones públicas verificables en el repositorio upstream:

1. Aceptación inicial: El PR upstream #135038 fue revisado y fusionado el 8 de octubre de 2026, con comentarios confirmatorios del mantenedor principal teknium1 en la discusión técnica del proyecto.
2. Fijación de versión canónica: La actualización #135271, fusionada el 9 de octubre de 2026, fijó la versión comunitaria v0.1.0 en el commit exacto 4f092d58398ab252ea1fa6b07bfefacec717abd9.

Es fundamental delimitar con honestidad el alcance de esta integración: en la taxonomía de Nous Research, el plugin está clasificado como tier: community. Esto significa que el código fuente y su mantenimiento son responsabilidad directa del equipo de Frihet en el repositorio público Frihet-io/hermes-frihet, y no una solución desarrollada internamente por Nous Research ni un acuerdo de patrocinio comercial conjunto. Asimismo, la integración gráfica complementaria en la interfaz Connectors UI permanece en revisión pendiente bajo el PR #134790 y no se declara operativa hasta su fusión definitiva.

Arquitectura de control: comandos nativos y hook pre_tool_call

El plugin de Hermes se conecta directamente al endpoint remoto de Frihet (https://mcp.frihet.io/mcp) empleando autenticación OAuth 2.1 con PKCE, lo que evita por completo la necesidad de pegar claves API en el diálogo del chat.

El paquete empaqueta un archivo SKILL.md que instruye al modelo en la disciplina de consulta previa (read-first) y expone tres comandos principales:

• /frihet setup: guía al usuario en la vinculación interactiva con su espacio de trabajo en Frihet.
• /frihet status: verifica la identidad autorizada, el plan activo y el estado de sincronización.
• /frihet doctor: ejecuta pruebas diagnósticas de latencia, validez de tokens y permisos efectivos.

La pieza crítica de seguridad radica en el hook pre_tool_call. Cualquier operación de lectura (como listar facturas emitidas o consultar el resumen del Modelo 303) se resuelve de forma inmediata; sin embargo, cuando el agente propone una mutación (creación de presupuestos, rectificación de gastos o registro de contactos), el hook intercepta la llamada y requiere una aprobación humana explícita en el terminal antes de transmitir la orden a la API.

ChatGPT Plugin v1.0.2: cuatro habilidades de flujo guiado

Para los usuarios de OpenAI y ChatGPT que buscan conectar su asistente con su infraestructura de negocio, publicamos la versión 1.0.2 del plugin oficial (marketplace/openai/dist/frihet-1.0.2.zip, documentado en Frihet-io/frihet-mcp#254).

En lugar de presentar una lista indiscriminada de endpoints, esta entrega organiza 33 herramientas empresariales probadas en cuatro habilidades funcionales guiadas:

• frihet-workspace: consulta de perfiles fiscales, cuentas bancarias y agregados periódicos de impuestos.
• invoices-and-quotes: redacción de borradores, consulta de vencimientos y generación de enlaces de descarga PDF.
• expenses-and-vendors: registro de facturas de proveedores, lectura de tickets OCR y control de proveedores.
• clients-crm: gestión de clientes, consulta de saldos y notas de crédito asociadas.

El paquete incluye además un onboardingSkill que orienta al asistente durante la primera sesión para que conozca el sector y la divisa de trabajo del usuario sin configurar parámetros a ciegas.

Ejemplos reproducibles de solo lectura

Puedes comprobar de inmediato la conectividad de tu agente con consultas de diagnóstico que no alteran ningún registro:

# Comprobación de estado desde el agente Hermes
/frihet doctor

Una vez validado el canal, el asistente puede resolver peticiones directas en lenguaje natural, tales como:

“¿Cuáles son las facturas pendientes de cobro que vencen en los próximos siete días?” “Dame un desglose de las bases imponibles y cuotas de IVA devengado de este trimestre.”

El modelo invoca únicamente las herramientas de lectura autorizadas (list_invoices o get_modelo_303_summary), mostrando los identificadores y las cifras reales devueltas por el ERP.

Cómo empezar y documentación de referencia

Esta apertura refuerza el compromiso de Frihet con un ecosistema donde el usuario es dueño absoluto de sus datos y de sus flujos de automatización:

• Para conocer la especificación completa del protocolo, consulta nuestra guía sobre el servidor MCP de Frihet.
• Si utilizas otros entornos de escritorio, revisa la guía sobre conectar Claude con MCP.
• El manual técnico y el esquema de herramientas se encuentran disponibles en la documentación oficial para desarrolladores.

El código fuente del plugin de Hermes está abierto a contribuciones y revisiones en GitHub.