Documentazione — i3billing

i3billing è un connettore remoto per Claude. Una volta collegato, Claude può interrogare i dati della tua Fatture in Cloud senza che tu apra la dashboard.

Servono due autorizzazioni, una sola volta ciascuna: una che collega il tuo account Fatture in Cloud a i3billing, e una che collega i3billing a Claude.

1. Collega Fatture in Cloud

Vai su app.i3billing.com e accedi con Google.
Premi Collega Fatture in Cloud.
Autorizza i3billing sul consenso di Fatture in Cloud.

Torni sulla home con l'elenco delle aziende che quell'autorizzazione può vedere. Se amministri più aziende con account separati, ripeti il passo per ognuno: le autorizzazioni si sommano sullo stesso profilo.

2. Aggiungi il connettore a Claude

In Claude, apri Impostazioni → Connettori → Aggiungi connettore.
Incolla l'URL del connettore:
```
https://mcp.i3billing.com/mcp
```
Claude apre l'autorizzazione: accedi e conferma.

Non serve nessun file di configurazione, e non devi copiare nessuna chiave a mano. Da questo momento gli strumenti fic_* sono disponibili nella conversazione.

3. Fai la prima domanda

Qualche esempio che funziona da subito:

Quanto ho fatturato a giugno, per cliente?
Chi non mi ha ancora pagato?
Riepilogami le fatture di quel cliente quest'anno.
Qual è la rata scaduta da più tempo?

Scegliere l'azienda

Se il tuo profilo vede più aziende, Claude usa l'azienda predefinita. Per cambiarla, chiedi di impostarne un'altra: lo strumento fic_select_company salva la preferenza sul tuo profilo i3billing. La preferenza non tocca nulla su Fatture in Cloud.

Scritture e conferme

Gli strumenti che modificano qualcosa sono due, e oggi il connettore ospitato non li offre: non sono registrati per nessun utente, qualunque piano abbia. Li documentiamo qui perché è ciò che arriverà, non ciò che trovi adesso:

fic_set_internal_note — scrive la nota interna privata di un documento. Non compare in fattura.
fic_create_unsent_invoice — crea una fattura numerata non trasmessa allo SdI, da rivedere e inviare a mano.

Quando li attiveremo, entrambi chiederanno una conferma esplicita prima di eseguire. Nessuno strumento di i3billing trasmette una fattura allo SdI: quella resta un'azione tua, dentro Fatture in Cloud.

Permessi richiesti

Oggi il connettore ospitato chiede a Fatture in Cloud solo permessi di lettura su anagrafiche e documenti emessi: è in sola lettura, uguale per tutti. Il permesso di scrittura sui documenti emessi serve ai due strumenti sopra e non viene richiesto. I piani a pagamento sono annunciati, non ancora attivi.

Problemi comuni

Il connettore non compare in Claude. Controlla di aver incollato l'URL completo, /mcp incluso, e che l'autorizzazione sia andata a buon fine.

La prima domanda dopo un periodo di inattività è lenta. Il servizio scala a zero quando non lo usi: la prima chiamata lo risveglia. Le successive sono immediate.

Claude risponde che non trova l'azienda. Vuol dire che il profilo vede più aziende e nessuna è predefinita. Chiedi di impostare l'azienda che ti serve.

Ho revocato l'autorizzazione su Fatture in Cloud. Ricollegala da app.i3billing.com: i vecchi token non sono più validi e vanno sostituiti.

Supporto

Scrivici dal modulo su i3billing.com/supporto, oppure via email a support@i3billing.com. Rispondiamo noi. Il connettore non apre ticket: quelli passano dal modulo o dall'email.