Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Clover 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
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.
Prova a chiedere
Prompt di esempio per Clover
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 → Clover, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Clover + Meta Muse
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.
- 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).
- Incolla il token in
CLOVER_API_TOKEN. Viene inviato comeAuthorization: Bearer <token>. - Imposta
CLOVER_MERCHANT_IDsull'id esercente di 13 caratteri (mId). Si trova nell'indirizzo del dashboard.../merchants/<mId>/...e in Account and setup, Merchants. - Imposta
CLOVER_API_URLsulla regione dell'esercente:https://api.clover.com(Nord America),https://api.eu.clover.com(Europa),https://api.la.clover.com(America Latina) ohttps://apisandbox.dev.clover.com(sandbox). - 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 Muse
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.
Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.
- In Muse apri Settings → Connectors e scegli Add custom connector.
- Incolla l'URL del server MCP
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
- In una chat, chiedi a Muse qualcosa che richiede i tool di
Clover.
Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.
Tool disponibili
| Tool | What it does |
|---|---|
clover_get_merchant | Get the merchant behind the token: business name, address, phone, website, owner and default currency |
clover_get_merchant_address | Get the business address of the merchant: street lines, city, state, zip and country, as stored in Clover |
clover_get_merchant_properties | Get merchant settings: default currency, time zone, locale, tips and tax settings, receipt and order options |
clover_list_order_types | List order types of the merchant (dine in, take out, delivery and custom ones) with label, taxable flag, fee and hours |
clover_list_roles | List the employee roles of the merchant (admin, manager, employee and custom roles) with their system role and employees |
clover_list_items | List inventory items with name, price, price type, SKU, code, cost, stock tracking and visibility |
clover_get_item | Get one inventory item by id with price, price type, SKU, code, cost and, when expanded, categories, tax rates, modifier groups and stock |
clover_create_item | Create an inventory item. price is in cents (1999 = 19.99) and required; priceType FIXED, VARIABLE (entered at sale) or PER_UNIT |
clover_update_item | Update an inventory item (Clover updates with POST): name, price in cents, SKU, code, cost, visibility or categories |
clover_list_item_stocks | List the stock of all inventory items: item id, quantity on hand (decimal) and the low-stock alert threshold |
clover_get_item_stock | Get the stock of one inventory item: quantity on hand, stock alert threshold and when it last changed |
clover_update_item_stock | Set the stock of an inventory item to a new absolute quantity (not a change) |
clover_list_categories | List item categories with name, sort order and colour; expand items to get the items in each category |
clover_get_category | Get one item category by id with name, sort order and colour; expand items to list its items |
clover_list_category_items | List the items in one category with price, SKU and, when expanded, stock, tax rates and modifier groups |
clover_create_category | Create an item category shown on the register, with a name, sort order and colour |
clover_update_category | Rename a category or change its sort order or colour (Clover updates with POST). name is required by the API |
clover_list_tax_rates | List tax rates with name, rate (in units of 1/100000, so 825000 = 8.25%), flat amount, type and whether it is the default |
clover_list_discounts | List the predefined discounts of the merchant: name, amount in cents (negative) or percentage |
clover_list_modifier_groups | List modifier groups (e.g |
clover_list_orders | List orders with state, total in cents, payment state, employee, order type and times |
clover_get_order | Get one order by id with total, state, payment state and, when expanded, line items, discounts, payments, refunds and customers |
clover_create_atomic_order | Create a complete order in one call from an order cart: line items (inventory items or ad hoc), modifiers, discounts and service charge… |
clover_calculate_order | Calculate an order cart without saving it: totals, taxes, discounts and service charges for the same cart as clover_create_atomic_order |
clover_create_order | Create an empty custom order (title, note, state, order type), then add lines with clover_add_line_item |
clover_update_order | Update an order (Clover updates with POST): title, note, state, order type or tax removal |
clover_list_order_line_items | List the line items of an order with name, price in cents, quantity, discounts, modifications and refund state |
clover_get_order_line_item | Get one line item of an order with name, price in cents, unit quantity, note, discounts and modifications |
clover_add_line_item | Add a line item to an order: an inventory item by id, or an ad hoc line with name and price in cents. unitQty is quantity x 1000 for… |
clover_void_line_item | Remove (void) a line item from an order |
clover_list_order_discounts | List the order-level discounts applied to an order with name, amount in cents or percentage and approver |
clover_add_order_discount | Apply a discount to a whole order: a name plus an amount in cents (negative, e.g. -500) or a percentage, or a predefined discount by id |
clover_delete_order | Delete an order |
clover_list_payments | List payments with amount, tip and tax in cents, result (SUCCESS, FAIL and so on), tender, card type, order and employee |
clover_get_payment | Get one payment by id with amount, tip, tax, cash back in cents, result, tender, card transaction details and refunds |
clover_list_order_payments | List the payments made on one order with amount, tip and tax in cents, result, tender and card details |
clover_list_employee_payments | List the payments taken by one employee, with amount, tip and tax in cents, result and tender |
clover_list_refunds | List refunds with amount and tax in cents, the payment and order they belong to, employee and time |
clover_get_refund | Get one refund by id with amount, tax and tip in cents, the refunded payment, line items and employee |
clover_list_tenders | List tenders (payment methods such as cash, credit card, debit card, check, gift card, external) with label, label key and whether enabled |
clover_get_tender | Get one tender (payment method) by id with label, label key, instructions and whether it opens the cash drawer |
clover_list_customers | List customers with name, customer since and marketing consent; expand emailAddresses, phoneNumbers and addresses for contact data |
clover_get_customer | Get one customer by id with name, customer since, marketing consent and, when expanded, emails, phone numbers, addresses and notes |
clover_create_customer | Create a customer with name, email addresses, phone numbers, addresses and marketing consent |
clover_update_customer | Update a customer (Clover updates with POST): name, marketing consent or metadata such as business name and note |
clover_delete_customer | Delete a customer with their contact data |
clover_list_employees | List employees with name, nickname, email, role, PIN-protected flags and custom id; expand roles or shifts |
clover_get_employee | Get one employee by id with name, nickname, email, role and, when expanded, roles and shifts |
clover_list_shifts | List clock-in and clock-out shifts of all employees with in time, out time and overrides |
clover_list_employee_shifts | List the clock-in and clock-out shifts of one employee with in time, out time and overrides, newest first |
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
Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.
Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Microsoft Copilot
Questa guida ti è stata utile?