Come collegare Claude (API / Claude Code / MCP) a Danea EasyFatt
Collegare Claude (Anthropic) a Danea EasyFatt™ non significa trovare un pulsante ufficiale nel gestionale. Significa progettare un ponte controllato: EasyFatt resta la fonte di verità; Claude (via Messages API, Claude Code o un server MCP) lavora su estratti e tool autorizzati. Oggi molte PMI vivono ancora di export Excel, copia-incolla nel browser e chat ad-hoc — comodo per una prova, fragile come processo.
In questa guida vedi perché quel caos non scala, come distinguere API / Claude Code / MCP, un’architettura tipica middleware, privacy realistiche e il ruolo di CloudRemote™ con le integrazioni custom Topsell. Per l’uso di Claude in chat (prove e brief) vedi come usare Claude con EasyFatt; per il quadro su AI e dati gestionali parti da cosa può fare l’AI con i dati di EasyFatt.
- Non esiste un connettore Claude “già dentro” EasyFatt: serve middleware o integrazione custom (API / MCP).
- Export XLS + copia-incolla in chat = errori, dati non aggiornati, audit difficile e privacy rischiosa.
- Messages API = pipeline ripetibile; Claude Code = sviluppo agentico; MCP = tool standard agent↔sistemi.
- Pipeline sana: export ridotto → regole → Claude → log → revisione umana → destinazione.
- CloudRemote mette EasyFatt in cloud; le integrazioni trasformano le prove in un ponte automatico.
Perché il copia-incolla in chat non scala su EasyFatt?
La situazione tipica in molte PMI è questa: esporti un foglio da EasyFatt, apri Claude nel browser, incolli righe o alleghi un XLS, chiedi un riassunto o una classificazione, poi riporti a mano un pezzo di risposta in un ticket, in una mail o — peggio — in un campo note del gestionale. Funziona una volta. Alla terza settimana diventa caos.
Cosa va storto, in concreto:
- Dati non aggiornati — l’export di ieri non è il magazzino di oggi; l’agente ragiona su uno snapshot obsoleto.
- Errori di processo — colonne sbagliate, filtri dimenticati, prompt diversi per persona; nessuno sa quale versione del foglio “conta”.
- Privacy debole — finisci per caricare anagrafiche, note commerciali o pezzi fiscali “perché è più comodo”, senza minimizzazione né log.
- Zero ripetibilità — non c’è job notturno, non c’è approvazione strutturata, non c’è audit di cosa è uscito dal gestionale.
La chat resta utile per validare un caso d’uso. Quando lo stesso flusso torna ogni settimana, serve un sistema integrato: API, MCP o middleware che colleghi l’agente al gestionale in modo automatico e controllato — non un altro copia-incolla.
Tre modi di collegare Claude: API, Claude Code e MCP
Sono tre porte diverse sullo stesso ecosistema Anthropic. Confonderle genera aspettative sbagliate (“ho Claude.ai, quindi EasyFatt è già collegato”).
| Approccio | Quando usarlo | Cosa serve tipicamente |
|---|---|---|
| Claude.ai (chat) | Prove, brief, sintesi spot su export ridotti | Account Claude; disciplina sull’export; revisione umana |
| Messages API | Pipeline ricorrenti, batch, classificazione, output JSON | Chiavi API, middleware, log, ambienti test/prod |
| Claude Code | Sviluppare e testare connettori, script, agent in IDE | Ambiente di sviluppo; repo; policy su dati di prova |
| MCP (Model Context Protocol) | Esporre tool/resource standard a Claude Desktop, Claude Code o altri client MCP | Server MCP custom (o middleware) verso EasyFatt / export / DB operativi |
MCP è uno standard aperto per collegare assistenti AI a strumenti e fonti dati (specifica e overview: modelcontextprotocol.io; documentazione connector Claude: Claude MCP). Non è un prodotto Danea: è un protocollo. Per EasyFatt significa: tu (o un partner) esponi tool sicuri — “leggi listino filtrato”, “cerca cliente per codice”, “accoda bozza nota” — e Claude li usa solo nei limiti che hai definito.
In italiano trovi già esempi MCP su altri gestionali cloud (es. Fatture in Cloud). Su EasyFatt il pezzo mancante non è “il modello”, è il contratto dati e il server/middleware che parla con il tuo ambiente. Lo stesso schema di maturità vale anche per altre API AI: vedi come collegare OpenAI API a EasyFatt.
Architettura tipica: EasyFatt → middleware → Claude
Il pattern più frequente non è “EasyFatt chiama Claude da solo”, ma un middleware (servizio, script, iPaaS o integrazione custom) — eventualmente esposto come server MCP — che orchestra i passaggi.
- Estrazione — Export o job da EasyFatt (CSV/foglio/query su dataset ridotto): solo colonne necessarie allo scopo.
- Preparazione — Minimizzazione, mascheramento, aggregati dove bastano; validazione schema.
- Chiamata Claude — Messages API con prompt di sistema + input strutturato, oppure tool MCP invocati dall’agente con scope limitati.
- Persistenza e log — Timestamp, modello/tool, hash del dataset, risposta, stato (ok / errore / da revisionare).
- Destinazione — CRM, ticket, foglio, coda di approvazione, o aggiornamento guidato — mai scrittura cieca di documenti fiscali.
Prima di scrivere codice, documenta tre artefatti: (1) campi consentiti in uscita; (2) formato output atteso (JSON/schema o bozza); (3) matrice “chi approva cosa”. Senza questi pezzi, MCP e API diventano una scatola nera. Il linguaggio di progetto è lo stesso di un’integrazione custom su API, middleware e webhook.
Quando il flusso è settimanale o multiutente, il copia-incolla non è più un “workaround”: è un rischio operativo. Ha senso progettare un’integrazione custom che colleghi agent e gestionale in modo automatico.
Cosa può fare un ponte Claude↔EasyFatt?
1. Lettura e sintesi su export controllati
Job che prepara un sottoinsieme (periodo, famiglia prodotto, agente) e chiede a Claude insight, anomalie qualitative o domande da verificare in EasyFatt. I numeri restano quelli del gestionale: il modello propone lettura, non inventa fatturato.
2. Classificazione note e bozze operative
Note documento, causali, ticket interni → etichette predefinite o bozze di procedura / FAQ / descrizione prodotto → coda di revisione. Utile quando il volume rende lenta la classificazione manuale.
3. Tool MCP “safe” e scritture con gate
Nei progetti di integrazione conviene partire read-first: tool che cercano e restituiscono dati minimizzati. Solo dopo, e con approvazione umana o doppio check, tool che scrivono su sistemi satelliti (CRM, fogli, ticket). Scrivere “alla cieca” su anagrafiche fiscali o documenti EasyFatt non è un obiettivo sano per un agente.
Quando questi flussi diventano ricorrenti, contattaci per una richiesta di integrazione / MCP: export automatico, regole di minimizzazione, tool esposti, log e punti di approvazione. Per un confronto umano sul perimetro, puoi anche usare i contatti.
Privacy, chiavi e cosa non esporre a Claude
Prima della “potenza del modello” arriva la minimizzazione: manda solo ciò che serve allo scopo dichiarato. Preferisci aggregati a nominativi quando l’analisi lo permette.
Sui prodotti commerciali Anthropic (es. Anthropic API, Claude for Work), Anthropic dichiara di non usare di default input e output per addestrare i modelli. Riferimento ufficiale: Is my data used for model training? (Privacy Center). Verifica sempre le pagine aggiornate: le policy possono evolvere. “Non usato per training” non significa “puoi caricare qualsiasi cosa”.
- Chiavi — in vault / variabili d’ambiente del middleware, non nei campi note di EasyFatt né in fogli condivisi.
- Scope MCP — esponi solo i tool necessari; preferisci read-only finché il processo non è collaudato.
- Ambienti — test con dataset di prova; produzione con log e budget/rate limit monitorati.
Non mandare di default: dump fiscali completi “per curiosità”, password/chiavi, note HR o dati sanitari, listini riservati interi se basta un campione, allegati non necessari.
Dove entrano CloudRemote e le integrazioni custom?
CloudRemote™ (Topsell) rende Danea EasyFatt accessibile in cloud (Windows, Mac, mobile, multiutente, multi-sede). Per un ponte AI è spesso il prerequisito operativo sottovalutato: export, job e middleware non devono dipendere da un unico PC acceso in ufficio.
Le integrazioni custom sono il pezzo che costruisce il ponte automatico verso Claude (API e/o MCP): mapping campi, tool sicuri, logging, approvazioni. Non inventiamo feature ufficiali Danea: EasyFatt resta EasyFatt; CloudRemote + sviluppo Topsell aggiungono cloud e connettori su misura.
In sintesi: CloudRemote stabilizza l’accesso al gestionale; l’integrazione custom collega l’agente. Per progettare il ponte, parti dalle integrazioni CloudRemote; per mettere EasyFatt in cloud in modo stabile, valuta l’abbonamento CloudRemote.
Checklist prima di andare in produzione
- Obiettivo in una frase (es. “tool MCP read-only su listino filtrato”).
- Colonne/minimi dati definiti; resto escluso.
- Scelta canale: API batch, MCP tool, o entrambi.
- Chiavi in vault; ambienti test/prod separati.
- Schema output + regole di revisione umana.
- Log, retry, alert errori; piano di pausa del job.
- Owner operativo (chi legge i log e chi approva).
Domande frequenti
EasyFatt parla nativamente con Claude o con MCP?
No. Non esiste un connettore ufficiale Claude/MCP dentro EasyFatt. Si lavora su export, job, API Anthropic o server MCP / middleware progettati ad hoc.
Basta Claude.ai o serve API / MCP?
La chat basta per prove e brief. Se il processo è ricorrente, multiutente o auditabile, serve Messages API e/o tool MCP con log e controlli.
Claude Code sostituisce l’integrazione?
No: Claude Code aiuta a sviluppare e testare. L’integrazione di produzione resta un servizio con chiavi, monitoring e ownership chiari.
CloudRemote sostituisce il ponte verso Claude?
No: CloudRemote mette EasyFatt in cloud; il ponte Claude (API/MCP) è un progetto di integrazione separato, spesso sullo stesso stack di automazioni.
Conclusione
Collegare Claude (API, Claude Code, MCP) a EasyFatt è un progetto di integrazione agent↔gestionale: smettere di vivere di export e copia-incolla, definire un contratto dati, esporre tool o pipeline con log e revisione umana. Non serve “tutta l’AI possibile”: serve un caso misurabile e un ponte che puoi spiegare a commerciale, amministrazione e IT. Il salto di qualità arriva quando il sistema è automatico — e la base cloud è stabile.
