Passa al contenuto principale

Introduzione ai casi d'uso

Questa sezione raccoglie esempi pratici per usare il connettore MCP di Fattura24.
Gli esempi sono organizzati in tre famiglie, pensate per momenti d'uso diversi.

Da dove iniziare

Se è la prima volta che usi il connettore, leggi prima questa pagina per capire come scrivere prompt efficaci, poi passa agli Esempi rapidi per fare pratica con prompt singoli.

Le tre famiglie di esempi​

  • Esempi rapidi — Prompt atomici, pronti da copiare, per ottenere un dato o un'analisi specifica. Ideali per uso quotidiano.
  • Scenari avanzati — Workflow strutturati per occasioni specifiche: chiusura mese, riunione col commercialista, consiglio aziendale, incontro con la banca.
  • Automazioni conversazionali — Pattern di follow-up nella stessa chat e shortcut riutilizzabili da salvare per le richieste ricorrenti.

Come scrivere prompt efficaci​

Un buon prompt comunica chiaramente cosa vuoi sapere, per quale periodo e in che formato. Più sei specifico, più la risposta sarà utile.

Anatomia di un prompt efficace​

Un prompt completo contiene almeno tre informazioni:

  1. L'oggetto della richiesta — fatturato, incassi, clienti, IVA, bilancino…
  2. Il periodo di riferimento — 2026, mese scorso, primo trimestre 2026, ultimi 12 mesi
  3. Il formato o l'angolazione — tabella, sintesi esecutiva, top 10, confronto anno su anno

Esempio di prompt minimo vs prompt efficace​

❌ Prompt troppo generico
Mostrami le fatture non pagate.
✅ Prompt efficace
Mostrami le fatture di vendita non pagate del 2026,
ordinate per importo residuo decrescente,
con il totale ancora da incassare in fondo alla tabella.

Suggerimenti pratici​

  • Indica sempre il periodo. Senza periodo, la risposta può essere ambigua o riferita al periodo sbagliato.
  • Specifica vendite o acquisti. Se chiedi "incassi", chiarisci se ti interessano clienti o fornitori.
  • Chiedi un formato. Tabella, elenco ordinato, sintesi in N righe, grafico testuale: il formato cambia la leggibilità.
  • Dichiara il contesto d'uso. "Per una riunione interna", "per il commercialista", "per il CdA": la risposta si adatta al pubblico.
Il pattern "Usa Fattura24 e..."

Negli esempi vedrai spesso prompt che iniziano con Usa Fattura24 e.... Non è obbligatorio: serve a indicare esplicitamente all'assistente di usare il connettore quando hai più connettori attivi o quando vuoi essere certo che la risposta arrivi dai tuoi dati gestionali e non da conoscenze generiche.

Dati vs Analisi: una distinzione importante​

Il connettore può rispondere a due tipi di richieste molto diverse. Capire la differenza ti aiuta a impostare aspettative corrette.

Dati: cosa è successo​

Sono richieste descrittive: chiedi un numero, una lista, un confronto. La risposta è oggettiva e verificabile.

Esempio di richiesta di dati
Usa Fattura24 e mostrami il fatturato mensile del 2026 in tabella.

L'assistente restituisce i numeri così come sono, senza interpretazioni.

Analisi: cosa significa e cosa fare​

Sono richieste interpretative: chiedi una valutazione, una sintesi, suggerimenti operativi. La risposta include considerazioni dell'assistente sui dati.

Esempio di richiesta di analisi
Usa Fattura24 e analizza l'andamento del fatturato 2026 vs 2025.
Evidenzia i mesi con scostamento più rilevante,
ipotizza possibili cause e suggerisci dove approfondire.

L'assistente restituisce i numeri più una lettura ragionata.

Le analisi sono indicazioni, non verità assolute

L'assistente lavora sui dati che il connettore espone. Le interpretazioni sono utili come punto di partenza, ma vanno sempre validate dal titolare, dal controller o dal commercialista prima di prendere decisioni operative.

Quando chiedere cosa​

Vuoi…Tipo di richiestaEsempio
Un numero precisoDati"Totale fatturato marzo 2026"
Una lista filtrataDati"Fatture non pagate del 2026 sopra i 1.000 €"
Un confronto numericoDati"Vendite 2026 vs 2025 mese per mese"
Capire un andamentoAnalisi"Perché aprile è andato peggio di marzo?"
Decidere un'azioneAnalisi"Su quali clienti concentrare il follow-up?"
Un report leggibileAnalisi"Sintesi esecutiva del trimestre per il titolare"

Primo avvio: verifica che il connettore sia attivo​

Prima di lanciarti negli esempi più complessi, usa questi tre prompt per verificare che tutto funzioni.

Usa Fattura24 e dimmi quali informazioni puoi consultare per il mio account.
Usa Fattura24 e mostrami i consumi MCP di oggi.
Usa Fattura24 e dimmi quale account risulta collegato.
Se qualcosa non funziona

Se l'assistente risponde che il connettore non è attivo o che non trova l'account, controlla la configurazione del connettore nelle impostazioni del tuo client MCP e verifica di essere autenticato su Fattura24.

Cosa il connettore non fa (oggi)​

Il connettore MCP Fattura24 è uno strumento di lettura e analisi. Non crea, non modifica, non invia.

In particolare, il connettore attuale:

  • non crea né modifica fatture o altri documenti;
  • non invia documenti allo SDI;
  • non invia solleciti o email ai clienti;
  • non registra pagamenti né effettua incassi;
  • non modifica anagrafiche di clienti, fornitori o prodotti.
Hai bisogno di un'azione che il connettore non espone?

Vedi la sezione Quando il connettore non basta nelle Automazioni conversazionali: puoi chiedere all'assistente di inviare una segnalazione strutturata al team Fattura24.

Prossimi passi​

Scegli da dove cominciare: