Come collegare Quaderno a Cursor via MCP

💡 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 + Cursor

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

1. Accedi a https://quadernoapp.com e apri Profile → API keys (https://quadernoapp.com/users/api-keys).
2. Copia la chiave privata, che inizia con sk_, in QUADERNO_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.
3. La stessa pagina mostra il tuo URL API, per esempio https://acme-1234.quadernoapp.com/api/. Metti la parte prima di .quadernoapp.com (qui acme-1234) in QUADERNO_ACCOUNT_NAME e installa il connettore.
4. 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 Cursor

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 mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Quaderno.

Tool disponibili

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

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT