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 un software di fatturazione e di contabilita controllato dalla voce. Invece di compilare moduli, dici semplicemente cio di cui hai bisogno - e l'IA fa il resto. Inizia la tua prova gratuita di 14 giorni e collega Claude al tuo account LumaBill.