Passa al contenuto principale

Configurazione

Questa pagina spiega come collegare il connettore MCP Fattura24 a un client AI compatibile con Remote MCP, come Claude o ChatGPT.

Prerequisiti​

Prima di iniziare verifica di avere:

  • un piano di abbonamento attivo su Fattura24;
  • il connettore MCP abilitato in Fattura24, se previsto dal tuo piano o dalla configurazione dell’account;
  • accesso al client AI su cui vuoi usare il connettore;
  • un browser per completare il login OAuth;
  • eventuale OTP o metodo di autenticazione a due fattori, se attivo sul tuo account Fattura24.
Cosa serve sul client AI

Oltre al piano Fattura24, ti serve un tuo accesso a un client AI compatibile (es. Claude o ChatGPT). Le condizioni di accesso dei singoli client — disponibilità su piani gratuiti o a pagamento, modalità sviluppatore, limiti giornalieri — variano da provider a provider e cambiano nel tempo: verifica le condizioni correnti sul sito del client AI che usi.

Non inserire credenziali nell’URL

L’autenticazione avviene esclusivamente tramite OAuth 2.0. Non inserire mai password, token o API key nell’URL del connettore o nei campi di configurazione del client AI.

URL del connettore​

Usa questo URL per aggiungere manualmente il connettore:

https://www.app.fattura24.com/mcp

È un Remote MCP server raggiungibile via HTTPS.

Perimetro dei dati visibili​

L’assistente vede quello che vedi tu in Fattura24

Il connettore espone all’assistente AI gli stessi dati che l’utente autenticato può vedere in Fattura24.

Installazione nel client​

Il connettore Fattura24 è un Remote MCP server con autenticazione OAuth. Scegli il client che vuoi usare e completa il collegamento con l’URL di produzione.

La seguente procedure è valida sia da browser (desktop, tablet e mobile) che app desktop.

informazioni

Per attivare il connettore di Fattura24 su Claude devi avere, alla data odierna del 24/06/2026, un abbonamento attivo o far parte di un “Team” aziendale.

  1. Apri Claude.
  2. Accedi al tuo account.
  3. Vai in Personalizza > Connetti le tua app, cerca Fattura24 > Collega.
  4. Accedi al tuo account in Fattura24.

Oppure vai su Account > Impostazioni > Connettori> Personalizza > Connetti le tua app, cerca Fattura24 > Collega.

La seguente procedure è valida da app mobile.

  1. Apri Claude.
  2. Vai in Impostazioni > Connettori > +, cerca Fattura24.
  3. Accedi al tuo acount di Fattura24.

Per verificare che la connessione sia attiva, apri una nuova chat e prova:

Usa Fattura24 e dimmi quali tool sono disponibili.

Configurazione Privacy​

Prima di usare il connettore, verifica le impostazioni privacy del tuo Assistente AI per assicurarti che le conversazioni — che conterranno dati del tuo account Fattura24 — non vengano usate per addestrare i modelli AI.

Anthropic consente di disattivare l’uso delle conversazioni per il training dei modelli. L’impostazione si gestisce dal sito web di Claude:

  1. Vai su claude.ai dal browser.
  2. Clicca sull’icona del tuo profilo in alto a destra.
  3. Vai in Impostazioni → Privacy.
  4. Disattiva l’opzione "Migliora Claude" (Help improve Claude), se disponibile.
Dipende dal piano

Gli utenti con piano a pagamento (Pro, Team, Enterprise) possono disabilitare questa opzione o ne sono già esentati per impostazione predefinita. Gli utenti con piano gratuito potrebbero avere opzioni limitate.

Primo test consigliato​

Dopo aver completato il collegamento e l’autenticazione OAuth, inizia da richieste semplici e a basso costo per verificare che tutto funzioni:

Usa Fattura24 e dimmi il nome dell’account collegato.
Usa Fattura24 e mostrami il fatturato mensile del 2026.
Usa Fattura24 e cerca le fatture di vendita non pagate del 2026.
Specifica sempre il periodo

Quando interroghi report e documenti, indica sempre il periodo di riferimento: anno, mese, trimestre o intervallo. Senza un periodo definito, l’assistente potrebbe restituire risultati troppo ampi o non pertinenti.
Per altri esempi pronti vedi la pagina Esempi e casi d’uso.

Disconnessione​

Il connettore può essere disattivato in due modi diversi, con effetti diversi:

La seguente procedure è valida sia da browser (desktop, tablet e mobile) che app desktop.

  1. Apri Claude.
  2. Vai in Personalizza > Connettori > Fattura24 > Disconnetti.

Oppure apri Claude e vai in Menu > Personalizza > Connettile tue app, cerca Fattura24 > Disconneti.

La seguente procedure è valida da app mobile.

  1. Apri l’app Claude.
  2. Vai in Menu > Impostazioni > Connettori> Fattura24 e, tenendo premuto, Dsconnetti.

Revoca dell’accesso da Fattura24 — blocca l’uso del connettore da qualsiasi client:

  1. accedi a Fattura24;
  2. vai in App e Servizi Esterni;
  3. disattiva l’app/connettore MCP.
Disconnessione vs revoca: qual è la differenza?

La disconnessione dal client AI ferma le chiamate solo da quel client; se hai autorizzato il connettore anche su altri client, quelli continueranno a funzionare. La revoca da Fattura24 invece blocca tutto, indipendentemente da quanti client hai autorizzato. Usa la revoca quando vuoi essere certo che nessun client AI possa più accedere ai tuoi dati.

Problemi comuni​

Il connettore non si collega​

Verifica:

  • che l’URL sia esattamente https://www.app.fattura24.com/mcp;
  • che non ci siano token o parametri aggiunti all’URL;
  • che il dominio sia raggiungibile da internet;
  • che l’account Fattura24 sia attivo;
  • che il connettore MCP sia abilitato in Fattura24.

Il login non va a buon fine​

Verifica:

  • credenziali Fattura24;
  • OTP o secondo fattore, se attivo;
  • eventuale blocco del browser su popup o redirect;
  • permessi dell’utente Fattura24.

Il client mostra un errore di connessione​

Se il client mostra un reference ID, ad esempio un identificativo che inizia con ofid_, conservalo e invialo all’assistenza insieme a:

  • data e ora del tentativo;
  • URL usato per il connettore;
  • account Fattura24 interessato;
  • descrizione del punto in cui il flusso si interrompe.

Riferimenti utili​