MCP · Model Context Protocol
Conecta un asistente de IA a tu empresa
facturifirma expone un servidor MCP sobre HTTP en streaming. Cualquier cliente compatible (Claude, Claude Code, otros agentes) puede emitir facturas, enviarlas al SPV, gestionar clientes y generar informes directamente desde la conversación.
Qué es el conector MCP
MCP (Model Context Protocol) es un estándar abierto para que un asistente de IA llame a herramientas (tools) expuestas por una aplicación. El conector de facturifirma ofrece acceso completo de lectura/escritura a tus empresas, documentos, clientes e informes, con las mismas reglas de negocio que la app y la API.
Endpoint
Servidor MCP HTTP en streaming, disponible en la dirección de abajo.
https://app.facturifirma.ro/mcpAutenticación
Opción 1 — OAuth (recomendado para claude.ai / ChatGPT)
Para clientes que no pueden enviar una cabecera Authorization personalizada (conectores web de claude.ai, ChatGPT), la autorización se realiza en el navegador mediante OAuth 2.1.
- 1. En claude.ai: abre Ajustes → Connectors y pulsa “Add custom connector”.
- 2. Ponle un nombre (p. ej. “facturifirma”), pega la dirección https://app.facturifirma.ro/mcp y pulsa “Add”.
- 3. Pulsa “Connect” en el nuevo conector — se te llevará a facturifirma para iniciar sesión (si aún no lo has hecho).
- 4. Pulsa “Permitir” en la pantalla de consentimiento. Vuelves a claude.ai con el conector “Connected” — sin client ID ni secret que configurar.
https://app.facturifirma.ro/mcpOpción 2 — Clave API (Bearer)
Para clientes que pueden enviar cabeceras personalizadas (Claude Code, Claude Desktop, otros agentes), usa una clave API como cabecera Bearer.
- 1. Crea una clave API en la app: Configuración → Claves API.
- 2. Envía la clave como cabecera Authorization: Bearer <CLAVE_API> en cada solicitud.
- 3. Configura tu cliente MCP (Claude Code, Claude Desktop, etc.) con el endpoint y la cabecera de abajo.
Claude Code (CLI)
claude mcp add --transport http facturifirma https://app.facturifirma.ro/mcp --header "Authorization: Bearer <API_KEY>"Configuración genérica (JSON)
{
"mcpServers": {
"facturifirma": {
"url": "https://app.facturifirma.ro/mcp",
"headers": {
"Authorization": "Bearer <API_KEY>"
}
}
}
}Herramientas disponibles
La lista real de herramientas que expone el servidor, agrupadas por área:
Facturación y documentos
Crea, edita, emite y cobra facturas, proformas y notas de crédito.
list_documentscreate_invoiceupdate_invoiceissue_documentdelete_documentrecord_paymentreverse_invoiceconvert_proformalist_purchasese-Factura ANAF
Envía documentos al SPV, sigue su estado e importa las facturas recibidas.
send_to_anafpoll_efacturasync_inboxlist_inboximport_inboxe-Transport ANAF
Declara transportes (UIT), sigue su estado y anula declaraciones, con vehículos reutilizables.
declare_transportlist_transport_declarationsget_transport_declarationsync_etransportcancel_transport_declarationlist_vehiclescreate_vehicleEmpresas
Lista y gestiona las empresas de tu cuenta.
list_companiescreate_companyget_companyupdate_companyClientes
Crea y gestiona los clientes (contrapartes) de una empresa.
list_clientscreate_clientget_clientupdate_clientdelete_clientProveedores
Crea y gestiona los proveedores (las contrapartes a las que compras) de una empresa.
list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplierGastos
Registra y gestiona los gastos de proveedores.
list_expensescreate_expenseupdate_expensedelete_expenseFacturas recurrentes
Crea plantillas que generan automáticamente borradores de factura según una cadencia.
list_recurringcreate_recurringupdate_recurringdelete_recurringCuentas bancarias
Lista y reemplaza las cuentas bancarias de una empresa, cliente o proveedor.
list_bank_accountsreplace_bank_accountsDatos públicos de ANAF
Busca una empresa rumana por CUI (nombre, dirección, estado de IVA/e-Factura).
lookup_companyCatálogo y operaciones
Productos, almacenes y series de numeración.
list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_seriesInformes
Libro de ventas, informe de IVA y conciliación bancaria.
sales_journalvat_reportreconcile_bankConfiguración
Lee y actualiza la configuración del tenant.
get_settings_schemaget_settingsupdate_settingsSeguridad
Una clave API está vinculada a tu cuenta (tenant) y puede revocarse en cualquier momento desde Configuración → Claves API. Cada llamada MCP se ejecuta con los mismos permisos que el usuario que generó la clave, nada más.
¿Listo para conectar un asistente de IA?
Crea una clave API en la app y añádela a tu cliente MCP favorito.
Abrir la app