# 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](https://modelcontextprotocol.io) es el estándar abierto para conectar agentes a herramientas. Frihet expone **157 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.

```json
{
  "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.

```json
{
  "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 157 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](./mcp-server).

---

## SDK y CLI

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

```bash
npm install @frihet/sdk      # cliente TypeScript tipado
npm install -g @frihet/cli   # frihet desde la terminal
```

```ts
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](./sdk-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** — app nativa oficial (Beta pública). Conecta Frihet a más de [7.000+ apps](/integraciones/zapier) sin código: 14 triggers, 21 acciones y 8 búsquedas sobre facturas, gastos y clientes. [Ver en Zapier](https://zapier.com/apps/frihet/integrations).
- **n8n** — nodo oficial para flujos self-hosted.
- **Webhooks** — 27 eventos con firma HMAC-SHA256 para reaccionar a cambios en tiempo real. Ver [Webhooks](./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:

| Recurso                  | URL                                                                                                                       |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| Contexto LLM             | [`docs.frihet.io/llms.txt`](https://docs.frihet.io/llms.txt) · [`mcp.frihet.io/llms.txt`](https://mcp.frihet.io/llms.txt) |
| Especificación OpenAPI   | [`docs.frihet.io/openapi.json`](https://docs.frihet.io/openapi.json)                                                      |
| Referencia interactiva   | [`docs.frihet.io/api-reference`](/api-reference)                                                                          |
| Descriptor MCP           | [`mcp.frihet.io/.well-known/mcp`](https://mcp.frihet.io/.well-known/mcp)                                                  |
| Registro MCP (Anthropic) | [`registry.modelcontextprotocol.io`](https://registry.modelcontextprotocol.io/?q=io.frihet)                               |

---

## Ver también

- [Referencia interactiva de la API](/api-reference) — explora y prueba cada endpoint
- [Servidor MCP](./mcp-server) — las 157 herramientas en detalle
- [API REST](./api-rest) — auth, paginación, idempotencia, rate limiting
- [SDK y CLI](./sdk-cli)
- [Webhooks](./webhooks)