Tallystick MCP
Leggi le fatture nel tuo agent
Lo stesso parser di questo sito, nel tuo agente. XRechnung, ZUGFeRD, Factur-X, UBL, CII, Peppol BIS. Un solo URL da incollare per il server ospitato, oppure eseguilo in locale così i file non lasciano mai il tuo computer.
Due modi per collegarsi
Sono lo stesso server, con gli stessi strumenti e la stessa chiave. Quello ospitato gira qui, in HTTPS: incolli un URL, accedi una volta, fatto. Quello locale gira sul tuo computer, in stdio: un’installazione e le tue fatture non lo lasciano mai.
Ospitato · HTTPS
Il server ospitato
Un URL e un accesso OAuth con la tua chiave Pro o Team. Nessun file di configurazione, nessun runtime; anche gli agenti web si collegano qui.
Collega senza installareLocale · stdio
Il server locale
Un comando, o il file MCPB per Claude Desktop. Legge intere cartelle, scrive Excel, CSV, QBO e PDF; i file non lasciano mai il tuo computer.
Eseguilo sulla tua macchinaCollega senza installare
Un URL, nessuna installazione. Il tuo agente si collega in HTTPS con OAuth: apre questo sito una volta, inserisci la tua chiave Pro o Team e gli strumenti per le fatture compaiono. Nessun file di configurazione, nessun runtime, niente da mantenere.
L’URL del server
https://tally-stick.com/mcp/v1
- Aggiungi un connettore personalizzato nel tuo agente e incolla l’URL.
- Si apre una pagina Tallystick; inserisci una volta la tua chiave Pro o Team.
- Fatto. Gli strumenti per le fatture compaiono nel tuo agente.
Il tuo agente
| Agente | Come collegarsi |
|---|---|
| Claude | Impostazioni, Connettori, Aggiungi connettore personalizzato. Incolla l’URL. |
| ChatGPT | Impostazioni, Connettori, attiva la modalità sviluppatore, poi Aggiungi connettore. Incolla l’URL. |
| Grok CLI | Esegui grok mcp add tallystick https://tally-stick.com/mcp/v1. L’OAuth è gestito per te. |
| Gemini CLI | Aggiungi l’URL sotto mcpServers in ~/.gemini/settings.json. Accedi quando si apre il browser. |
| Qualunque altro client | Chiunque si connetta a un server MCP remoto usa lo stesso URL; usa il suo passaggio per aggiungere un server. |
Ogni chiamata legge o verifica una fattura in memoria e non conserva nulla. Le esportazioni di cartelle e l’output PDF restano sul server locale qui sotto, dove i file non lasciano mai il tuo computer.
Eseguilo sulla tua macchina
Il server locale gira sul tuo computer, in stdio. Legge intere cartelle, scrive Excel, CSV, QBO e PDF e i file non lo lasciano mai. Claude Desktop su Windows usa il file MCPB; ogni altro client lancia un solo comando: uvx tallystick-mcp. Installa uv una volta. Niente progetto Python.
Claude Desktop / Windows
MCPB
Include il runtime. Apri il file, incolla la chiave, scegli la cartella fatture.
Scarica MCPBCursor / VS Code / Windsurf / Zed / altri
Un comando
uvx tallystick-mcp più la tua chiave in TALLYSTICK_LICENSE_KEY. La forma della config cambia col client; scegli sotto.
Config
Strumenti
Cosa può chiedere il tuo agente e quale server risponde.
| Strumento | Cosa fa | Dove |
|---|---|---|
detect_invoice_format | Nomina il formato; segnala PDF con XML incorporato | Entrambi |
read_invoice | Un file in JSON: parti, righe, IVA, totali | Entrambi |
validate_invoice | Calcoli, IVA, campi obbligatori; ogni riscontro codificato | Entrambi |
convert_invoice | Una fattura nel XML di un altro formato; PDF ed Excel restano sull’API REST | Ospitato |
read_invoices_table | Cartella come tabella, una riga per fattura | Locale |
export_invoices | Excel, CSV, JSON o QBO da molte fatture | Locale |
build_einvoice | XML EN 16931 dai dati, nove profili | Locale |
Chiave
Una chiave per entrambi i server. Quello ospitato la chiede una volta, nella sua pagina di accesso; quello locale la prende nella config qui sopra. Incluso in Pro e Team. Gli strumenti browser restano gratis; il server no.
FAQ
Domande
Quali agenti si possono collegare?
Qualsiasi client MCP che parla con server remoti: Claude, ChatGPT, Grok, Gemini CLI, Cursor, VS Code, Windsurf, Zed e altri. Il server ospitato usa OAuth: collegarsi è un accesso dal browser.
Laptop e desktop?
Pro copre una persona sulle sue macchine. Team cinque persone su una chiave condivisa.
Internet?
Il server locale lo richiede una volta, per attivare. Poi il token si verifica offline contro una chiave compilata nel pacchetto.
Conservate le mie fatture?
No. Sul server locale il parsing gira nel processo del tuo client, sulla tua macchina. Nessun percorso di upload.
La connessione ospitata vede le mie fatture?
Il testo della fattura di una chiamata viene elaborato in memoria ed eliminato quando la risposta torna; resta solo il conteggio giornaliero di uso equo. Se preferisci che nulla lasci il tuo computer, l’installazione locale qui sopra è quella strada.
Ho comprato la vecchia licenza unica
Funziona come venduta. Recupera la chiave con l’id PayPal della ricevuta.