Automatizza la Tua Attività: Frihet + Claude + n8n

Il lavoratore autonomo medio dedica 5-8 ore al mese a compiti amministrativi che un computer potrebbe svolgere in pochi secondi: inviare solleciti di pagamento, classificare le spese, generare report, creare fatture ricorrenti. Non è che questi compiti siano difficili. È che non dovrebbero richiedere la tua attenzione.

Questo tutorial ti insegna a collegare tre strumenti — Frihet, Claude Code e n8n — per automatizzare le parti della tua attività che non necessitano di un umano. Senza programmare, senza consulenti, senza pagare extra.

I tre pezzi del puzzle

Frihet è il tuo ERP. Dove vivono le tue fatture, clienti, spese e dati finanziari. Ciò che lo rende diverso è che ha:

• API REST aperta con documentazione completa
• 14 eventi webhook che attivano azioni automatiche
• Server MCP che permette alle AI di interagire con il tuo account

n8n è il tuo automatizzatore. Uno strumento visuale che collega applicazioni e crea flussi di lavoro. Se X accade, allora fai Y. Senza codice. Può essere installato sul tuo server o utilizzare il suo cloud.

Claude Code è il tuo assistente AI. Con il server MCP di Frihet, Claude può consultare la tua fatturazione, creare documenti e analizzare le tue finanze direttamente dal terminale.

Automazione 1: Solleciti di pagamento automatici

L’automazione più redditizia. Ogni fattura non pagata che rimane senza sollecito è denaro che tarda ad arrivare — o che non arriva affatto.

Come funziona

1. Frihet invia un webhook quando una fattura passa allo stato “scaduta”
2. n8n riceve il webhook e attende 3 giorni (periodo di grazia)
3. Se la fattura rimane non pagata, n8n invia un’email al cliente con i dati della fattura
4. Se dopo altri 7 giorni rimane non pagata, n8n invia un secondo sollecito con un tono più deciso
5. Se dopo 15 giorni rimane non pagata, n8n ti avvisa tramite Telegram o email

Configurazione in n8n

Il flusso ha 5 nodi:

Nodo 1 — Webhook Trigger: Riceve l’evento invoice.overdue da Frihet. Il payload include l’ID della fattura, cliente, importo e data di scadenza.

Nodo 2 — Wait (3 giorni): Mette in pausa il flusso per 3 giorni naturali.

Nodo 3 — Richiesta HTTP (verifica stato): Chiama l’API di Frihet per verificare se la fattura è ancora non pagata. Se è già stata incassata, il flusso si ferma.

Nodo 4 — Invio Email: Invia un’email al cliente con oggetto “Sollecito: Fattura [numero] in sospeso” e include il link di pagamento.

Nodo 5 — If/Else → Secondo sollecito o notifica: Se dopo altri 7 giorni rimane non pagata, invia una seconda email. Se dopo 15 giorni persiste, ti notifica.

Automazione 2: Riepilogo finanziario settimanale

Ogni lunedì alle 9

Come funziona

1. n8n esegue il flusso ogni lunedì alle 9
   (trigger programmato)
2. Chiama l’API di Frihet per ottenere: fatture emesse quella settimana, incassi ricevuti, spese registrate, fatture in sospeso
3. Calcola i KPI: fatturazione settimanale, incassato vs in sospeso, spese vs entrate
4. Formatta il messaggio e lo invia via email o Telegram

Dati che puoi includere

• Fatture emesse questa settimana (Numero e totale)
• Incassi ricevuti questa settimana
• Totale in sospeso
• Spese registrate questa settimana
• Saldo netto (incassato - spese)
• Fatture in scadenza questa settimana (urgenti)

Questo flusso utilizza solo endpoint GET dell’API di Frihet. Non modifica nulla, legge solo i dati e li presenta in modo utile.

Automazione 3: Fattura automatica da Stripe

Se vendi online e incassi con Stripe, puoi generare la fattura in Frihet automaticamente quando ricevi un pagamento.

Come funziona

1. Stripe invia un webhook a n8n quando un pagamento viene completato (payment_intent.succeeded)
2. n8n estrae i dati del pagamento: cliente, importo, causale, valuta
3. n8n cerca il cliente in Frihet tramite email. Se non esiste, lo crea
4. n8n genera la fattura in Frihet con i dati del pagamento
5. Frihet invia automaticamente la fattura al cliente via email

Il risultato

Il tuo cliente paga sul tuo sito web → riceve la fattura nella sua email in meno di un minuto → la fattura viene registrata nel tuo ERP con tutti i dati fiscali corretti. Senza che tu debba fare nulla.

Questa automazione è particolarmente utile per:

• Negozi online (Shopify, WooCommerce con Stripe)
• SaaS con abbonamenti ricorrenti
• Corsi e prodotti digitali
• Servizi con pagamento online

Claude Code + MCP: il tuo gestore AI

Il server MCP di Frihet permette a Claude Code di interagire direttamente con il tuo account. Non è un’API generica: è un protocollo progettato affinché le AI comprendano e operino il tuo ERP.

Cosa può fare Claude con l’MCP di Frihet

• Consultare la tua fatturazione del mese corrente
• Elencare le fatture in sospeso
• Creare un preventivo per un cliente
• Cercare un cliente per nome o NIF
• Leggere le metriche del dashboard finanziario
• Generare una fattura a partire da una descrizione in linguaggio naturale

Esempio reale

Apri Claude Code e scrivi:

"Crea una factura para Empresa ABC por 3 horas de consultoría a 80 EUR la hora, con 21% de IVA"

Claude usa l’MCP di Frihet per:

1. Cercare il cliente “Azienda ABC” nel tuo database
2. Creare la fattura con 3 righe da 80 EUR + 21% IVA
3. Calcolare il totale (290,40 EUR)
4. Confermare i dati prima di emetterla

Non copi dati. Non apri l’ERP. Non calcoli l’IVA. Dici ciò di cui hai bisogno e la fattura viene generata.

Come installare l’MCP

Il server MCP di Frihet è pubblicato su npm:

npx @frihet/mcp-server

Si configura con la tua API key di Frihet e diventa disponibile automaticamente per Claude Code. La documentazione completa è su docs.frihet.io/mcp.

Automazione 4: Classificazione automatica delle spese

Quando registri una spesa in Frihet (tramite OCR o manualmente), puoi automatizzare la sua categorizzazione:

1. Frihet invia un webhook quando viene creata una nuova spesa
2. n8n riceve la spesa con i dati dell’OCR (fornitore, importo, concetto)
3. n8n applica regole: se il fornitore è un distributore di benzina → categoria “trasporto”; se è un ristorante → “pasti”; se è Amazon → “materiale per ufficio”
4. n8n aggiorna la categoria della spesa in Frihet via API

Le regole sono tue. Puoi renderle semplici (per fornitore) o complesse (per importo + fornitore + giorno della settimana) come preferisci.

Perché questo funziona solo con Frihet

L’automazione richiede tre cose che la maggior parte degli ERP spagnoli non offrono:

API aperta in tutti i piani. Anfix addebita 80 EUR/mese per l’API. Quipu la limita al piano Solution (25 EUR/mese). Holded la limita ai piani superiori. Frihet la include nel piano gratuito.

Webhook reali. 14 eventi che si attivano in tempo reale: fattura creata, fattura pagata, fattura scaduta, spesa registrata, cliente creato, preventivo accettato, e altro ancora. Senza webhook, ogni automazione richiede polling (chiedere costantemente se qualcosa è cambiato), il che è inefficiente e lento.

Server MCP. Nessun altro ERP spagnolo ha l’MCP. Questo significa che Frihet è l’unico che può interagire nativamente con assistenti AI come Claude. Non è un plugin o un hack: è un protocollo standard progettato da Anthropic affinché le AI e gli strumenti parlino la stessa lingua.

Inizia con un’automazione

Non devi configurare tutto in una volta. Scegli l’automazione che ti fa risparmiare più tempo — per la maggior parte dei lavoratori autonomi sono i solleciti di pagamento — e configurala questa settimana.

Una volta che funziona, aggiungi la successiva. E la successiva. In un mese, la tua attività amministrativa sarà gestita all’80% in autonomia. E tu dedicherai quelle 5-8 ore mensili a ciò che genera realmente entrate.