Come collegare Xero a Cursor via MCP

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

Xero + Cursor

Fai leggere alla tua AI la contabilità Xero: fatture di vendita e fatture dei fornitori, contatti di clienti e fornitori, il piano dei conti, il bilancio di verifica (Trial Balance) e il conto economico con confronto tra periodi, per competenza o per cassa. In sola lettura, con la tua app OAuth2 di Xero e l'accesso tramite Authorize with Provider.

Prerequisiti

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

XERO_CLIENT_ID, XERO_CLIENT_SECRET

Step 1 — Ottieni le credenziali

1. Accedi a developer.xero.com/app/manage (My Apps) e crea un'app OAuth2 di tipo Web app (flusso authorization code).
2. Come redirect URI inserisci https://cloud.anythingmcp.com/api/mcp-oauth/callback per AnythingMCP Cloud, oppure <tuo URL AnythingMCP>/api/mcp-oauth/callback se ospiti AnythingMCP in proprio. L'URI deve corrispondere esattamente.
3. Nella pagina Configuration dell'app copia il Client ID in XERO_CLIENT_ID, poi genera un client secret e incollalo in XERO_CLIENT_SECRET.
4. Lascia vuoti XERO_TENANT_ID e XERO_REFRESH_TOKEN e installa il connettore. Nella pagina del connettore clicca su Authorize with Provider, accedi a Xero e collega l'organizzazione che l'AI deve leggere.
5. Esegui xero_list_connections. Scegli la voce con il tenantName giusto e il tenantType ORGANISATION e copia il suo tenantId in XERO_TENANT_ID. Non usare l'id o l'authEventId della connessione: sono valori diversi. Finché XERO_TENANT_ID non è impostato, gli altri tool si fermano prima di chiamare Xero e indicano la variabile mancante.
6. Esegui xero_get_organisation e controlla il nome dell'organizzazione prima che l'AI legga qualsiasi cifra. Un connettore legge una sola organizzazione; per una seconda installalo di nuovo.

Restare connessi: gli access token durano 30 minuti e vengono rinnovati automaticamente, e AnythingMCP salva ogni nuovo refresh token emesso da Xero. Un refresh token non rinnovato per 60 giorni scade; a quel punto clicca di nuovo su Authorize with Provider. Compila XERO_REFRESH_TOKEN solo se hai già un refresh token valido per la stessa app con lo stesso consenso in sola lettura, e non condividere un refresh token con un'altra integrazione: Xero lo sostituisce a ogni rinnovo e una delle due resterebbe con un token non più valido.

Sola lettura per costruzione: tutti e dieci i tool leggono soltanto (GET); nessuno crea, modifica o elimina dati contabili. Il connettore chiede gli scope di sola lettura openid offline_access accounting.invoices.read accounting.contacts.read accounting.settings.read accounting.reports.trialbalance.read accounting.reports.profitandloss.read. Xero aggiunge consensi invece di sostituirli: se in passato l'app è stata autorizzata con permessi di scrittura, il token li mantiene. Per ridurli revoca la vecchia connessione in Xero e clicca di nuovo su Authorize with Provider. L'AI vede inoltre solo ciò che può vedere l'utente Xero che effettua l'accesso; per i report serve un utente con accesso ai report.

Fatture, contatti e conti: xero_list_invoices restituisce insieme fatture di vendita (ACCREC) e fatture dei fornitori (ACCPAY). Filtra con where, per esempio Type=="ACCREC", e ordina con order, per esempio InvoiceNumber ASC. Fatture e contatti arrivano in pagine da massimo 100 record; l'AI continua a sfogliare finché una pagina torna vuota o incompleta. xero_list_contacts cerca in nomi, numeri di contatto e indirizzi email e, se richiesto, include i contatti archiviati. Il piano dei conti arriva tutto in una volta. xero_get_invoice, xero_get_contact e xero_get_account vogliono l'UUID della lista corrispondente, non un numero di fattura, un nome di contatto o un codice conto.

Report: xero_get_trial_balance prende una date, xero_get_profit_and_loss un fromDate e un toDate (formato YYYY-MM-DD). Entrambi lavorano per competenza, a meno che tu non chieda il criterio di cassa (paymentsOnly). Il conto economico può confrontare da 1 a 12 periodi per mese, trimestre o anno (periods e timeframe).

Errori comuni: 401 o 403 significa consenso mancante, autorizzazione scaduta, un utente Xero senza i permessi necessari o un'organizzazione non collegata a questa app: confronta XERO_TENANT_ID con xero_list_connections, poi clicca di nuovo su Authorize with Provider. 429 significa che è stato raggiunto il limite di richieste di Xero per l'organizzazione: l'AI attende i secondi indicati in Retry-After prima di riprovare, e l'header X-Rate-Limit-Problem dice quale limite è stato superato. I limiti dipendono dal livello della tua app, vedi i limiti API di Xero.

Il connettore non crea, modifica né elimina nulla in Xero, e non legge movimenti bancari, stato patrimoniale, buste paga, file o allegati.

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

Tool disponibili

Esempi di prompt

• "Quali fatture di vendita sono ancora da incassare, e quanto ci deve in totale ogni cliente?"
• "Mostrami il conto economico dell'ultimo trimestre confrontato con i tre trimestri precedenti."
• "Quali fatture dei fornitori scadono nei prossimi 14 giorni, e per quali importi?"
• "Trova Acme Srl tra i nostri contatti e mostrami email, indirizzo di fatturazione e saldo aperto."

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