Factuarea
Probar gratis
Developers · API · MCP

Una API REST y un servidor MCP propio para construir sobre Factuarea.

Emite facturas, gestiona clientes y consulta el estado VeriFactu desde tu código. Conecta Claude o tu propio agente IA al servidor MCP oficial y deja que opere la facturación con permisos acotados. La API y el servidor MCP están en acceso anticipado.

  • REST · OpenAPI 3.1
  • MCP servidor oficial
  • Webhooks firmados
  • Sandbox · <5 min
Empezar en 3 pasosVer la documentación
# Conecta Claude u otro cliente MCP a Factuarea
# ~/.claude/claude_desktop_config.json
{
  "mcpServers": {
    "factuarea": {
      "type": "http",
      "url": "https://mcp.factuarea.com"
    }
  }
}
Developers

Construye sobre Factuarea.

API REST y servidor MCP propio para que conectes tu agente o producto. Conecta tu propio LLM, automatiza emisión masiva, exporta y sincroniza con tu stack.

de cero a tu primera factura en 5 minutos

REST · OpenAPI 3.1MCP servidor oficialWebhooks firmadosSandbox · <5 min
Ir a la documentación →Configurar MCP
# Conecta Claude u otro cliente MCP a Factuarea# ~/.claude/claude_desktop_config.json{  "mcpServers": {    "factuarea": {      "type": "http",      "url": "https://mcp.factuarea.com"    }  }}
# Emite una factura (VeriFactu se registra automáticamente)curl -X POST https://api.factuarea.com/v1/invoices \  -H "Authorization: Bearer fact_live_…" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: $(uuidgen)" \  -d '{    "client_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01",    "series_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0e",    "issued_on": "2026-06-02",    "due_on": "2026-07-02",    "lines": [      { "description": "Diseño campaña", "quantity": 1, "unit_price": 1100.00 },      { "description": "Producción",     "quantity": 1, "unit_price":  320.55 }    ]  }'
// npm install @factuarea/sdkimport { Factuarea } from "@factuarea/sdk";const fc = new Factuarea({ apiKey: process.env.FACTUAREA_API_KEY });const invoice = await fc.invoices.create({  client_id: "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01",  series_id: "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0e",  issued_on: "2026-06-02",   due_on: "2026-07-02",  lines: [    { description: "Diseño campaña", quantity: 1, unit_price: 1100.00 },    { description: "Producción",    quantity: 1, unit_price:  320.55 }  ],});console.log(invoice.id);
// composer require factuarea/sdkuse Factuarea\Factuarea;$fc = new Factuarea(apiKey: "fact_live_…");$invoice = $fc->invoices->create([    "client_id" => "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01",    "series_id" => "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a0e",    "issued_on" => "2026-06-02",    "due_on"    => "2026-07-02",    "lines"     => [        ["description" => "Diseño campaña", "quantity" => 1, "unit_price" => 1100.00],        ["description" => "Producción",     "quantity" => 1, "unit_price" =>  320.55],    ],]);echo $invoice->id;
MCP · Claude · Agentes IA

Conecta un agente IA a tu facturación con el servidor MCP

El servidor MCP de Factuarea expone tu facturación como herramientas que un modelo puede usar. Un agente lee y escribe en tu cuenta a través de tools acotadas, sin que programes una integración por cada endpoint.

Qué es el servidor MCP público de Factuarea

Es un servidor MCP oficial con autenticación OAuth y API keys. Expone solo las tools marcadas como públicas, nunca toda la API interna. Cada tool corresponde a una acción concreta de tu cuenta como emitir una factura o buscar un cliente.

Las tools se modelan por scope, módulo y feature flag. El agente solo accede a lo que su clave permite y a los módulos que tienes activos, así que controlas qué puede hacer antes de darle acceso.

Por qué importa para un agente IA

  • Permisos acotados por scope

    El agente opera con los scopes de su clave. Una clave de solo lectura consulta facturas pero no emite, así que delegas tareas sin ceder el control de la cuenta.

  • Sin glue code por endpoint

    El modelo descubre las tools y sus parámetros por sí mismo. No escribes un wrapper por endpoint para que el agente sepa emitir una factura o conciliar un cobro.

  • Acciones reales, no chat aislado

    Cada tool ejecuta una acción de tu cuenta y devuelve datos reales. El agente emite con VeriFactu, busca por NIF y concilia importes contra tus cobros.

Cómo conectar Claude, Claude Code o tu agente

Añade el servidor MCP por HTTP en la configuración de tu cliente y autentícate con OAuth o una API key. El mismo bloque vale para Claude Desktop, Claude Code y cualquier cliente MCP.

  • y cualquier cliente MCP
  • Claude DesktopPega el bloque en claude_desktop_config.json y reinicia la app. Claude descubre las tools de Factuarea al arrancar.
  • Claude CodeRegistra el servidor en tu configuración de Claude Code para operar la facturación desde la terminal junto a tu repositorio.
  • Tu propio agenteCualquier cliente MCP se conecta con la misma URL y credenciales. Tu agente a medida usa las tools sin código específico de Factuarea.
~/.claude/claude_desktop_config.json
# Conecta Claude u otro cliente MCP a Factuarea
# ~/.claude/claude_desktop_config.json
{
  "mcpServers": {
    "factuarea": {
      "type": "http",
      "url": "https://mcp.factuarea.com"
    }
  }
}

Casos de uso anclados a tools reales del servidor

  • create_invoice

    Emitir una factura conversando

    Pide al agente la factura de un cliente con sus conceptos. La tool la crea con registro VeriFactu y devuelve el id y el QR.

    scope invoices:write

  • search_invoices

    Localizar facturas vencidas

    El agente busca las facturas pendientes pasadas de plazo por cliente o fecha y prepara el recordatorio de cobro.

    scope invoices:read

  • register_invoice_payment

    Conciliar un cobro

    Empareja un pago con su factura por importe, referencia y fecha, y marca la factura como cobrada en tu cuenta.

    scope payments:write

  • create_client

    Dar de alta un cliente por NIF

    Crea el cliente con sus datos fiscales a partir del NIF o CIF para tenerlo listo antes de emitir la primera factura.

    scope clients:write

  • get_invoice_verifactu

    Consultar el estado VeriFactu

    Devuelve el estado del registro VeriFactu de una factura para confirmar que el envío a la AEAT quedó completado.

    scope verifactu:read

Tus datos están protegidos

Tratamos los datos de tu cuenta conforme al RGPD. Las conexiones van cifradas, el agente solo accede a lo que su clave permite y trabajamos con proveedores que aportan garantías de seguridad y cláusulas de tratamiento. Lo que el agente lee o escribe queda en tu cuenta.

Conforme al RGPDConexiones cifradasAcceso por scopeProveedores con garantías
Política de privacidad
Ver la documentación de MCP
Inicio rápido

De cero a tu primera llamada en 3 pasos

Genera una clave, haz una llamada REST y conecta el servidor MCP. En sandbox no afecta a tus datos reales.

  1. Obtén tu API key en el panelEntra en Ajustes y Developers de tu cuenta, crea una clave con los scopes que necesites y guárdala. Usa una clave de sandbox para tus primeras pruebas.
  2. Haz tu primera llamada RESTEmite una factura con un POST a /v1/invoices usando tu Bearer token. La respuesta incluye el id y el registro VeriFactu de la factura.
  3. Conecta el servidor MCPAñade el servidor MCP a Claude o a tu agente con el mismo token. A partir de ahí el agente opera la facturación con las tools públicas.
Abrir la referencia de la API
Capacidades de la API

Todo lo que gestionas desde el código

Recursos REST para tu facturación, webhooks firmados para reaccionar a los cambios y scopes para acotar cada clave.

  • Recursos y endpoints

    Crea, lee y actualiza los objetos de tu cuenta con una API REST sobre JSON, documentada en OpenAPI 3.1.

    • Facturas con registro VeriFactu
    • Clientes y datos fiscales por NIF
    • Productos y conceptos reutilizables
    • Series y numeración de facturación
    Ver recursos

  • Webhooks firmados

    Recibe eventos en tu endpoint cuando algo cambia. Cada entrega va firmada para que verifiques su origen.

    • invoice.created e invoice.paid
    • invoice.verifactu_submitted
    • client.created y client.updated
    • Firma HMAC y reintentos automáticos
    Ver webhooks

  • Scopes y permisos

    Cada API key lleva los scopes que le asignas. Una clave hace solo lo que su permiso autoriza, en la API y en el MCP.

    • Scopes de lectura y escritura por recurso
    • Claves de sandbox y de producción
    • Permisos compartidos por API y servidor MCP
    • Rotación y revocación desde el panel
    Ver scopes
Ver la documentación completa

Preguntas frecuentes de developers

Resolvemos las dudas más habituales sobre autenticación, webhooks, sandbox y el servidor MCP.

Para llamadas servidor a servidor usas una API key como Bearer token. Para que un agente o app de terceros actúe en nombre de un usuario usas OAuth. El servidor MCP admite ambos, así eliges según tu caso.

Cada clave tiene un límite por minuto y la respuesta incluye las cabeceras con el cupo restante. Si lo superas recibes un 429 con el tiempo de espera, así que puedes reintentar con backoff.

Sí. Las claves de sandbox operan sobre datos de prueba aislados de tu cuenta real. Emites facturas y disparas webhooks sin afectar tu facturación ni enviar nada a la AEAT.

Cada entrega lleva una cabecera con una firma HMAC calculada con tu secreto de webhook. Recalculas el HMAC sobre el cuerpo recibido y lo comparas con la firma para confirmar que el evento viene de Factuarea.

Solo las marcadas como públicas, modeladas por scope, módulo y feature flag. Incluyen emitir y buscar facturas, conciliar cobros, dar de alta clientes y consultar el estado VeriFactu. La lista completa está en la documentación de MCP.

Sí. Al emitir una factura por la API se genera su registro VeriFactu y la respuesta incluye su id y su QR. También consultas el estado del envío a la AEAT con el endpoint de estado VeriFactu.

Tu primera integración hoy

Crea tu cuenta y obtén tu API key

Genera una clave en el panel, conecta el servidor MCP a tu agente y emite la primera factura en sandbox. Sin tarjeta para probar.

Crear cuenta gratuitaIr a la documentación