Collegare FatturaSmart a Claude

Incluso in tutti i piani a pagamento: il connettore è compreso nei piani Standard, Pro e Max, anche durante la prova gratuita. Non è disponibile nel piano gratuito.

Con il connettore MCP di FatturaSmart chiedi a Claude delle tue fatture emesse e ricevute, dei preventivi e degli altri documenti commerciali, dei clienti e dei prodotti, delle scadenze e del fatturato, e gli fai preparare bozze di fatture, preventivi, proforma e altri documenti commerciali che controlli e invii tu. In questa guida aggiungi il connettore a Claude (sito, app desktop o Claude Code), autorizzi l’accesso e vedi come revocarlo.

Aggiungere il connettore su claude.ai o nell’app desktop

Le voci di Claude sono riportate come compaiono nella sua interfaccia in inglese.

Passo 1: Apri i connettori

In Claude apri Customize e poi Connectors.

Passo 2: Aggiungi un connettore personalizzato

Clicca + Add e poi Add custom connector. Come nome scrivi FatturaSmart e come indirizzo del server:

https://mcp.fatturasmart.com/mcp

Poi clicca Continue.

L’indirizzo lo trovi anche in FatturaSmart, in Profilo › Connessioni AI, nel riquadro URL del connettore: clicca Copia e incollalo in Claude.

Passo 3: Conferma le impostazioni di accesso

Claude rileva da solo come collegarsi a FatturaSmart: lascia le impostazioni che propone. Se ti chiede di sceglierle, per Authentication va bene Sign in now e per OAuth client Use Claude’s published identity (Recommended). Non servono Request headers. Clicca Add.

Passo 4: Autorizza l’accesso su FatturaSmart

Si apre la pagina di consenso di FatturaSmart (se non hai già fatto l’accesso, accedi prima a FatturaSmart). Controlla che:

• l’app che chiede l’accesso sia Claude, con il badge App verificata;
• nella sezione Aziende a cui potrà accedere siano selezionate solo le aziende che vuoi condividere;
• nella sezione Cosa potrà fare l’opzione Creare bozze di documenti sia attiva solo se vuoi che Claude possa preparare bozze di fatture, preventivi, proforma e altri documenti commerciali. Si può attivare solo se sei titolare di tutte le aziende selezionate: altrimenti la pagina mostra la nota Solo il titolare dell’attività può consentire la creazione di bozze e il collegamento è in sola lettura.

Prima di consentire l’accesso leggi le Condizioni del Connettore AI e l’Allegato B all’Accordo sul trattamento dei dati, poi spunta la casella Ho letto e accetto le Condizioni del Connettore AI e l’Allegato B all’Accordo sul trattamento dei dati. Il pulsante Consenti accesso si attiva solo quando l’hai spuntata.

Clicca Consenti accesso: la pagina mostra «Ti stiamo riportando su claude.ai…» e torni su Claude con FatturaSmart collegato.

Usare FatturaSmart in una conversazione

In una chat clicca il pulsante +, scegli Connectors e attiva FatturaSmart. Poi chiedi in italiano, per esempio:

• “Cosa devo incassare e pagare nei prossimi 30 giorni, scadenze fiscali comprese?”
• “Com’è andato il fatturato di quest’anno rispetto al 2025, mese per mese? Chi sono i miei 5 clienti principali?”
• “Quanto ho fatturato a Studio Bianchi quest’anno?”
• “Quali fatture emesse sono scadute e non ancora pagate?”
• “Mostrami le fatture ricevute da Rossi Forniture negli ultimi sei mesi.”
• “Prepara una bozza per Studio Bianchi: consulenza di ottobre, 10 ore a 60 € l’ora.”
• “Prepara una fattura per Rossi Srl con 2 ‘Consulenza base’ dal catalogo.”
• “Prepara un preventivo per Studio Bianchi: 3 giornate di formazione a 450 € l’una, valido 30 giorni.”
• “Quali preventivi di settembre non sono ancora stati accettati?”

Prima di usare uno strumento Claude può chiederti l’approvazione: approva solo se corrisponde a quello che hai chiesto. Quando crea una bozza di fattura, Claude riceve da FatturaSmart il link per aprirla: aprila, controllala e inviala tu dall’app. Le bozze di preventivi e degli altri documenti commerciali le trovi in Altri Documenti, con lo stato Bozza.

Puoi anche chiedere l’anteprima PDF di un documento, per esempio «Mostrami l’anteprima PDF della bozza appena creata»: su claude.ai e nell’app desktop compare direttamente nella chat, con un link al PDF valido 10 minuti; in Claude Code ricevi solo il link. Claude legge le numerazioni dei documenti ma non può modificarle: le cambi tu in Profilo › Numerazione.

Il connettore non prepara documenti per la Pubblica Amministrazione: se il codice destinatario del cliente ha 6 caratteri, come il codice ufficio di un ente pubblico, non crea bozze, né di fattura né di preventivi o altri documenti commerciali. Quelle fatture si preparano dall’app. Per una bozza di fattura il cliente deve avere l’indirizzo completo (via, città, CAP e nazione): se manca qualcosa, la bozza non viene creata e completi prima il cliente in FatturaSmart.

Scadenze, totali e riepiloghi sono calcolati da FatturaSmart sui dati della tua attività e corrispondono a quello che vedi nell’app. Il connettore non calcola le imposte: le scadenze fiscali sono quelle che trovi nello Scadenzario.

Usare FatturaSmart in Claude Code

Da terminale aggiungi il connettore con:

claude mcp add --transport http fatturasmart https://mcp.fatturasmart.com/mcp

Per averlo in tutti i tuoi progetti, aggiungilo invece con:

claude mcp add --scope user --transport http fatturasmart https://mcp.fatturasmart.com/mcp

Poi, dentro Claude Code, esegui il comando /mcp e segui i passaggi nel browser per accedere a FatturaSmart e consentire l’accesso. Poiché Claude Code gira sul tuo computer, la pagina di consenso mostra l’avviso Questa app gira sul tuo computer: consenti l’accesso solo se hai appena avviato tu il collegamento.

Attività che usano il Sistema TS

Se colleghi un’attività che usa il Sistema Tessera Sanitaria, la pagina di consenso mostra la nota Dati dei pazienti protetti: Claude vede importi, date e numeri dei documenti sanitari, ma non chi è il paziente né cosa descrivono, e i clienti senza partita IVA non compaiono nelle ricerche. Lo stesso vale per i preventivi e gli altri documenti commerciali intestati a clienti senza partita IVA: Claude non vede chi è il cliente né cosa descrivono. Nelle scadenze e nei riepiloghi di fatturato e costi i clienti e i fornitori senza partita IVA non sono identificati. I dati inviati al Sistema TS, come la tipologia di spesa, non arrivano mai all’assistente.

I dati dei pazienti sono protetti per impostazione predefinita. L’opzione per includerli sarà disponibile in seguito, riservata al titolare e solo dopo che avrà confermato i requisiti; fino ad allora restano protetti in ogni collegamento. I documenti per cui il paziente ha esercitato l’opposizione restano sempre riservati, per scelta di FatturaSmart.

Collegare più aziende

Se in FatturaSmart segui più aziende, per esempio come commercialista, nella pagina di consenso puoi selezionarne più di una con un solo collegamento. Le aziende senza un piano a pagamento compaiono disattivate con la dicitura Incluso nei piani a pagamento. Quando sono collegate più aziende, ogni richiesta riguarda un’azienda precisa: se non è chiaro quale, Claude è istruito a chiedertelo.

Se colleghi aziende di cui non sei titolare, il collegamento è in sola lettura e il titolare di ciascuna riceve un’email con l’app collegata, chi l’ha collegata e i permessi, e può revocarlo da Profilo › Connessioni AI. Prima di collegare le aziende dei tuoi clienti, assicurati di avere la loro autorizzazione e di averli informati dell’uso di strumenti di intelligenza artificiale.

Account Claude gestiti da un’organizzazione

Se usi Claude con un account gestito dalla tua organizzazione, il connettore lo aggiunge un amministratore (Owner) da Organization settings › Connectors: Add, poi Custom e, se richiesto, Web. Dopo, ognuno lo trova in Customize › Connectors con l’etichetta Custom, clicca Connect e accede con il proprio account FatturaSmart.

Revocare l’accesso

Da FatturaSmart

1. Nell’azienda di cui vuoi togliere l’accesso apri Profilo › Connessioni AI: trovi ogni collegamento con app, utente, permessi, aziende, data di collegamento, ultimo utilizzo e richieste degli ultimi 30 giorni.
2. Nella colonna Azioni clicca il pulsante rosso Revoca accesso (l’icona della spina) sul collegamento di Claude e conferma con Revoca accesso.

Da quel momento Claude non legge più i dati di quell’azienda. Se il collegamento comprende altre aziende, resta attivo per quelle finché non lo revochi anche su ciascuna, o finché non scade dopo 30 giorni senza utilizzo; se riguardava solo quell’azienda, viene chiuso del tutto. Per usarlo di nuovo, ricollega il connettore.

Da Claude

Per togliere il connettore anche da Claude apri Customize › Connectors, seleziona FatturaSmart e clicca Remove. In Claude Code usa questo comando, che cancella anche l’accesso salvato da Claude Code:

claude mcp remove fatturasmart

Prossimi Passi

• Collegare FatturaSmart a ChatGPT – lo stesso collegamento in ChatGPT
• Il connettore per Claude e ChatGPT – cosa puoi chiedere e come sono protetti i tuoi dati
• Trasformare e convertire un documento – convertire in fattura, dall’app, un preventivo preparato con l’assistente
• Aggiungere un Commercialista – dare accesso al tuo commercialista

Hai bisogno di aiuto?

Contattaci su WhatsApp cliccando l’icona in basso a destra, oppure scrivi a supporto@fatturasmart.com.