Come collegare Clover a Cursor via MCP

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

Clover + Cursor

Il punto cassa Clover (Fiserv) per un esercente: dati e impostazioni dell'attività, articoli con giacenza, categorie, aliquote, sconti e modificatori, ordini con righe, pagamenti, rimborsi e metodi di pagamento, clienti, dipendenti e turni. Crea e aggiorna articoli, giacenze, categorie, ordini e clienti. Nord America, Europa, America Latina o sandbox.

Prerequisiti

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

CLOVER_API_TOKEN, CLOVER_MERCHANT_ID, CLOVER_API_URL

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti servono un account esercente Clover (o un esercente di test) e un utente admin che possa creare token API.

1. Accedi al Clover Merchant Dashboard come admin e apri Settings, View all settings, API tokens (in Account and setup, Business operations). Crea un token e spunta i permessi necessari ai tool: Merchant read, Inventory read e write, Orders read e write, Payments read, Customers read e write, Employees read. Per un esercente di test fai lo stesso dal Global Developer Dashboard (Test merchants, Launch dashboard).
2. Incolla il token in CLOVER_API_TOKEN. Viene inviato come Authorization: Bearer <token>.
3. Imposta CLOVER_MERCHANT_ID sull'id esercente di 13 caratteri (mId). Si trova nell'indirizzo del dashboard .../merchants/<mId>/... e in Account and setup, Merchants.
4. Imposta CLOVER_API_URL sulla regione dell'esercente: https://api.clover.com (Nord America), https://api.eu.clover.com (Europa), https://api.la.clover.com (America Latina) o https://apisandbox.dev.clover.com (sandbox).
5. Installa il connettore ed esegui clover_get_merchant: mostra il nome dell'attività e conferma il token.

Cosa legge: l'esercente con clover_get_merchant, clover_get_merchant_address e clover_get_merchant_properties (valuta, fuso orario, locale, impostazioni di mance e tasse), i tipi di ordine e i ruoli dei dipendenti; gli articoli con clover_list_items e clover_get_item (prezzo, tipo di prezzo, SKU, codice, costo; con expand categorie, aliquote, gruppi di modificatori o giacenza), le giacenze con clover_list_item_stocks e clover_get_item_stock, le categorie con clover_list_categories, clover_get_category e clover_list_category_items, più aliquote, sconti predefiniti e gruppi di modificatori; gli ordini con clover_list_orders e clover_get_order (expand lineItems e payments), le loro righe e gli sconti sull'ordine; i pagamenti con clover_list_payments, clover_get_payment, clover_list_order_payments e clover_list_employee_payments (utile per mance e vendite per dipendente), i rimborsi con clover_list_refunds e clover_get_refund, i metodi di pagamento (tender) con clover_list_tenders e clover_get_tender; i clienti con clover_list_customers e clover_get_customer (expand emailAddresses, phoneNumbers e addresses); i dipendenti con clover_list_employees e clover_get_employee e le timbrature con clover_list_shifts e clover_list_employee_shifts.

Cosa scrive: articoli con clover_create_item e clover_update_item; la giacenza con clover_update_item_stock, che imposta una quantità assoluta e non una differenza, quindi l'AI legge prima la giacenza attuale; categorie con clover_create_category e clover_update_category; clienti con clover_create_customer e clover_update_customer. Ordini in una chiamata: clover_calculate_order restituisce totali, tasse, sconti e costi di servizio senza salvare, poi clover_create_atomic_order crea lo stesso carrello. Passo per passo: clover_create_order, clover_add_line_item, clover_add_order_discount e clover_update_order. Clover aggiorna un record con un POST al suo indirizzo. Ordini e modifiche di giacenza compaiono subito sui dispositivi e nei report dell'esercente, quindi l'AI ti mostra cosa cambierà e aspetta il tuo sì.

Disattivati all'installazione: clover_void_line_item, clover_delete_order e clover_delete_customer. Non si possono annullare, quindi un admin del workspace li attiva quando servono al team.

Filtri: filter accetta una lista di condizioni nella forma campo operatore valore, ad esempio ["createdTime>=1767225600000", "createdTime<1767830400000"]; vengono combinate in AND. I filtri temporali su ordini, pagamenti e rimborsi coprono al massimo 90 giorni per richiesta, quindi l'AI divide i periodi più lunghi in finestre da 90 giorni. expand aggiunge i record collegati nella stessa chiamata (separati da virgola).

Formati dei dati: le liste arrivano come {elements: [...], href}. Gli importi sono interi in centesimi della valuta dell'esercente (1999 = 19,99); gli sconti sono importi negativi. Le quantità sulle righe (unitQty) sono moltiplicate per 1000. Le aliquote sono moltiplicate per 100000 (825000 = 8,25%). Gli orari sono millisecondi Unix epoch in UTC; l'AI li converte con il fuso orario di clover_get_merchant_properties. Gli id sono stringhe di 13 caratteri.

Paginazione: limit (100 di default, al massimo 1000) e offset. Quando una pagina contiene limit elementi, l'AI chiede di nuovo con offset più limit. Le liste annidate caricate con expand si fermano a 100 voci.

Limiti ed errori comuni: 16 richieste al secondo e 5 richieste contemporanee per token; oltre, Clover risponde 429 con retry-after. 401 indica un token errato o revocato oppure la regione sbagliata in CLOVER_API_URL (un token sandbox funziona solo su apisandbox.dev.clover.com). 403 indica che al token manca il permesso per quei dati: modifica il token nel Merchant Dashboard e spuntalo. 404 indica un id esercente o un id record errato. 400 di solito indica un campo di filtro non valido.

Il connettore non incassa pagamenti con carta e non emette rimborsi: avvengono sul dispositivo Clover o tramite la Clover Ecommerce API. Legge aliquote, sconti, gruppi di modificatori, dipendenti e turni senza modificarli e, con i tool attivi all'installazione, non elimina nulla.

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

Tool disponibili

Esempi di prompt

• "Quanto abbiamo incassato ieri, mance comprese, diviso per metodo di pagamento? Usa il nostro fuso orario."
• "Quali articoli con gestione giacenza hanno meno di 10 pezzi? Mostra nome, SKU e quantità."
• "Porta il prezzo dell'articolo Cappuccino a 4,20. Mostrami prezzo vecchio e nuovo prima di salvare."
• "Calcola un ordine con 2 pizze Margherita e 1 limonata con il nostro sconto dipendenti, mostrami il totale e poi crealo."
• "Elenca i rimborsi degli ultimi 30 giorni con importo, ordine originale e dipendente."

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