In breve
Collega la cassa ready2order (registratore di cassa) alla tua AI: articoli, prezzi e giacenze, gruppi di prodotti, scontrini e vendite giornaliere, ordini aperti, clienti, metodi di pagamento e aliquote IVA, con modifiche confermate su articoli, giacenze e clienti.
Configurazione guidata
Collega ready2order a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega ready2order con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per ready2order
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 → ready2order, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
ready2order + Microsoft Copilot
Collega la cassa ready2order (registratore di cassa) alla tua AI: articoli, prezzi e giacenze, gruppi di prodotti, scontrini e vendite giornaliere, ordini aperti, clienti, metodi di pagamento e aliquote IVA, con modifiche confermate su articoli, giacenze e clienti.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
READY2ORDER_ACCOUNT_TOKEN
Step 1 — Ottieni le credenziali
ready2order rilascia un Account Token per ogni account cassa con una breve procedura di approvazione. Richiede circa 10 minuti, una sola volta per account, e servono il login del titolare dell'account e una registrazione gratuita come sviluppatore.
- Registrati come sviluppatore su
https://api.ready2order.com. ready2order ti invia via e-mail un Developer Token. - Richiedi l'accesso con quel token:
La risposta contienecurl -X POST https://api.ready2order.com/v1/developerToken/grantAccessToken \ -H "Authorization: Bearer <DEVELOPER_TOKEN>" -H "Content-Type: application/json" -d "{}"grantAccessTokenegrantAccessUri. - Apri
grantAccessUrientro 10 minuti, accedi con il titolare dell'account ready2order e clicca Approve. - Leggi l'Account Token:
curl https://api.ready2order.com/v1/developerToken/grantAccessToken/<grantAccessToken> \ -H "Authorization: Bearer <DEVELOPER_TOKEN>" - Incolla
accountTokendalla risposta inREADY2ORDER_ACCOUNT_TOKENe installa il connettore. Il token viene inviato solo a ready2order e resta valido finché non lo revochi nell'admin di ready2order, in Settings → API access.
Il solo Developer Token viene rifiutato con 403: il connettore ha bisogno dell'Account Token.
Cosa copre: articoli con prezzo, IVA, codice articolo, codice a barre e giacenza, giacenze con livello di riordino e scorta di sicurezza, gruppi di prodotti, scontrini e fatture (Belege) con righe, pagamenti e riepilogo IVA, un link al PDF di ogni scontrino, ordini aperti per tavolo, clienti e gruppi di clienti, metodi di pagamento, aliquote IVA, gli utenti della cassa e se è aperta una chiusura giornaliera.
Conferma prima: le scritture cambiano subito la cassa in uso, e un nuovo articolo compare immediatamente nel POS. L'AI indica l'articolo o il cliente e i nuovi valori e aspetta il tuo sì. Può creare e modificare articoli, registrare giacenze (un valore assoluto dopo un inventario, oppure una quantità in entrata o in uscita, come merce ricevuta o rotture), creare gruppi di prodotti e creare e modificare clienti. ready2order_delete_product è disattivato all'installazione; per togliere un articolo dalla vendita, l'AI lo imposta come inattivo.
Dati di vendita: ready2order_list_bills accetta un intervallo di date. Per impostazione predefinita le date seguono la chiusura giornaliera a cui appartiene lo scontrino (la giornata lavorativa), oppure, se lo chiedi, l'orario dello scontrino stesso. Includendo le righe vendute, dà le vendite per articolo. Gli scontrini sono documenti fiscali: il connettore non può modificarli né annullarli.
Limite di richieste: 60 richieste al minuto per Account Token; dopo un 429 aspetta un minuto.
Errori comuni: 401 Sorry, but your token is invalid.: il token è sbagliato o è stato revocato; ripeti la procedura di approvazione. 403: è stato incollato un Developer Token al posto dell'Account Token. 429: più di 60 richieste in un minuto. 400 o 422: un campo non è valido e il messaggio lo indica, per esempio un articolo senza aliquota IVA.
Il connettore non crea né annulla scontrini (storno), non stampa e non gestisce buoni, sconti, modifica dei tavoli, terminali di pagamento, webhook o esportazioni contabili.
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
ready2order. - 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 |
|---|---|
ready2order_list_products | List the products (Artikel) of the ready2order register with price, VAT, item number, barcode, stock level and product group |
ready2order_get_product | Get one product by id with all its settings (price, VAT, stock, unit, flags), optionally with its group, variations and price levels |
ready2order_create_product | Create a product in the register, with name and price, VAT (product_vat or product_vat_id), product group and optional item number… |
ready2order_update_product | Change fields of an existing product: name, price, VAT, product group, item number, barcode, description, active or sold-out flag, unit and… |
ready2order_get_product_stock | Get the current stock, reorder level (Meldebestand), safety stock and unit of one product by its id |
ready2order_get_stock_by_item_number | Get the current stock, reorder level and safety stock of a product looked up by its item number (Artikelnummer) instead of its id |
ready2order_update_product_stock | Change a product's stock: set an absolute count after an inventory (product_stock) or add and subtract a quantity (product_stockDelta, e.g.… |
ready2order_delete_product | Delete a product from the register |
ready2order_list_product_groups | List the product groups (Produktgruppen, the categories of the POS), with id, name, parent group and type |
ready2order_list_group_products | List all products that belong to one product group (category), with their prices and settings |
ready2order_create_product_group | Create a product group (category) in the register, optionally below a parent group |
ready2order_list_bills | List the bills (Belege, receipts and invoices) of a period with number, date, total, net, VAT, tip, customer and payment state; the main… |
ready2order_get_bill | Get one bill by id with its lines, payments, totals, VAT breakdown and customer |
ready2order_get_bill_pdf | Get a temporary download link for the PDF of a bill, e.g. to send a copy to a customer |
ready2order_list_open_orders | List the open orders of the register (items ordered but not yet billed, e.g. on a restaurant table), optionally per table or product and… |
ready2order_list_customers | List the customers stored in the register with number, name, company, VAT id, group, notes and addresses |
ready2order_get_customer | Get one customer by id with contact data, VAT id, group and addresses |
ready2order_create_customer | Create a customer in the register, e.g. for invoices to a company |
ready2order_update_customer | Change an existing customer's contact data, VAT id, group or notes |
ready2order_list_customer_groups | List the customer groups (Kundengruppen) with their ids, needed to create a customer |
ready2order_list_payment_methods | List the payment methods configured in the register (cash, card, voucher and so on) with their ids and types |
ready2order_list_vat_rates | List the VAT rates configured for the account with id, rate and code, for creating products with product_vat_id |
ready2order_get_daily_report_status | Tell whether a daily report (Tagesabschluss period) is currently open in the register |
ready2order_list_users | List the register's users (cashiers and admins) with their ids and names |
ready2order_list_tables | List the tables of the register (gastronomy floor plan), with id, name or number, description, sort order, table area and whether the table… |
ready2order_list_table_areas | List the table areas (rooms or zones such as inside, terrace or bar) with id, name, short name, sort order and whether they are active |
Esempi di prompt
- "Quanto abbiamo incassato ieri e quali sono stati i 10 articoli più venduti?"
- "Quali articoli del gruppo Bevande sono sotto il livello di riordino?"
- "Sono arrivate 24 bottiglie del codice articolo 1002: aggiungile alla giacenza."
- "Porta il prezzo del cappuccino a 4,20 e mostrami la modifica prima di salvarla."
- "Recuperami il PDF dell'ultimo scontrino intestato a Müller GmbH."
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?