f facturifirma

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.

Empieza gratis Herramientas disponibles

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/mcp

Autenticació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. 1. En claude.ai: abre Ajustes → Connectors y pulsa “Add custom connector”.
  2. 2. Ponle un nombre (p. ej. “facturifirma”), pega la dirección https://app.facturifirma.ro/mcp y pulsa “Add”.
  3. 3. Pulsa “Connect” en el nuevo conector — se te llevará a facturifirma para iniciar sesión (si aún no lo has hecho).
  4. 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/mcp

Opció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. 1. Crea una clave API en la app: Configuración → Claves API.
  2. 2. Envía la clave como cabecera Authorization: Bearer <CLAVE_API> en cada solicitud.
  3. 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_purchases

e-Factura ANAF

Envía documentos al SPV, sigue su estado e importa las facturas recibidas.

send_to_anafpoll_efacturasync_inboxlist_inboximport_inbox

Empresas

Lista y gestiona las empresas de tu cuenta.

list_companiescreate_companyget_companyupdate_company

Clientes

Crea y gestiona los clientes (contrapartes) de una empresa.

list_clientscreate_clientget_clientupdate_clientdelete_client

Proveedores

Crea y gestiona los proveedores (las contrapartes a las que compras) de una empresa.

list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplier

Gastos

Registra y gestiona los gastos de proveedores.

list_expensescreate_expenseupdate_expensedelete_expense

Facturas recurrentes

Crea plantillas que generan automáticamente borradores de factura según una cadencia.

list_recurringcreate_recurringupdate_recurringdelete_recurring

Cuentas bancarias

Lista y reemplaza las cuentas bancarias de una empresa, cliente o proveedor.

list_bank_accountsreplace_bank_accounts

Datos públicos de ANAF

Busca una empresa rumana por CUI (nombre, dirección, estado de IVA/e-Factura).

lookup_company

Catálogo y operaciones

Productos, almacenes y series de numeración.

list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_series

Informes

Libro de ventas, informe de IVA y conciliación bancaria.

sales_journalvat_reportreconcile_bank

Configuración

Lee y actualiza la configuración del tenant.

get_settings_schemaget_settingsupdate_settings

Seguridad

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

← Volver al inicio