Skip to main content

Usar Frihet desde un agente de IA

Frihet está construido para que un agente de IA lo opere de principio a fin. No es una API con una capa de IA encima: el ERP es nativo para agentes. Un asistente puede crear una factura, conciliar un banco, preparar un Modelo 303 o consultar tu tesorería — en lenguaje natural, con salida estructurada y trazable.

Esta página es el punto de entrada. Elige el canal que encaje con tu stack y estás operando en dos minutos.

Tu:      "Crea una factura para TechStart SL, 40 horas de consultoría a 75 EUR/h, vencimiento 1 marzo"
Agente:  Hecho. Factura INV-2026-089 — 3.000,00 EUR + 21% IVA = 3.630,00 EUR.

Quickstart — servidor MCP​

El Model Context Protocol es el estándar abierto para conectar agentes a herramientas. Frihet expone 151 herramientas MCP — CRUD completo sobre facturación, gastos, clientes, banca, fiscal (Modelo 303/130/390/347, VeriFactu, TicketBAI), e-invoicing europeo y más.

Hay dos formas de conectarse. Elige una.

Opción A — Remoto (cero instalación)​

El endpoint mcp.frihet.io está siempre disponible. No instalas nada; el cliente autentica vía OAuth en el navegador o con tu API key.

{
  "mcpServers": {
    "frihet": {
      "url": "https://mcp.frihet.io/mcp"
    }
  }
}

Clientes con soporte OAuth (Claude Desktop, Cursor, Smithery) abren una ventana de autorización la primera vez. Si tu cliente no soporta OAuth, pasa tu API key como Authorization: Bearer fri_....

Opción B — Local (stdio)​

Para Claude Code, Cursor o cualquier cliente stdio, instala el paquete y exporta tu API key.

{
  "mcpServers": {
    "frihet": {
      "command": "npx",
      "args": ["-y", "@frihet/mcp-server"],
      "env": { "FRIHET_API_KEY": "fri_tu_clave_aqui" }
    }
  }
}

Obtén tu API key en app.frihet.io → Configuración → Desarrolladores → API Keys.

Divulgación progresiva (grouped mode)​

Un agente que se enfrenta a 151 herramientas de golpe gasta contexto leyendo descripciones que no va a usar. El endpoint remoto agent-facing (mcp.frihet.io) resuelve esto con divulgación progresiva: en lugar del muro plano, tools/list devuelve resúmenes de una línea más tres meta-herramientas de descubrimiento:

  • list_tool_groups() — los dominios disponibles (facturación, fiscal, banca, CRM, RRHH, stay, POS…) con su recuento.
  • search_tools(query) — busca herramientas por texto libre y devuelve sólo las relevantes.
  • describe_tool(name) — carga el esquema completo de una herramienta concreta, bajo demanda.

El agente lee el catálogo terso, busca lo que necesita y carga la profundidad sólo de las pocas herramientas que va a llamar. Cada herramienta sigue siendo invocable por su nombre real — no se quita nada, sólo se colapsa el listado. El paquete npm local se queda en modo full por defecto, porque los clientes locales gestionan su propio contexto.

Detalle completo en Servidor MCP.

SDK y CLI​

Si prefieres código a lenguaje natural, el SDK oficial y la CLI envuelven la misma API REST.

npm install @frihet/sdk      # cliente TypeScript tipado
npm install -g @frihet/cli   # frihet desde la terminal
import { Frihet } from '@frihet/sdk';
const frihet = new Frihet({ apiKey: process.env.FRIHET_API_KEY });
const invoice = await frihet.invoices.create({ clientId, lines, dueDate });

Referencia completa en SDK y CLI.

Otros canales​

El mismo motor está expuesto en las plataformas donde ya vive tu automatización.

  • ChatGPT — Frihet está disponible como app/GPT a través del endpoint openai-mcp.frihet.io, con la superficie de herramientas revisada para la política de OpenAI.
  • Zapier — conecta Frihet a más de 7.000 apps sin código. Triggers y acciones sobre facturas, gastos y clientes.
  • n8n — nodo oficial para flujos self-hosted.
  • Webhooks — 27 eventos con firma HMAC-SHA256 para reaccionar a cambios en tiempo real. Ver Webhooks.

Superficie descubrible por IA​

Cada subdominio de Frihet es citable por un agente que investiga "ERP español con IA". Si construyes sobre Frihet, estas rutas son tu contrato de descubrimiento:

RecursoURL
Contexto LLMdocs.frihet.io/llms.txt · mcp.frihet.io/llms.txt
Especificación OpenAPIdocs.frihet.io/openapi.json
Referencia interactivadocs.frihet.io/api-reference
Descriptor MCPmcp.frihet.io/.well-known/mcp
Registro MCP (Anthropic)registry.modelcontextprotocol.io

Detalle en AI-discoverability.

Ver también​