FAQ
Domande frequenti sul connettore MCP Fattura24, raggruppate per area tematica. Espandi le voci che ti interessano cliccando sulla domanda.
Usa il menu di navigazione laterale per saltare direttamente al gruppo che ti interessa, oppure usa la ricerca interna del sito (Ctrl+K / Cmd+K).
Se ti stai chiedendo se vale la pena usarlo, inizia da Vale la pena usarlo?. Se ti stai chiedendo quanto ci si può fidare delle analisi, vai a Fiducia e affidabilità.
Vale la pena usarlo?
In cosa è diverso dai report che ho già in Fattura24?
Fattura24 mostra i dati che i suoi report sono stati progettati per mostrare. Il connettore ti permette di fare la domanda che ti stai facendo adesso — anche se non era stata anticipata, anche se richiede di incrociare più fonti, anche se la vuoi formulata in un modo specifico per il tuo interlocutore.
Esempio concreto: in Fattura24 puoi vedere il report prodotti. Con il connettore puoi chiedere:
Analizza i prodotti venduti nel 2026 e confrontali con il 2025:
quali sono cresciuti, quali sono calati,
e dove c’è qualcosa che vale la pena approfondire commercialmente.
Non è un report diverso. È un ragionamento costruito sopra i tuoi dati, con le tue priorità.
Ho già il commercialista. Mi serve ancora questo?
Il connettore non sostituisce il commercialista — e non dovrebbe provarci. Serve per un’altra cosa: arrivare preparato all’incontro con lui.
Invece di portare una vaga sensazione su come è andato il trimestre, porti un documento con andamento ricavi mese per mese, analisi IVA, documenti scartati dallo SDI e cinque domande specifiche che emergono dai tuoi dati. Il tempo con il commercialista diventa più produttivo perché non lo usi per recuperare informazioni di base.
Il connettore serve a te per capire i tuoi dati nel quotidiano. Il commercialista serve per le valutazioni fiscali, gli adempimenti e le decisioni con impatto legale o contabile.
Non ho tempo per imparare un altro strumento.
Non c’è nulla da imparare, nel senso tradizionale. Non ci sono menu, non ci sono report da configurare, non c’è una nuova interfaccia da capire. Parli con l’assistente come parleresti con un collega: in italiano, in linguaggio naturale.
Il collegamento iniziale richiede cinque minuti (vedi Configurazione). Dopo, basta fare domande.
Vale il costo aggiuntivo rispetto al solo abbonamento Fattura24?
Il connettore è incluso nell’abbonamento Fattura24 (nei piani che lo prevedono) e non ha un costo separato da parte di Fattura24.
Il costo che potresti sostenere in più è quello del client AI — Claude, ChatGPT o altri — se non ne hai già uno. Valuta quanto vale per te ridurre il lavoro manuale di consultazione, preparazione di report e analisi periodiche. Se usi il connettore anche solo per la chiusura mese e la preparazione dell’incontro col commercialista, il risparmio di tempo è misurabile in ore al mese.
I miei dati in Fattura24 non sono sempre in ordine. Funziona comunque?
Funziona, ma l’output dipende dalla qualità dei dati in ingresso. Se le fatture hanno categorie mancanti, importi non registrati correttamente, l’assistente lavora su quei dati così come sono e non può correggerli.
Il connettore può anzi aiutarti a identificare incongruenze: chiedi all’assistente di evidenziare anomalie nei dati e potresti trovare cose da sistemare in Fattura24.
Se hai dubbi sulla qualità di certi dati, inizia da aree che sai essere accurate — ad esempio il fatturato se emetti sempre le fatture regolarmente — e usa il connettore per quelle prima di espanderti ad aree più critiche.
Introduzione e accesso
Cos’è il connettore MCP Fattura24?
È un connettore remoto basato su Model Context Protocol che permette a un assistente AI compatibile di consultare dati Fattura24 dopo autorizzazione dell’utente.
L’utente può fare domande in linguaggio naturale su documenti, fatturato, incassi, pagamenti, prodotti, IVA, bilancino e forecast.
Devo installare qualcosa sul computer?
No. Il connettore Fattura24 è un Remote MCP server raggiungibile via HTTPS.
Per l’utente finale è sufficiente aggiungerlo dal client AI compatibile oppure collegarlo dalla directory, quando disponibile.
Qual è l’URL del connettore?
https://www.app.fattura24.com/mcp
Usa solo questo URL. Non aggiungere API key, token o password come parametri.
Come avviene l’autenticazione?
L’autenticazione avviene tramite OAuth 2.0 con PKCE. Il client AI apre il flusso di login Fattura24, l’utente si autentica e autorizza la connessione.
Il connettore usa lo scope OAuth mcp.
Il connettore vede la mia password Fattura24?
No. La password viene inserita esclusivamente nel flusso di login Fattura24. Il client AI e il connettore usano token OAuth per le chiamate autorizzate, senza mai accedere alle credenziali.
Compatibilità e attivazione
Con quali client AI funziona?
Il server segue lo standard Remote MCP. La compatibilità pratica dipende dal client: deve supportare Remote MCP, OAuth 2.0 e il trasporto Streamable HTTP.
Client attualmente verificati:
- Claude Desktop: supportato come custom connector. Dopo la pubblicazione nella Connectors Directory potrà essere collegato direttamente dalla scheda del connettore.
- ChatGPT: supportato in Modalità sviluppatore tramite configurazione manuale.
- Altri client MCP: funziona con qualsiasi client che supporta Remote MCP con OAuth (es. Cursor, Windsurf, IDE con plugin MCP), tramite file di configurazione JSON.
Per la procedura completa vedi Configurazione.
Come lo abilito in una conversazione?
Dopo aver collegato il connettore nelle impostazioni del client AI, apri una chat e abilitalo dal menu dei connettori o degli strumenti.
Poi usa prompt espliciti come:
Usa Fattura24 e mostrami il fatturato mensile del 2026.
Cosa può fare il connettore
Quali dati può leggere?
Può leggere i dati esposti dai tool MCP disponibili, in base ai permessi dell’utente autenticato:
- documenti di vendita e acquisto;
- stati pagamento, SDI e Sistema Tessera Sanitaria;
- report fatturato;
- report incassi e pagamenti;
- report prodotti e servizi;
- distribuzione geografica delle vendite;
- analisi IVA;
- bilancino e forecast;
- concentrazione del fatturato sui clienti (regola 80/20) e tasso di abbandono (churn rate);
- dettagli dell’account collegato;
- consumi MCP giornalieri.
Alcuni campi possono essere minimizzati o oscurati dove previsto dal tool. Per l’elenco completo vedi Tool disponibili. Per il trattamento dei dati consulta la Privacy.
Posso chiedere grafici?
Sì. Il connettore restituisce dati strutturati; il client AI può usarli per creare tabelle, grafici a barre, linee o torta. La resa visiva dipende dal client: Claude renderizza nativamente artefatti grafici, mentre altri client possono produrre solo tabelle testuali o richiedere strumenti aggiuntivi.
Esempio:
Usa Fattura24 e mostrami il fatturato mensile 2026 con tabella e grafico a barre.
Può sostituire il commercialista?
No. Il connettore aiuta a consultare e sintetizzare dati presenti in Fattura24, ma le risposte dell’assistente devono essere considerate supporto operativo e analitico, non consulenza professionale.
Le elaborazioni AI non sostituiscono il parere di un commercialista, revisore o consulente fiscale abilitato. Verifica le conclusioni rilevanti — soprattutto su adempimenti fiscali, dichiarazioni IVA e decisioni con impatto contabile — con il tuo consulente di fiducia.
Cosa NON può fare il connettore
Quali operazioni sono escluse dalla versione attuale?
Per proteggere i dati e ridurre il rischio operativo, la versione attuale del connettore non espone tool per:
- creare, modificare o cancellare fatture e documenti;
- inviare documenti allo SDI o al Sistema Tessera Sanitaria;
- effettuare pagamenti, incassi, bonifici o qualsiasi operazione finanziaria dispositiva;
- modificare clienti, fornitori, prodotti, impostazioni fiscali o budget;
- accedere a dati che l’utente autenticato non può vedere in Fattura24.
Il connettore può aiutare a individuare documenti in determinati stati (es. fatture scartate dallo SDI, documenti da inviare al Sistema TS, fatture non pagate), ma non agisce su di essi.
L’unico tool non strettamente di lettura è segnala_limite_connettore, usato per inviare un ticket strutturato al team Fattura24 dopo conferma esplicita dell’utente. Per il dettaglio vedi Tool disponibili.
Fiducia e affidabilità
Posso fidarmi delle analisi che produce l’assistente?
Le analisi sono costruite sui tuoi dati reali: l’assistente non inventa numeri e non usa dati di altri utenti. Il fatturato che ti mostra è quello in Fattura24.
Quello su cui serve attenzione è l’interpretazione: quando l’assistente dice "il calo di aprile potrebbe essere legato a X", sta facendo un’inferenza sui dati disponibili, non una certezza. Le analisi quantitative (numeri, totali, confronti) sono verificabili direttamente. Le analisi qualitative (cause, ipotesi, raccomandazioni) vanno trattate come punto di partenza, non come conclusione definitiva.
Cosa succede se l’assistente sbaglia?
L’assistente può sbagliare in due modi:
Errori sui dati: restituisce un numero diverso da quello in Fattura24. In questo caso, chiedi all’assistente di mostrarti i dati grezzi su cui si basa — può elencare le righe del report con i valori originali — e verifica direttamente in Fattura24. Se il problema persiste, segnalalo.
Errori di interpretazione: l’analisi è basata su dati corretti ma la conclusione è fuorviante o incompleta. È il caso più comune e il più sottile. Per questo le analisi AI non sostituiscono il giudizio professionale: un commercialista, un controller o un revisore vedono contesto e sfumature che l’assistente non ha.
La regola pratica: usa le analisi per orientarti e costruire domande migliori, non per prendere decisioni rilevanti senza verifica.
Come faccio a verificare che i dati restituiti siano quelli giusti?
In due modi:
-
Chiedi i dati grezzi. Aggiungi al prompt “mostrami anche le righe di dettaglio” o “elenca i documenti su cui si basa questo totale”. L’assistente può restituire i dati strutturati del connettore, che puoi confrontare con quello che vedi in Fattura24.
-
Parti da una verifica semplice. Prima di usare il connettore per analisi importanti, chiedi qualcosa che sai già — ad esempio il fatturato di un mese specifico che conosci — e verifica che il numero corrisponda. Se torna, hai una conferma che il connettore legge correttamente i tuoi dati.
L’assistente può “inventare” dati che non ho in Fattura24?
No, per il funzionamento del connettore. Quando fai una domanda che richiede dati da Fattura24, l’assistente chiama il connettore e usa quello che riceve. Se il dato non c’è — perché non è in Fattura24 o perché non è esposto dai tool disponibili — il connettore non restituisce nulla e l’assistente dovrebbe dirtelo.
Quello che può succedere è che l’assistente risponda usando la sua conoscenza generale invece dei tuoi dati, se non gli viene chiesto esplicitamente di usare il connettore. Per evitarlo, usa sempre formule come “Usa Fattura24 e...” all’inizio del prompt, specialmente se hai più connettori attivi.
Posso chiedere all’assistente di spiegarmi come è arrivato a una conclusione?
Sì, è uno dei modi più efficaci per usare il connettore. Dopo che l’assistente ha prodotto un’analisi, puoi chiedere:
Mostrami i dati grezzi su cui si basa questa conclusione.
Cosa hai considerato e cosa non hai potuto considerare in questa analisi?
La trasparenza sul ragionamento è il modo migliore per decidere quanto fidarsi di una specifica risposta.
Compliance e responsabilità
Posso usare le analisi del connettore per adempimenti fiscali o decisioni contabili?
No, non direttamente. Le analisi prodotte dall’assistente sono strumenti di consultazione e orientamento, non documenti ufficiali e non sostituiscono la valutazione di un professionista abilitato.
Per la liquidazione IVA, le dichiarazioni fiscali, la redazione del bilancio o qualsiasi altro adempimento con valore legale o contabile, il riferimento resta il commercialista o il consulente fiscale. Il connettore può aiutarti ad arrivare a quell’incontro con domande più precise e un quadro più chiaro — non a fare a meno di quell’incontro.
Chi è responsabile se l’AI mi dà un’informazione sbagliata e io prendo una decisione errata?
La responsabilità delle decisioni operative e fiscali resta in capo all’utente e, dove applicabile, ai professionisti che lo assistono. L’assistente AI è uno strumento di supporto, non un consulente con responsabilità professionale.
Fattura24 mette a disposizione i dati del tuo account tramite il connettore. L’elaborazione, l’interpretazione e le conclusioni che l’assistente produce sono gestite interamente dal client AI che usi e dalla società che lo gestisce, secondo i termini del contratto che hai accettato con quel servizio.
Per questo il connettore è pensato per supportare decisioni, non per prenderle in autonomia. Verifica sempre le conclusioni rilevanti prima di agire su di esse.
Sono un commercialista e uso Fattura24 per conto dei miei clienti. Posso usare il connettore?
Il connettore si collega all’account Fattura24 dell’utente autenticato. Se hai accesso a Fattura24 con le credenziali di un cliente (o con credenziali delegate), il connettore vedrà i dati di quell’account.
Prima di usare il connettore per dati di terzi, verifica con il cliente che abbia compreso e accettato le implicazioni privacy — in particolare che i dati passeranno attraverso il client AI che usi. Consulta la Privacy del connettore per il dettaglio completo.
Limiti e consumi
Cosa succede se raggiungo il limite giornaliero?
Se il tuo account ha un limite giornaliero di chiamate MCP e lo raggiungi, il connettore restituisce un messaggio di limite superato. Il limite si azzera automaticamente a mezzanotte.
Per controllare i consumi puoi chiedere:
Usa Fattura24 e mostrami i consumi MCP di oggi.
Perché il connettore mi chiede di essere più specifico?
Alcune richieste richiedono parametri essenziali: anno, tipo di documento, pagina, numero di righe o area di analisi. Senza questi parametri il connettore non sa cosa restituire.
Esempio poco chiaro:
Mostrami le fatture.
Esempio migliore:
Usa Fattura24 e mostrami le fatture di vendita non pagate del 2026.
Per altri esempi pronti vedi Esempi e casi d’uso.
Privacy e sicurezza
I miei dati vengono usati per addestrare modelli AI?
Fattura24 non ha accordi attivi con i provider di client AI per la condivisione dei tuoi dati ai fini di addestramento di modelli.
Il trattamento concreto dei contenuti scambiati durante una conversazione dipende dalle policy del client AI che usi (Claude, ChatGPT, Gemini, Cursor o altri): ogni client ha le proprie regole su retention, uso per training e privacy. Verifica sempre le impostazioni del tuo client AI e consulta la sua informativa privacy.
Per i dettagli sul trattamento lato Fattura24, consulta la Privacy del connettore MCP.
Dove trovo la Privacy del connettore?
Il documento di Privacy del connettore MCP Fattura24 è disponibile alla pagina Privacy.
Problemi e supporto
Perché vedo “connettore non attivo”?
Il connettore può essere stato disattivato in Fattura24 o non essere disponibile per l’account collegato.
Verifica in Fattura24, nella sezione App e Servizi Esterni, oppure contatta l ’assistenza.
Cosa devo fare se la connessione fallisce?
Controlla:
- URL esatto del connettore (
https://www.app.fattura24.com/mcp, senza parametri aggiuntivi); - login Fattura24;
- OTP o secondo fattore, se attivo;
- connettore attivo in Fattura24;
- eventuali blocchi del browser su popup e redirect.
Se il client AI mostra un reference ID, ad esempio un valore che inizia con ofid_, copialo e invialo all’assistenza insieme a data, ora e descrizione del problema.
Perché una domanda non viene completata?
Ci sono tre casi comuni:
- i dati non sono presenti in Fattura24;
- l’utente collegato non ha permessi sufficienti;
- il connettore non espone ancora il tool necessario.
Se il limite dipende dal connettore e non da dati mancanti o richiesta ambigua, l’assistente può chiederti conferma per inviare una segnalazione strutturata al team Fattura24.
Quali informazioni servono per una segnalazione all’assistenza?
Indica:
- account Fattura24;
- client AI usato;
- data e ora del problema;
- prompt utilizzato;
- messaggio di errore;
- eventuale reference ID del client AI;
- se il problema si verifica sempre o solo con una richiesta specifica.
Non includere mai password, token, API key o codici OTP nelle segnalazioni di assistenza. Non sono mai richiesti per la risoluzione di un problema tecnico.