Resumen de MCP
Conecta agentes de IA a Factuarea sobre el Model Context Protocol — tools de facturación, catálogo, precios, cumplimiento, control horario, proyectos y tareas, automatizaciones, webhooks y el modelo de cuentas, con autenticación OAuth 2.1 y API key.
El servidor implementa la revisión MCP 2026-07-28 y también atiende a clientes en 2025-11-25 y 2025-06-18. Consulta el protocolo y transporte para server/discover, cabeceras y paginación; usa los recursos y prompts para la orientación fiscal. Su repositorio público, con el paquete de npm y el manifiesto del registro, es factuarea/factuarea-mcp.
El servidor MCP de Factuarea expone la API pública como tools de Model Context Protocol, de modo que los agentes de IA (Claude, ChatGPT, Cursor, tu propia app LLM) pueden leer y operar sobre tus datos de facturación a través de un único endpoint gobernado en lugar de escribir a mano llamadas HTTP. Habla el transporte Streamable HTTP y vive en:
https://mcp.factuarea.comEl endpoint canónico es la raíz del subdominio. La forma anterior con path
https://mcp.factuarea.com/mcp sigue funcionando como alias de compatibilidad, así que
las configuraciones existentes siguen conectando.
Cada tool se corresponde con el mismo contrato https://api.factuarea.com/v1 documentado
en la Referencia de la API: recursos idénticos, el mismo
id opaco (UUID v7), los mismos errores normalizados, el mismo aislamiento
multi-tenant por empresa. La capa MCP añade descubrimiento (tools/list), aplicación de
scope por tool y un flujo de consentimiento para apps de terceros.
Instala el plugin de Claude Code
La configuración recomendada — dos comandos instalan el plugin oficial factuarea-mcp
y conectan Claude Code sobre OAuth.
Conecta cualquier cliente
Configura Claude Desktop, el MCP Inspector o cualquier cliente MCP, con OAuth o una API key, o ejecuta el servidor local de npm.
Explora las 668 tools
El catálogo completo agrupado por dominio, con el scope que requiere cada tool.
Qué puede hacer
El servidor publica 668 tools en los dominios de la API pública. Casi todo lo que puedes hacer con la REST API puedes hacerlo aquí, en el formato nativo de tool-calling del agente; la importación masiva de cuentas gestionadas, por ejemplo, no tiene tool (consulta el catálogo):
Ventas y compras
Facturas, presupuestos, facturas proforma, albaranes, documentos de control (DeCA), facturas recurrentes y gastos — crear, actualizar, transicionar, enviar y generar PDFs.
Catálogo y CRM
Contactos con roles de cliente/proveedor, productos medidos, presentaciones, variantes, ofertas, tarifas, series de numeración y tipos impositivos.
Cumplimiento
Registros, eventos y certificados de VeriFactu (AEAT), envíos a FACe (FacturaE), las declaraciones del Modelo 303/347/130, además de webhooks y el catálogo de eventos.
Control horario
Empleados, horarios de trabajo, el registro de fichajes, cierres mensuales, ausencias, presencia y festivos — el registro del RD-ley 8/2019.
Automatizaciones
El motor de reglas — el catálogo de disparadores y acciones, las reglas y sus versiones selladas, el ensayo, el historial de ejecuciones con sus pasos, el relanzamiento y la cuota mensual.
Cuentas y NIF
El modelo de cuentas — miembros y sus grants, traspasos de NIF, la cartera de NIF con su
estado y su disponibilidad de emisión, webhooks y registros de peticiones de la cuenta —
y, con los scopes privilegiados accounts:*, las cuentas gestionadas. Solo con API key.
Proyectos y tareas
Proyectos con sus tableros y campos personalizados, tareas con sus comentarios, relaciones, adjuntos y tiempo imputado, el temporizador, borradores de factura a partir de las horas facturables, los miembros de la empresa, las notificaciones y la agenda combinada.
Cuándo usar MCP, REST o SDKs
El servidor MCP, la REST API y los SDKs oficiales son tres puertas de entrada al mismo backend. Elige según quién (o qué) está llamando:
| Estás construyendo… | Usa | Por qué |
|---|---|---|
| Un agente / asistente de IA que razona sobre tus datos y actúa sobre ellos | Servidor MCP | Las tools se autodescriben; el modelo las descubre y las llama sin que cablees cada endpoint. Los scopes y el consentimiento se aplican en cada llamada. |
| Un servicio backend, cron job o integración con lógica fija | REST API | Determinista, sin modelo en el bucle, control total sobre las peticiones y los reintentos. |
| Un cliente tipado en tu app (TypeScript o PHP) | SDKs oficiales | @factuarea/sdk y factuarea/factuarea-php envuelven la REST API con tipos, reintentos y helpers de idempotencia. |
Las tres superficies comparten los mismos identificadores, envoltorio de error y scopes, así que puedes combinarlas: prototipa un flujo con un agente sobre MCP y luego endurece el camino crítico como una integración REST o SDK.
Dos formas de autenticarse
El mismo endpoint /mcp acepta dos tipos de credencial, para dos audiencias
distintas:
| Canal | Credencial | Para | Tools alcanzables |
|---|---|---|---|
| API key | Bearer token fact_live_… / fact_test_… | El titular de la cuenta automatizando su propia cuenta y sus NIF (como un PAT de GitHub) | Hasta 668 — concedes los scopes que quieras, incluido * (los scopes privilegiados accounts:* nunca los cubre *) |
| OAuth 2.1 | Access token emitido vía consentimiento | Apps de terceros actuando en nombre de un usuario | 541 — el catálogo curado; 127 tools de propietario (incluidos pagos, gestión de cuenta y escrituras privilegiadas de personal) exigen API key |
Consulta Conectar un cliente para la política completa de canales, y Scopes y permisos para el catálogo de scopes.
Construye primero en modo de prueba
Igual que en la REST API, una clave fact_test_ — o un consentimiento OAuth con el entorno
Test seleccionado — opera sobre una empresa sandbox aislada con los efectos
externos desactivados (sin transmisión a AEAT, sin emails reales, sin
webhooks salientes). Construye y valida contra test, luego cambia a producción. Consulta
Modo de prueba.
El servidor MCP está incluido en todos los planes de Factuarea, junto con el resto de la API pública. Crea una API key desde Dashboard → Developers → API Keys (o conéctate por OAuth) y empieza a llamar tools.