In breve
Gestione ristoranti iiko e Syrve attraverso l'iikoCloud API (Syrve Cloud API): organizzazioni e gruppi di terminali, menu e menu esterni, liste di stop, ordini di consegna e al tavolo, prenotazioni, corrieri, tipi di ordini e pagamenti, sconti e clienti fedeli. Accesso API dal back office web.
Configurazione guidata
Collega iiko a Claude in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega iiko con la configurazione guidata e aggiungi il tuo URL MCP a Claude. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
AnythingMCP è nella directory dei connettori di Claude: aggiungilo a Claude con un clic (si apre in una nuova scheda), poi accedi e scegli quali server MCP può usare Claude.
Prova a chiedere
Prompt di esempio per iiko
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.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → iiko, incolla il login API e scegli iiko o Syrve come host API e i percorsi di fedeltà, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
iiko + Claude
Gestione ristoranti iiko e Syrve attraverso l'iikoCloud API (Syrve Cloud API): organizzazioni e gruppi di terminali, menu e menu esterni, liste di stop, ordini di consegna e al tavolo, prenotazioni, corrieri, tipi di ordini e pagamenti, sconti e clienti fedeli. Accesso API dal back office web.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 5 minuti.
- Accedi al back office web (iikoWeb per iiko, Syrve Web / Syrve App per Syrve) come amministratore e apri le impostazioni API cloud (Integrazioni, chiavi API; chiamate Impostazioni API o Impostazioni Live API nelle versioni più vecchie).
- Crea un login API (chiave API) per questo connettore: dagli un nome, scegli le organizzazioni a cui può accedere e una data di scadenza (massimo 2 anni). Copia la chiave; una nuova chiave è lunga 36 caratteri e può essere mostrata solo una volta.
- Incollala in
IIKO_API_LOGIN. Scegli il tuo prodotto due volte: l'host API inIIKO_API_HOSTe lo stesso prodotto inIIKO_LOYALTY_API(iiko e Syrve nominano i percorsi di fedeltà in modo diverso). - Facoltativo: inserisci l'id del tuo ristorante principale in
IIKO_ORGANIZATION_IDdopo la prima chiamataiiko_list_organizations, in modo che gli strumenti che richiedono un'organizzazione possano ometterlo.
Il connettore scambia il login API a /api/1/access_token per un token bearer che dura 1 ora e lo rinnova automaticamente. iiko segna questa chiamata di login come deprecata in favore di /api/v2/access_token, che necessita anche di un'app registrata nel portale sviluppatori; se iiko disattiva la vecchia chiamata, il controllo della configurazione riporta un login fallito.
Da dove iniziare: iiko_list_organizations fornisce gli id delle organizzazioni necessari a ogni altro strumento. iiko_list_terminal_groups elenca le installazioni POS di un'organizzazione e iiko_check_terminal_groups_alive indica se sono online.
Menu: iiko_list_external_menus e iiko_get_external_menu leggono i menu preparati per i canali di consegna, con i prezzi per organizzazione. iiko_get_nomenclature legge il menu completo del back office (grande; documentato per Syrve, non più presente nel riferimento iiko, quindi preferisci il menu esterno su iiko). iiko_get_stop_lists mostra cosa è esaurito per gruppo di terminali; iiko_add_to_stop_list e iiko_remove_from_stop_list lo modificano e sono installati disattivati (richiedono un login API con il diritto extra per la lista di stop).
Ordini di consegna: iiko_list_deliveries_by_date_and_status (la panoramica giornaliera), iiko_search_deliveries (ricerca testuale e filtro problemi), iiko_list_deliveries_by_phone, iiko_get_deliveries_by_id. Questi sono garantiti per gli ultimi 7 giorni; iiko_list_delivery_history_by_phone risale a 90 giorni. Stati: Non confermato, InPreparazione, ProntoPerPreparazione, PreparazioneIniziata, PreparazioneCompletata, InAttesa, InViaggio, Consegnato, Chiuso, Annullato. iiko_create_delivery e iiko_cancel_delivery sono installati disattivati: un ordine creato raggiunge la cucina e un'annullamento non può essere annullato.
Ordini al tavolo e prenotazioni: iiko_get_table_orders_by_id e iiko_list_table_orders_by_table leggono gli ordini per consumazione. Per le prenotazioni, iiko_list_reserve_terminal_groups, poi iiko_list_restaurant_sections (sale e tavoli), iiko_list_reserves (cosa è prenotato da un certo orario) e iiko_get_reserves_by_id (i dettagli). Il connettore non crea prenotazioni.
Dizionari: iiko_list_order_types, iiko_list_payment_types, iiko_list_discounts, iiko_list_cancel_causes, iiko_list_couriers. Cambiano raramente: leggili una volta per conversazione, non per ordine.
Fedeltà: iiko_get_customer trova un ospite tramite telefono, email o numero di carta e mostra i saldi del portafoglio; iiko_list_customer_transactions elenca i movimenti bonus; iiko_list_customer_categories e iiko_list_loyalty_programs descrivono il programma. iiko_create_or_update_customer salva i dati anagrafici dell'ospite. Il connettore non ricarica, non trattiene e non annulla un portafoglio e non registra pagamenti.
Comandi: creare o annullare una consegna e modificare una risposta della lista di stop in una sola volta con un correlationId; il POS esegue il comando successivamente. Leggi il risultato con iiko_get_command_status (InCorso, Successo, Errore).
Formati: gli id sono UUID. Le date sono yyyy-MM-dd HH:mm:ss.fff senza fuso orario: gli orari di ordine e prenotazione sono locali al terminale (vedi il fuso orario in iiko_list_terminal_groups), le date dei report di fedeltà sono UTC. Le somme sono nella valuta dell'organizzazione. Quasi ogni chiamata è un POST con un corpo JSON, anche le letture.
Limiti: iiko raggruppa i metodi (dizionari, menu, liste di stop, lettura ordini e altri) e limita ogni gruppo per intervallo di tempo, di solito un minuto; oltre il limite ogni chiamata di quel gruppo risponde 429 fino alla fine dell'intervallo. I limiti per i metodi di ordini e liste di stop crescono con il numero di ristoranti. Richiedi più organizzazioni in una sola chiamata invece di una chiamata ciascuna, memorizza in cache dizionari e menu, e non interrogare singoli ordini. Ripetere richieste identiche o fallite in blocco può bloccare il login API.
Errori: una risposta di errore ha errorDescription e spesso error (un codice) più un correlationId da citare al supporto iiko. 401 significa che il token o il login API è stato rifiutato, 400 indica il campo errato, 408 significa che il POS non ha risposto in tempo (il ristorante potrebbe essere offline).
Passo 2 — Installa l'adattatore
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
Passo 3 — Aggiungi il connettore in Claude
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 mostriYOUR_SERVER_ID.
Percorso consigliato: funziona su claude.ai web senza modificare alcun file di configurazione.
- In Claude apri Plugins (in alcuni piani ancora Customize) → Connectors.
- Clicca + Add e poi Add custom connector.
- Inserisci un nome, ad esempio
iiko, e l'URL del server MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Continue, mantieni le impostazioni rilevate e clicca di nuovo Continue. - Scegli Sign in now, clicca Add e accedi ad AnythingMCP (OAuth) per consentire l'accesso.
Tutti gli strumenti qui sotto appariranno nella tua chat: inizia a digitare i prompt.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
iiko_list_organizations | Elenca le organizzazioni (ristoranti) a cui il login API può accedere: id, nome e codice, più paese, indirizzo, coordinate, impostazioni del fuso orario… |
iiko_list_terminal_groups | Elenca i gruppi di terminali (le installazioni POS a cui vengono inviati gli ordini) di una o più organizzazioni: per organizzazione i gruppi con id… |
iiko_check_terminal_groups_alive | Controlla se i gruppi di terminali sono online in questo momento: per gruppo di terminali isAlive vero o falso. Usalo prima di dire a qualcuno che un ristorante… |
iiko_get_nomenclature | Legge il menu completo (nomenclatura) di un'organizzazione come esportato dal back office: gruppi, categorie di prodotto, prodotti (piatti… |
iiko_list_external_menus | Elenca i menu esterni (i menu preparati per i siti e le app di consegna nel back office web) e le categorie di prezzo dell'account: id… |
iiko_get_external_menu | Legge un menu esterno con le sue categorie di elementi, articoli, dimensioni, prezzi per organizzazione, gruppi di modificatori, allergeni, valori nutrizionali… |
iiko_get_stop_lists | Legge le liste di stop (articoli esauriti): per organizzazione e gruppo di terminali gli articoli con productId, sizeId, sku, saldo (rimanente… |
iiko_list_order_types | Elenca i tipi di ordine per organizzazione: id, nome, orderServiceType (Comune per ordini al tavolo, DeliveryByCourier, DeliveryByClient per… |
iiko_list_payment_types | Elenca i tipi di pagamento: id, codice, nome, paymentTypeKind (Contante, Carta, Esterno, CartaFedeltà e altri), paymentProcessingType, il terminale… |
iiko_list_discounts | Elenca gli sconti e i supplementi impostati nel back office per organizzazione: id, nome, percentuale o somma fissa, modalità, somma minima dell'ordine… |
iiko_list_cancel_causes | Elenca le cause di cancellazione della consegna: id, nome e isDeleted. È necessario un id per annullare una consegna. Solo in lettura; memorizza la risposta |
iiko_list_deliveries_by_date_and_status | Elenca gli ordini di consegna e ritiro per data di consegna e stato: per organizzazione gli ordini con id, posId, creationStatus e l'ordine… |
iiko_list_deliveries_by_phone | Trova gli ordini di consegna recenti di un numero di telefono (garantito per gli ultimi 7 giorni): gli stessi dettagli dell'ordine come… |
iiko_list_delivery_history_by_phone | Trova ordini di consegna più vecchi di un numero di telefono nella cronologia degli ordini (conservati per 90 giorni): gli stessi dettagli dell'ordine, raggruppati per organizzazione, al massimo… |
iiko_search_deliveries | Cerca ordini di consegna per testo (ricerca per prefisso su numero d'ordine, nome cliente, telefono o indirizzo) con filtri per data, stato, tipo di servizio… |
iiko_get_deliveries_by_id | Legge fino a 200 ordini di consegna per id: creationStatus (Successo, InCorso, Errore con errorInfo) e l'ordine completo con stato, cliente… |
iiko_get_table_orders_by_id | Legge ordini al tavolo (per consumazione) per id: creationStatus e l'ordine con tableIds, stato (Nuovo, Fattura, Chiuso, Cancellato), cameriere, cliente… |
iiko_list_table_orders_by_table | Elenca gli ordini al tavolo (per consumazione) di tavoli specifici, eventualmente per stato e data di creazione: gli stessi dettagli di iiko_get_table_orders_by_id.… |
iiko_list_reserve_terminal_groups | Elenca i gruppi di terminali delle organizzazioni date che accettano prenotazioni di tavoli e banchetti: id, nome, indirizzo e fuso orario, e il… |
iiko_list_restaurant_sections | Elenca le sezioni del ristorante (sale) dei gruppi di terminali che accettano prenotazioni, con i loro tavoli: id e nome della sezione, e per tavolo id… |
iiko_list_reserves | Elenca le prenotazioni e i banchetti prenotati nelle sezioni del ristorante da un orario di inizio: id, tableIds, estimatedStartTime, durationInMinutes e… |
iiko_get_reserves_by_id | Legge prenotazioni e banchetti per id: creationStatus, isDeleted e la prenotazione con cliente, telefono, numero di ospiti, tavoli, orario di inizio stimato… |
iiko_list_couriers | Elenca i dipendenti che sono corrieri di consegna, per organizzazione: id, nome, cognome, nome visualizzato, codice e isDeleted. Solo in lettura |
iiko_get_customer | Cerca un cliente fedeltà (ospite) tramite telefono, email, numero di carta, tracciato della carta o id: id, nome, cognome, telefono, email, compleanno, sesso… |
iiko_list_customer_categories | Elenca le categorie di clienti (ospiti) del programma di fedeltà di un'organizzazione: id, nome, isActive e isDefaultForNewGuests. Solo in lettura |
iiko_list_loyalty_programs | Elenca i programmi di fedeltà di un'organizzazione: id, nome, descrizione, programType, isActive, date di validità, walletId, e il marketing… |
iiko_list_customer_transactions | Elenca le transazioni di fedeltà di un cliente in un periodo (accrediti e addebiti bonus, ricariche portafoglio, coupon): tipo, typeName, somma… |
iiko_create_or_update_customer | Crea un cliente fedeltà o aggiorna uno trovato per id, telefono o carta: nome, telefono, email, compleanno, sesso, commento, stato di consenso e… |
iiko_get_command_status | Controlla il risultato di un comando (creazione o cancellazione di una consegna, modifica di una lista di stop): stato InCorso, Successo o Errore con… |
iiko_create_delivery | Crea un ordine di consegna o ritiro nel POS. È un comando: la risposta porta un correlationId e orderInfo con creationStatus… |
iiko_cancel_delivery | Annulla un ordine di consegna, con una causa di annullamento. Non può essere annullato e gli articoli già stampati vengono scritti a bilancio. È un comando: controlla il… |
iiko_add_to_stop_list | Aggiungi prodotti alla lista di stop di un gruppo di terminali, con la quantità rimanente (0 per esaurito). Gli ospiti non possono più ordinare un prodotto esaurito… |
iiko_remove_from_stop_list | Rimuovi prodotti dalla lista di stop di un gruppo di terminali, affinché possano essere ordinati di nuovo. Richiede un login API con il diritto extra di modificare la lista di stop… |
Esempi di prompt
- "Quali ordini di consegna di oggi non sono ancora in viaggio, per ristorante?"
- "Cosa c'è attualmente nella lista di stop in ogni gruppo di terminali?"
- "Tutti i nostri gruppi di terminali POS sono online?"
- "Mostra le prenotazioni per stasera dalle 18:00 nel ristorante principale, con sala e tavolo."
- "Trova l'ospite con telefono 79161234567 e mostra il saldo bonus e le ultime transazioni."
FAQ
Funziona sia con Claude Code che con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Da dove proviene il login API? Un amministratore accede al back office web (iikoWeb per iiko, Syrve Web per Syrve) e apre Integrazioni, chiavi API (Impostazioni API nelle versioni più vecchie). Crea un login API per il connettore, scegli le organizzazioni a cui può accedere e una data di scadenza di massimo 2 anni, e copia la chiave. Poi scegli il tuo prodotto per l'host API e i percorsi di fedeltà: iiko utilizza api-ru.iiko.services, Syrve utilizza api-eu.syrve.live, e una chiave funziona solo sull'host del proprio prodotto.
Cosa copre? Organizzazioni e gruppi di terminali con il loro stato online, i menu esterni con i prezzi e il menu del back office, liste di stop, ordini di consegna per data, stato, telefono o ricerca testuale, ordini al tavolo, prenotazioni con sale e tavoli, corrieri, tipi di ordini e pagamenti, sconti e cause di cancellazione, e clienti fedeli con saldi del portafoglio e transazioni bonus. Salva i dati anagrafici degli ospiti, ma non ricarica, non trattiene e non annulla un portafoglio, non registra pagamenti e non crea prenotazioni.
Quali strumenti sono installati disattivati? iiko_create_delivery, iiko_cancel_delivery, iiko_add_to_stop_list e iiko_remove_from_stop_list. Un ordine creato va direttamente in cucina e un'annullamento non può essere annullato, e gli strumenti della lista di stop richiedono un login API con il diritto extra per la lista di stop. Attivali nella pagina del connettore solo se l'AI deve usarli.
Passi successivi
- Pagina di atterraggio del connettore
- Collegati a ChatGPT
- Collegati a Cursor
- Collegati a Gemini
- Collegati a Meta Muse
- Collegati a Microsoft Copilot
Questa guida ti è stata utile?