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 + Microsoft Copilot
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.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
QUADERNO_ACCOUNT_NAME, QUADERNO_API_KEY
Step 1 — Ottieni le credenziali
- 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.
Step 2 — Installa l'adapter
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
Step 3 — Aggiungi il connettore in Microsoft Copilot
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Quaderno. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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."
FAQ
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?