Resumen
Conecta agentes de IA a Factuarea sobre el Model Context Protocol — 232 tools de facturación, catálogo, cumplimiento y webhooks, con autenticación OAuth 2.1 y API key.
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 manualmente, usando OAuth o una API key.
Explora las 232 tools
El catálogo completo agrupado por dominio, con el scope que requiere cada tool.
Qué puede hacer
El servidor publica 232 tools en 15 dominios. Todo lo que puedes hacer con la REST API puedes hacerlo aquí, en el formato nativo de tool-calling del agente:
Ventas y compras
Facturas, presupuestos, facturas proforma, albaranes, facturas recurrentes y facturas de compra — crear, actualizar, transicionar, enviar y generar PDFs.
Catálogo y CRM
Clientes, proveedores, productos, series de numeración y tipos impositivos.
Cumplimiento
Registros, eventos y certificados de VeriFactu (AEAT), envíos a FACe (FacturaE), además de webhooks y el catálogo de eventos.
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 empresa (como un PAT de GitHub) | Hasta 232 — concedes los scopes que quieras, incluido * |
| OAuth 2.1 | Access token emitido vía consentimiento | Apps de terceros actuando en nombre de un usuario | 218 — un catálogo curado que excluye las escrituras de VeriFactu, el borrado RGPD y las tools de FacturaE (FACe) |
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á en beta privada, junto con el resto de la API pública. Solicita acceso en info@factuarea.com — consulta Solicitar acceso beta.