Cos'e il server MCP di LumaBill?
MCP (Model Context Protocol) e uno standard aperto che permette agli assistenti IA di comunicare con servizi esterni. Immagina di parlare con Claude, Cursor o un altro strumento IA — e che possa accedere direttamente ai tuoi dati LumaBill: creare fatture, cercare clienti, verificare spese o ottenere report finanziari.
Il server MCP di LumaBill funziona su mcp.lumabill.ch e mette a disposizione 52 strumenti che coprono ogni area:
- Fatture, offerte e fatture ricorrenti
- Clienti e fornitori
- Spese e registrazioni contabili
- Conti bancari e importazioni CAMT (con riconciliazione automatica)
- Report sul fatturato e analisi finanziarie
- Articoli del catalogo e pagamenti
Configurazione in 3 minuti
1. Creare una chiave API
Vai in Impostazioni > Chiavi API in LumaBill e crea una nuova chiave. Scegli tra:
- Solo lettura — perfetto per query e report
- Lettura e scrittura — anche per creare e modificare dati
2. Collegare il server MCP
Aggiungi questa configurazione nelle impostazioni MCP del tuo strumento IA:
{
"mcpServers": {
"lumabill": {
"url": "https://mcp.lumabill.ch/mcp?key=YOUR_API_KEY"
}
}
}
In Claude Desktop, vai in Impostazioni > Server MCP. In Claude Code, aggiungilo in .mcp.json. In Cursor, usa il pannello delle impostazioni MCP.
3. Inizia a usarlo
Una volta connesso, puoi lavorare con i tuoi dati LumaBill usando il linguaggio naturale.
Esempi pratici: Cosa puoi fare con IA + LumaBill
Cercare clienti
Tu dici: "Mostrami tutti i miei clienti a Zurigo"
Claude risponde:
Ho recuperato i tuoi clienti. Ecco quelli a Zurigo:
Cliente Indirizzo N° cliente Muller IT Solutions GmbH Bahnhofstrasse 42, 8001 Zurigo C-006 MCP Test AG 8005 Zurigo C-009 Vuoi creare una fattura per uno di questi clienti?
Creare una fattura con una frase
Tu dici: "Crea una fattura per Muller IT Solutions per 16 ore di web design a CHF 180 all'ora"
Claude risponde:
Fattura creata:
- Numero: IV-023
- Cliente: Muller IT Solutions GmbH
- Voce: Web Design — 16h × CHF 180.00
- Totale: CHF 2'880.00
- Scadenza: 10.05.2026 (30 giorni)
I tuoi dati aziendali, la valuta e le condizioni di pagamento sono stati compilati automaticamente dal tuo profilo. Vuoi inviarla?
Il punto chiave: devi specificare solo il cliente e le voci. LumaBill compila automaticamente i dati del mittente, la valuta, le impostazioni IVA, il termine di pagamento e persino il prossimo numero di fattura — inclusa la QR-fattura svizzera conforme, se attivata.
Verificare le spese
Tu dici: "Quali sono le mie spese di questo mese?"
Claude risponde:
Ecco le tue spese per aprile 2026:
Data Fornitore Descrizione Importo 10.04.2026 Test Vendor GmbH Materiale d'ufficio CHF 89.50 Totale aprile: CHF 89.50
Vuoi confrontare con il mese scorso?
Consultare le fatture non pagate
Tu dici: "Quali fatture sono ancora da pagare?"
Claude risponde:
Hai attualmente 8 fatture non pagate:
Fattura Cliente Importo Scadenza IV-022 Update Test AG CHF 50.00 10.05.2026 IV-019 MCP Test AG CHF 0.00 10.05.2026 IV-018 Muller IT Solutions GmbH CHF 300.00 10.05.2026 ... ... ... ... Vuoi inviare un promemoria di pagamento?
Ottenere report finanziari
Tu dici: "Genera un conto economico per il Q1 2026"
Claude risponde:
Tipi di report disponibili:
- Profit & Loss — conto economico
- Balance Sheet — bilancio
- VAT Report — dichiarazione IVA
Genero il report P&L per il Q1 2026 (1 gennaio – 31 marzo 2026)...
Casi d'uso avanzati
Riepiloghi mensili automatizzati
Chiedi a Claude di creare un riepilogo alla fine di ogni mese — particolarmente utile se tieni una contabilita semplificata:
"Riassumi il mio aprile: quante fatture ho inviato, qual e stato il mio fatturato e quali sono state le spese maggiori?"
Operazioni in massa
"Crea fatture per tutti i miei clienti mensili con le stesse voci del mese scorso."
Automatizzare gli obblighi contabili
Come freelancer in Svizzera, devi documentare tutte le entrate e le uscite senza lacune. Con l'IA diventa una sola frase:
"Categorizza tutte le spese di questo mese e crea un riepilogo per conto."
Verifica della qualita dei dati
"Controlla se tutti i miei clienti hanno un indirizzo e-mail. Elenca quelli senza."
Sicurezza
- La tua chiave API resta privata — viene trasmessa solo tra il tuo strumento IA e il server LumaBill
- Rate limiting protegge da richieste massive accidentali (60 letture / 20 scritture al minuto)
- Controlli di accesso — decidi tu se la chiave e in sola lettura o lettura-scrittura
- Solo Pro/Lifetime — l'accesso API e una funzionalita premium
- Chiavi revocabili in qualsiasi momento dalle impostazioni
API REST per sviluppatori
Oltre al server MCP, LumaBill offre anche un'API REST su api.lumabill.ch/v1 — con la stessa autenticazione. Ideale per integrazioni personalizzate, script o webhook.
Documentazione completa con Swagger UI interattivo nella documentazione sviluppatori.
Conclusione
Con il server MCP, LumaBill diventa uno strumento contabile controllato dalla voce. Invece di compilare moduli, dici semplicemente cio di cui hai bisogno — e l'IA fa il resto. Crea il tuo account gratuito e collega Claude al tuo account LumaBill.