Come collegare Invoice123 a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Invoice123, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Invoice123 + Cursor

Invoice123 (Saskaita123), fatturazione per Lituania e Lettonia, in sola lettura: fatture di vendita con pagamenti, link di pagamento e PDF, acquisti, clienti, prodotti, progetti, documenti di trasporto, aliquote IVA, serie e conti bancari.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

INVOICE123_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Invoice123 (in Lituania Saskaita123) in cui puoi installare integrazioni.

1. In Invoice123 apri il menu dell'account (in alto a destra), poi Integrations (icona del puzzle) o Account settings > Integrations, e installa l'integrazione API.
2. Clicca Generate your API key, dai un nome alla chiave e spunta i permessi che l'AI può usare: almeno invoice:index, più expense:index, client:index, product:index, project:index e waybills:index per quelle aree. Il PDF delle fatture verifica invoice:store, quello delle offerte commercial:store.
3. Incolla solo la chiave in INVOICE123_API_TOKEN, senza la parola Bearer, spazi o virgolette. Il connettore la invia come Authorization: Bearer.
4. Installa il connettore ed esegui invoice123_get_company per verificare il token.

Cosa legge: le fatture di vendita con cliente, righe, IVA, totali, valuta, pagamenti e indicatore di pagato; i pagamenti di una fattura, cioè come e quando è stata pagata (bonifico, contanti, carta, scontrino di cassa); il link di pagamento online di una fattura, quando l'azienda ha attivato Montonio o Paysera; i PDF di fatture e offerte commerciali in lituano, inglese o lettone; le fatture di acquisto (spese) con tipi di spesa, IVA e pagamenti; i clienti (clienti e fornitori); il catalogo prodotti con prezzi e giacenza per magazzino; i progetti con budget; i documenti di trasporto; e i dati di riferimento: serie dei documenti, aliquote IVA per vendite e acquisti, conti bancari, unità di misura, attività, registratori di cassa e modelli e-mail.

Come lo usa l'AI: quando le servono gli id legge prima i dati di riferimento, in una sola chiamata con invoice123_get_invoice_data (attività, serie, banche, unità, aliquote IVA e magazzini) oppure un elenco alla volta. Per le partite aperte filtra invoice123_list_invoices per status unpaid o late, per un periodo con range e per un cliente con client_id; invoice123_list_invoice_payments mostra poi come è stata saldata una fattura.

Sola lettura: tutti i 21 tool leggono soltanto. In Invoice123 non viene emesso, inviato o modificato nulla, quindi non c'è niente da confermare e nessun tool è disattivato all'installazione.

Pagine, date e importi: gli elenchi restituiscono data.result e data.pagination (current_page, last_page, total); l'AI passa page (da 1) e limit (predefinito 20) e si ferma a last_page. Un intervallo di date è composto da due date YYYY-MM-DD unite da una virgola. Gli importi sono stringhe nella valuta della fattura, di solito EUR.

Limiti: 60 richieste al minuto con il piano Standard, 1.000 all'ora con Business. Oltre, Invoice123 risponde 429.

Errori comuni: 401 significa un token sbagliato o eliminato. 403 significa che al token manca il permesso indicato nella descrizione del tool; acquisti, documenti di trasporto e offerte richiedono inoltre il relativo modulo attivo nell'account.

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 Invoice123.

Tool disponibili

Esempi di prompt

• "Quali fatture sono scadute, per quali importi e a quali clienti si riferiscono?"
• "Come e quando è stata pagata l'ultima fattura a UAB Pavyzdys?"
• "Elenca le fatture di acquisto di questo mese per tipo di spesa, con la relativa IVA."
• "Dammi il link di pagamento online della fattura aperta di UAB Pavyzdys."
• "Scarica il PDF della nostra ultima fattura in inglese."

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
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot