Factuarea

Factuarea MCP

Todo tu back office, a un servidor MCP de distancia.
Facturación con VeriFactu, compras, catálogo, impuestos, control horario y automatizaciones
para negocios españoles — como herramientas para Claude, ChatGPT, Cursor, VS Code y cualquier cliente MCP.

English · Español

Factuarea es una plataforma de facturación y gestión para empresas y autónomos en España. Este es su servidor oficial de Model Context Protocol — el mismo servicio que el equipo de Factuarea ejecuta en producción, no un envoltorio construido sobre él. Todo lo que puedes hacer en el panel de Factuarea o a través de su API REST, tu agente puede hacerlo en conversación: desde emitir una factura VeriFactu hasta comprobar quién fichó esta mañana.

Conectar

El servidor vive en https://mcp.factuarea.com. Añádelo a tu cliente e inicia sesión con tu cuenta de Factuarea — sin instalación, sin clave que copiar. En la pantalla de consentimiento eliges la empresa, el entorno (producción o prueba) y exactamente qué permisos conceder.

El acceso MCP está incluido en todos los planes de Factuarea, también durante la prueba.

claude mcp add --transport http factuarea https://mcp.factuarea.com \
  --header "Authorization: Bearer fact_test_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "mcpServers": {
    "factuarea": {
      "command": "npx",
      "args": ["-y", "@factuarea/mcp"],
      "env": { "FACTUAREA_API_KEY": "fact_test_xxxxxxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

Pídele cosas como

"Factura a Talleres Ruiz por el albarán de ayer y envíala por correo."

"¿Qué facturas de este trimestre siguen sin pagar? Envía un recordatorio a cada cliente."

"Convierte el presupuesto 2026-014 en una factura, pero cambia la fecha de vencimiento al día 30."

"Registra esta factura de proveedor y márcala como pagada por transferencia bancaria."

"Sube un 5 % todos los precios de la lista de precios al por mayor."

"Prepara el libro del Modelo 303 para el tercer trimestre."

"¿Por qué el pedido #1042 de WooCommerce no generó una factura?"

"¿Quién del equipo no ha fichado hoy?"

Qué cubre

Cada herramienta, su dominio y el permiso que necesita: docs.factuarea.com/mcp/tools.

Junto a las herramientas, el servidor publica 9 guías fiscales como recursos (factuarea://guardrails/…: emisión, anulación frente a rectificación, tipos de factura, líneas y importes, claves de régimen de IVA, series, identificación del comprador, requisitos previos de VeriFactu, múltiples empresas) y 5 flujos guiados como prompts: emitir una factura, corregir una fallida, registrar un cliente por NIF, conectar una tienda en línea y rastrear un pedido que nunca se facturó.

Diseñado para un agente que maneja dinero real

No romperá el registro fiscal. Algunos errores no se pueden deshacer una vez que existe una factura para la agencia tributaria: eliminar una factura emitida en lugar de anularla, editar una que ya no es un borrador, anular una rectificativa. El servidor rechaza esas llamadas antes de que se ejecute nada, y el rechazo (mcp_guardrail_violation) nombra la regla incumplida (rule_id) y la guía que explica el camino correcto (guardrail_uri), para que el agente pueda corregir el rumbo por sí solo.

Un reintento nunca crea una segunda factura. Las operaciones que no se pueden deshacer aceptan un idempotency_key. Si el agente repite la llamada después de un tiempo de espera, recibe el resultado original de vuelta, marcado como una reproducción, en lugar de un documento duplicado.

Solo ve lo que permitiste. Cada credencial lista solo las herramientas que sus ámbitos permiten, y cada llamada se verifica de nuevo. Las aplicaciones de terceros conectadas a través de OAuth reciben un catálogo seleccionado; las operaciones más sensibles — escrituras VeriFactu, borrado GDPR, pagos, claves API y empresas gestionadas — necesitan la clave API del propietario. Ninguna credencial accede a datos de una empresa a la que no se le concedió.

Practica primero con una copia. Una credencial de prueba funciona en un gemelo sandbox de tu empresa que hereda su plan: nada se envía a la AEAT, ningún correo llega a tus clientes, ningún webhook sale, y los envíos a FACe se simulan.

Seguridad y privacidad

OAuth 2.1 con PKCE y tokens de actualización rotativos; claves API mostradas una vez, almacenadas con hash, con caducidad opcional y lista de IP permitidas; las aplicaciones conectadas se pueden revocar desde el panel. Política de privacidad: factuarea.com/privacidad. Vulnerabilidades: sigue SECURITY.md.

Más de Factuarea para desarrolladores

• Documentación — referencia de la API REST, guías, códigos de error y llms.txt
• SDKs — TypeScript y PHP
• CLI — la API desde tu terminal
• Plugins de Claude Code — este servidor más habilidades para construir una integración
• Integraciones — n8n y WooCommerce

Preguntas

Contribuir

Este repositorio contiene el paquete npm y los manifiestos del registro; el servidor en sí se ejecuta en la plataforma de Factuarea. Lea CONTRIBUTING.md para configurar el proyecto (y AGENTS.md si trabaja con un agente de codificación), y el Código de Conducta antes de participar. Los cambios se enumeran en el CHANGELOG.

Licencia

El código en este repositorio es MIT. El uso del servidor alojado y de Factuarea está sujeto a los términos de servicio de Factuarea.