f facturifirma

MCP · Model Context Protocol

Collega un assistente AI alla tua azienda

facturifirma espone un server MCP su HTTP streamabile. Qualsiasi client compatibile (Claude, Claude Code, altri agenti) può emettere fatture, inviarle allo SPV, gestire i clienti e generare report direttamente dalla conversazione.

Inizia gratis Strumenti disponibili

Cos'è il connettore MCP

MCP (Model Context Protocol) è uno standard aperto che permette a un assistente AI di chiamare strumenti (tools) esposti da un'applicazione. Il connettore facturifirma offre accesso completo in lettura/scrittura a aziende, documenti, clienti e report, con le stesse regole di business di app e API.

Endpoint

Server MCP HTTP streamabile, disponibile all'indirizzo qui sotto.

https://app.facturifirma.ro/mcp

Autenticazione

Opzione 1 — OAuth (consigliata per claude.ai / ChatGPT)

Per i client che non possono inviare un header Authorization personalizzato (connettori web di claude.ai, ChatGPT), l'autorizzazione avviene nel browser tramite OAuth 2.1.

  1. 1. In claude.ai: apri Impostazioni → Connectors e clicca “Add custom connector”.
  2. 2. Assegna un nome (es. “facturifirma”), incolla l'indirizzo https://app.facturifirma.ro/mcp e clicca “Add”.
  3. 3. Clicca “Connect” sul nuovo connettore — verrai portato su facturifirma per accedere (se non l'hai già fatto).
  4. 4. Clicca “Consenti” nella schermata di consenso. Torni su claude.ai con il connettore “Connected” — nessun client ID o secret da configurare.
https://app.facturifirma.ro/mcp

Opzione 2 — Chiave API (Bearer)

Per i client che possono inviare header personalizzati (Claude Code, Claude Desktop, altri agenti), usa una chiave API come header Bearer.

  1. 1. Crea una chiave API nell'app: Impostazioni → Chiavi API.
  2. 2. Invia la chiave come header Authorization: Bearer <CHIAVE_API> in ogni richiesta.
  3. 3. Configura il tuo client MCP (Claude Code, Claude Desktop, ecc.) con l'endpoint e l'header qui sotto.

Claude Code (CLI)

claude mcp add --transport http facturifirma https://app.facturifirma.ro/mcp --header "Authorization: Bearer <API_KEY>"

Configurazione generica (JSON)

{
  "mcpServers": {
    "facturifirma": {
      "url": "https://app.facturifirma.ro/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}

Strumenti disponibili

L'elenco reale degli strumenti esposti dal server, raggruppati per area:

Fatturazione e documenti

Crea, modifica, emetti e incassa fatture, proforma e note di credito.

list_documentscreate_invoiceupdate_invoiceissue_documentdelete_documentrecord_paymentreverse_invoiceconvert_proformalist_purchases

e-Factura ANAF

Invia documenti allo SPV, monitora lo stato e importa le fatture ricevute.

send_to_anafpoll_efacturasync_inboxlist_inboximport_inbox

Aziende

Elenca e gestisci le aziende del tuo account.

list_companiescreate_companyget_companyupdate_company

Clienti

Crea e gestisci i clienti (controparti) di un'azienda.

list_clientscreate_clientget_clientupdate_clientdelete_client

Fornitori

Crea e gestisci i fornitori (le controparti da cui acquisti) di un'azienda.

list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplier

Spese

Registra e gestisci le spese dei fornitori.

list_expensescreate_expenseupdate_expensedelete_expense

Fatture ricorrenti

Crea modelli che generano automaticamente bozze di fattura secondo una cadenza.

list_recurringcreate_recurringupdate_recurringdelete_recurring

Conti bancari

Elenca e sostituisci i conti bancari di un'azienda, un cliente o un fornitore.

list_bank_accountsreplace_bank_accounts

Dati pubblici ANAF

Cerca un'azienda romena per CUI (nome, indirizzo, stato IVA/e-Factura).

lookup_company

Catalogo e operazioni

Prodotti, magazzini e serie di numerazione.

list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_series

Report

Giornale vendite, report IVA e riconciliazione bancaria.

sales_journalvat_reportreconcile_bank

Impostazioni

Leggi e aggiorna la configurazione del tenant.

get_settings_schemaget_settingsupdate_settings

Sicurezza

Una chiave API è associata al tuo account (tenant) e può essere revocata in qualsiasi momento da Impostazioni → Chiavi API. Ogni chiamata MCP viene eseguita con gli stessi permessi dell'utente che ha generato la chiave — niente di più.

Pronto a collegare un assistente AI?

Crea una chiave API nell'app e aggiungila al tuo client MCP preferito.

Apri l'app

← Torna alla home