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.
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/mcpAutenticazione
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. In claude.ai: apri Impostazioni → Connectors e clicca “Add custom connector”.
- 2. Assegna un nome (es. “facturifirma”), incolla l'indirizzo https://app.facturifirma.ro/mcp e clicca “Add”.
- 3. Clicca “Connect” sul nuovo connettore — verrai portato su facturifirma per accedere (se non l'hai già fatto).
- 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/mcpOpzione 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. Crea una chiave API nell'app: Impostazioni → Chiavi API.
- 2. Invia la chiave come header Authorization: Bearer <CHIAVE_API> in ogni richiesta.
- 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_purchasese-Factura ANAF
Invia documenti allo SPV, monitora lo stato e importa le fatture ricevute.
send_to_anafpoll_efacturasync_inboxlist_inboximport_inboxe-Transport ANAF
Dichiara trasporti (UIT), monitora lo stato e annulla dichiarazioni, con veicoli riutilizzabili.
declare_transportlist_transport_declarationsget_transport_declarationsync_etransportcancel_transport_declarationlist_vehiclescreate_vehicleAziende
Elenca e gestisci le aziende del tuo account.
list_companiescreate_companyget_companyupdate_companyClienti
Crea e gestisci i clienti (controparti) di un'azienda.
list_clientscreate_clientget_clientupdate_clientdelete_clientFornitori
Crea e gestisci i fornitori (le controparti da cui acquisti) di un'azienda.
list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplierSpese
Registra e gestisci le spese dei fornitori.
list_expensescreate_expenseupdate_expensedelete_expenseFatture ricorrenti
Crea modelli che generano automaticamente bozze di fattura secondo una cadenza.
list_recurringcreate_recurringupdate_recurringdelete_recurringConti bancari
Elenca e sostituisci i conti bancari di un'azienda, un cliente o un fornitore.
list_bank_accountsreplace_bank_accountsDati pubblici ANAF
Cerca un'azienda romena per CUI (nome, indirizzo, stato IVA/e-Factura).
lookup_companyCatalogo e operazioni
Prodotti, magazzini e serie di numerazione.
list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_seriesReport
Giornale vendite, report IVA e riconciliazione bancaria.
sales_journalvat_reportreconcile_bankImpostazioni
Leggi e aggiorna la configurazione del tenant.
get_settings_schemaget_settingsupdate_settingsSicurezza
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