Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Quaderno con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Gestisci imposte e fatture di Quaderno dalla tua AI: calcola sales tax, IVA e GST per qualsiasi località, verifica partite IVA, cerca contatti, fatture, note di credito, preventivi, spese e prodotti, emetti e invia fatture per email e richiedi report fiscali.
Prova a chiedere
Prompt di esempio per Quaderno
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Quaderno, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Quaderno
Gestisci imposte e fatture di Quaderno dalla tua AI: calcola sales tax, IVA e GST per qualsiasi località, verifica partite IVA, cerca contatti, fatture, note di credito, preventivi, spese e prodotti, emetti e invia fatture per email e richiedi report fiscali.
Setup
- Accedi a
https://quadernoapp.come apri Profile → API keys (https://quadernoapp.com/users/api-keys). - Copia la chiave privata, che inizia con
sk_, inQUADERNO_API_KEY. La chiave pubblicabile (pk_) qui non funziona. La chiave viene inviata come nome utente HTTP Basic con password vuota, solo al tuo account Quaderno. - La stessa pagina mostra il tuo URL API, per esempio
https://acme-1234.quadernoapp.com/api/. Metti la parte prima di.quadernoapp.com(quiacme-1234) inQUADERNO_ACCOUNT_NAMEe installa il connettore. - Verifica la configurazione con
quaderno_ping: conferma la chiave e mostra le richieste rimaste nella finestra attuale.
Le fatture si emettono e si inviano solo dopo il tuo sì: una fattura emessa è un documento fiscale. Quaderno la numera in sequenza e non si può cancellare, solo annullare o stornare con una nota di credito nell'app Quaderno. Prima di quaderno_create_invoice l'AI ti mostra cliente, righe, prezzi e valuta. Prima di quaderno_deliver_invoice, che invia subito la fattura al cliente per email e non si può annullare, ti dice quale fattura va a quale indirizzo. Anche quaderno_create_contact e quaderno_request_report chiedono prima. Creare una fattura non la invia. quaderno_delete_contact è installato disattivato.
Calcolo delle imposte: quaderno_calculate_tax restituisce sales tax, IVA o GST per una vendita verso qualsiasi località: nome dell'imposta, aliquota, importo dell'imposta, imponibile e totale, la giurisdizione fino alla città e avvisi come il reverse charge per una partita IVA UE valida. Calcola soltanto e non registra nulla. quaderno_validate_tax_id verifica una partita IVA o un numero d'impresa nel registro ufficiale del suo paese (VIES UE, Regno Unito, Svizzera, Québec, Australia, Nuova Zelanda).
Cosa legge: contatti, fatture, note di credito, preventivi (Quaderno li chiama proforma), spese, prodotti, giurisdizioni fiscali e codici fiscali dei prodotti. I report fiscali (imposte riscosse per giurisdizione per le tue dichiarazioni, elenco fatture o elenco note di credito) vengono generati in background: l'AI ne richiede uno per un periodo, controlla finché è pronto e ti dà il link per scaricarlo.
Dati sensibili: fatture e contatti contengono nomi, indirizzi e numeri fiscali dei tuoi clienti e sono registrazioni fiscali. Condividili solo con chi si occupa della fatturazione.
Importi: i campi che finiscono con _cents sono in centesimi (12345 è 123,45); i prezzi e i risultati del calcolo delle imposte sono nell'unità della valuta.
Limite di richieste: 100 chiamate ogni 15 secondi. Un 429 significa aspettare che la finestra si azzeri.
Errori comuni: 401 Wrong API key or the user does not exist: la chiave è errata, è la chiave pk_, oppure appartiene a un account diverso da QUADERNO_ACCOUNT_NAME. 406: un valore non valido, come un codice fiscale di prodotto sconosciuto. 422: il documento non si può creare così, per esempio senza righe.
Non incluso: modificare, annullare o segnare come inesigibili le fatture, registrare pagamenti, ricevute, documenti ricorrenti, transazioni, sessioni di checkout e coupon, prove di localizzazione, webhook, la Sandbox e gli account Quaderno Connect.
Prerequisiti: QUADERNO_ACCOUNT_NAME, QUADERNO_API_KEY
Installazione locale del connettore
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Apri http://localhost:3000/connectors/store, scegli Quaderno e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
quaderno_ping | Check that the API key works and see the requests left in the current rate-limit window |
quaderno_list_contacts | List or search customers and suppliers (contacts) by name, email or tax id: id, kind (person or company), name, email, tax id and tax… |
quaderno_get_contact | Get one contact with full address, phone, website, language, default discount, notes and the link to their billing area |
quaderno_create_contact | Create a customer or supplier contact |
quaderno_delete_contact | Delete one contact for good |
quaderno_list_invoices | List or search invoices by number, customer name or PO number, issue date range, state or customer: id, number, dates, state (outstanding… |
quaderno_get_invoice | Get one invoice in full: customer and billing address, line items with their taxes, the tax breakdown, payments, deliveries, alerts, the… |
quaderno_create_invoice | Issue a new invoice |
quaderno_deliver_invoice | Email an invoice to its customer from Quaderno, with the PDF and the link to it |
quaderno_list_credit_notes | List or search credit notes (refunds and corrections of invoices) by number, customer name or PO number, issue date range or state: id… |
quaderno_get_credit_note | Get one credit note in full: customer, line items, tax breakdown, payments, deliveries, the related invoice, the public link and the PDF… |
quaderno_list_quotes | List or search quotes (Quaderno calls them proformas; they replaced estimates) by number, customer name or PO number, issue date range… |
quaderno_get_quote | Get one quote (proforma) in full: customer, line items, tax breakdown, validity, the public link and the PDF link |
quaderno_list_expenses | List or search expenses (purchase invoices from suppliers) by number, supplier name or PO number, issue date range, state or supplier: id… |
quaderno_list_products | List or search products (items) by name or code: id, code, name, description, unit cost, currency, kind (one-off or subscription), product… |
quaderno_calculate_tax | Calculate the sales tax, VAT or GST for a sale to a customer location: tax name, rate, taxable part, tax amount, subtotal and total, the… |
quaderno_validate_tax_id | Check a business tax id against the official registry of its country (EU VIES, UK, Switzerland, Quebec, Australia, New Zealand): returns… |
quaderno_list_tax_jurisdictions | List the tax jurisdictions Quaderno knows, optionally for one country or region: id, name, country and region |
quaderno_list_tax_codes | List the tax codes products can be classified with (e.g. eservice, saas, ebook, consulting, standard, reduced, exempt): id, name and what… |
quaderno_list_reports | List the reports requested so far: id, type (tax_summary, invoices_list, credits_list), state, period, when it completed and the download… |
quaderno_request_report | Ask Quaderno to build a report for a period: tax_summary (taxes collected per jurisdiction, for filing returns), invoices_list or… |
quaderno_get_report | Check one report request: state (pending, suceeded or failed), period, when it completed and the report_url to download it once ready |
Esempi di prompt
- "Quale IVA si applica a un abbonamento SaaS da 49 EUR venduto a un privato a Lione, in Francia? E a un'azienda lì con partita IVA valida?"
- "La partita IVA DE123456789 è valida?"
- "Quali fatture sono ancora aperte o scadute, e a quanto ammontano per valuta?"
- "Emetti una fattura a Northwind GmbH per 10 ore di consulenza a 120 EUR l'ora. Mostrami tutto prima di crearla e non inviarla ancora."
- "Richiedi un report di riepilogo fiscale per il terzo trimestre e dammi il link per scaricarlo quando è pronto."
Prossimi passi
Questa guida ti è stata utile?
