Servidor MCP de Frihet: IA conectada a la gestión empresarial

El servidor MCP de Frihet (open source, licencia MIT) expone el contrato para que clientes de IA compatibles descubran y ejecuten operaciones de tu cuenta mediante la API de Frihet, con autenticación por API key. Cubre clientes, facturas, gastos, productos, presupuestos, CRM, modelos fiscales, VeriFactu y banca. Se distribuye como @frihet/mcp-server en npm y como endpoint remoto en https://mcp.frihet.io/mcp.

Qué publica Frihet

El manifiesto de producto de Frihet registra un servidor MCP live en su versión 1.16.6, verificada el 28 de agosto de 2026. Su contrato actual contiene 157 herramientas agrupadas en 17 familias, 11 recursos y 10 prompts. Está disponible como paquete npm y como endpoint remoto, y su código se publica con licencia MIT.

Las familias cubren áreas como clientes, facturas, gastos, depósitos, productos, presupuestos, webhooks, CRM, facturación electrónica, banca, modelos fiscales, VeriFactu, TicketBAI, tiempo y facturas recurrentes. Esa enumeración describe superficies del servidor; no significa que cada petición deba ejecutarse sin comprobaciones.

Frihet también mantiene una API REST documentada con autenticación por API key y un sistema de webhooks con 94 tipos de eventos y verificación HMAC-SHA256. MCP utiliza esa base programática y añade una forma estandarizada de descubrir herramientas y pasarles argumentos.

Consultar antes de cambiar

Una buena primera experiencia con MCP empieza por operaciones de lectura. Por ejemplo, puedes pedir una lista de facturas recientes, consultar gastos de un periodo o localizar un cliente. El cliente MCP debe mostrar la herramienta elegida y sus parámetros para que puedas comprobar si la solicitud corresponde con lo que querías hacer.

Las operaciones de escritura requieren más cuidado. Crear o actualizar una factura afecta a datos contables; modificar un cliente cambia información que puede reutilizarse en documentos posteriores. Antes de confirmar, revisa al menos:

• la cuenta de Frihet sobre la que estás trabajando;
• el cliente y los identificadores seleccionados;
• moneda, importes, fechas e impuestos;
• la herramienta exacta y los campos que va a enviar;
• el resultado devuelto por la API.

MCP facilita la interacción, pero no convierte una instrucción ambigua en una decisión fiscal correcta. Cuando una operación tenga consecuencias contables o regulatorias, valida el borrador y aplica el proceso de aprobación que utilice tu negocio.

Instalación local y endpoint remoto

El paquete local se distribuye como @frihet/mcp-server. La configuración concreta depende del cliente MCP que utilices, pero el patrón general consiste en registrar el comando del servidor y proporcionar la API key mediante una variable de entorno segura.

Frihet también publica el endpoint remoto https://mcp.frihet.io/mcp. Esta modalidad evita ejecutar el proceso local, aunque sigue siendo necesario configurar la autenticación y revisar qué cliente recibirá acceso a la conexión.

No pegues una API key en una conversación, un documento compartido o un repositorio. Utiliza el mecanismo de secretos del entorno, separa credenciales cuando trabajes con cuentas distintas y revoca las que ya no uses.

Tres flujos útiles para empezar

1. Preparar una factura

Puedes facilitar cliente, concepto, cantidad y fecha para preparar la operación correspondiente. Antes de crearla, comprueba los datos fiscales, la numeración y cualquier campo calculado. El objetivo es reducir navegación y transcripción, no eliminar la revisión.

2. Revisar cobros pendientes

Una consulta de lectura puede recuperar facturas según estado o vencimiento. Con ese resultado puedes decidir cuáles necesitan seguimiento y redactar borradores por separado. El envío de comunicaciones debe respetar la configuración y las aprobaciones de tu flujo.

3. Consultar actividad desde el entorno de trabajo

Un equipo técnico puede consultar clientes, productos o facturas desde un cliente MCP sin cambiar de contexto. Sigue siendo importante limitar las credenciales al entorno correcto y verificar que la respuesta pertenece a la cuenta esperada.

MCP, API y webhooks cumplen funciones distintas

La API ofrece endpoints para integraciones programáticas. Los webhooks notifican eventos para que otro sistema pueda reaccionar. MCP permite que un cliente compatible descubra herramientas y las invoque mediante un protocolo común. Los tres mecanismos pueden convivir, pero no son intercambiables.

Para un flujo determinista y repetible, una integración directa con la API o un webhook suele ser la base adecuada. Para explorar datos, preparar una operación o trabajar desde una interfaz conversacional, MCP puede reducir fricción. En ambos casos, la autenticación, la validación de entradas y el registro de resultados siguen siendo esenciales.

Cómo empezar con seguridad

1. Consulta la documentación del servidor y de tu cliente MCP.
2. Crea o selecciona una API key para el entorno correcto.
3. Configura el paquete local o el endpoint remoto.
4. Empieza con una consulta de lectura de alcance limitado.
5. Inspecciona herramienta, argumentos y respuesta.
6. Activa operaciones de escritura solo cuando el proceso de revisión esté claro.

El valor de MCP no está en prometer que el ERP se gestiona solo. Está en ofrecer un contrato abierto y verificable para que las personas y sus herramientas trabajen con Frihet de una forma más directa, manteniendo el control sobre cada cambio.