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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Clover. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, 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
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?