Guida al connettore12 minuti di lettura33 tool MCP7 lingue

Collegare iiko MCP a ChatGPT: ordini e menu

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.

HCA cura del team HelpCodeAggiornato 12 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

iiko

iiko

iiko and Syrve restaurant management through the iikoCloud API (Syrve Cloud API): organizations and terminal groups, menu and external menus, stop lists, delivery and table orders, reservations, couriers, order and payment types, discounts and loyalty customers. API login from the web back office.

tool

33

Regione

INTL

Categoria

E-commerce

Autenticazione

Sign-in token

Env vars richieste

IIKO_API_HOSTIIKO_LOYALTY_APIIIKO_API_LOGIN
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

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 ChatGPT in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega iiko con la configurazione guidata e aggiungi il tuo URL MCP a ChatGPT. Senza codice e senza server da gestire.

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Il plugin AnythingMCP nella directory di ChatGPT risponde, su AnythingMCP Cloud, a domande sui database aziendali (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, in sola lettura): apri la scheda (si apre in una nuova scheda) e clicca Install plugin. Tutti gli altri connettori si aggiungono a ChatGPT come server MCP personalizzato con l'URL MCP del tuo AnythingMCP.

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.

iiko · live via MCP
Condividi
Opus 4.7

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 + ChatGPT

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.

  1. 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).
  2. 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.
  3. Incollala in IIKO_API_LOGIN. Scegli il tuo prodotto due volte: l'host API in IIKO_API_HOST e lo stesso prodotto in IIKO_LOYALTY_API (iiko e Syrve nominano i percorsi di fedeltà in modo diverso).
  4. Facoltativo: inserisci l'id del tuo ristorante principale in IIKO_ORGANIZATION_ID dopo la prima chiamata iiko_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 ChatGPT

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.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

  1. Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
  2. Inserisci un nome, ad esempio Name: iiko.
  3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
  4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
  5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

Strumenti disponibili

StrumentoCosa fa
iiko_list_organizationsElenca 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_groupsElenca 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_aliveControlla 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_nomenclatureLegge il menu completo (nomenclatura) di un'organizzazione come esportato dal back office: gruppi, categorie di prodotto, prodotti (piatti…
iiko_list_external_menusElenca 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_menuLegge un menu esterno con le sue categorie di elementi, articoli, dimensioni, prezzi per organizzazione, gruppi di modificatori, allergeni, valori nutrizionali…
iiko_get_stop_listsLegge le liste di stop (articoli esauriti): per organizzazione e gruppo di terminali gli articoli con productId, sizeId, sku, saldo (rimanente…
iiko_list_order_typesElenca i tipi di ordine per organizzazione: id, nome, orderServiceType (Comune per ordini al tavolo, DeliveryByCourier, DeliveryByClient per…
iiko_list_payment_typesElenca i tipi di pagamento: id, codice, nome, paymentTypeKind (Contante, Carta, Esterno, CartaFedeltà e altri), paymentProcessingType, il terminale…
iiko_list_discountsElenca 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_causesElenca 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_statusElenca 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_phoneTrova 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_phoneTrova 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_deliveriesCerca 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_idLegge 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_idLegge 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_tableElenca 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_groupsElenca 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_sectionsElenca 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_reservesElenca le prenotazioni e i banchetti prenotati nelle sezioni del ristorante da un orario di inizio: id, tableIds, estimatedStartTime, durationInMinutes e…
iiko_get_reserves_by_idLegge prenotazioni e banchetti per id: creationStatus, isDeleted e la prenotazione con cliente, telefono, numero di ospiti, tavoli, orario di inizio stimato…
iiko_list_couriersElenca i dipendenti che sono corrieri di consegna, per organizzazione: id, nome, cognome, nome visualizzato, codice e isDeleted. Solo in lettura
iiko_get_customerCerca 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_categoriesElenca le categorie di clienti (ospiti) del programma di fedeltà di un'organizzazione: id, nome, isActive e isDefaultForNewGuests. Solo in lettura
iiko_list_loyalty_programsElenca i programmi di fedeltà di un'organizzazione: id, nome, descrizione, programType, isActive, date di validità, walletId, e il marketing…
iiko_list_customer_transactionsElenca le transazioni di fedeltà di un cliente in un periodo (accrediti e addebiti bonus, ricariche portafoglio, coupon): tipo, typeName, somma…
iiko_create_or_update_customerCrea 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_statusControlla 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_deliveryCrea un ordine di consegna o ritiro nel POS. È un comando: la risposta porta un correlationId e orderInfo con creationStatus…
iiko_cancel_deliveryAnnulla 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_listAggiungi 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_listRimuovi 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

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.

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Passi successivi

Prossimi passi

Questa guida ti è stata utile?

Collega iiko a ChatGPT in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega iiko con la configurazione guidata e aggiungi il tuo URL MCP a ChatGPT. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare iiko MCP a Claude: ordini e menu

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.

Connettori

Collegare iiko MCP a Microsoft Copilot

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.

Connettori

Collegare iiko MCP a Cursor: ordini e menu

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.

Connettori

Collegare iiko MCP a Gemini CLI: ordini e menu

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.

Connettori

Collegare iiko MCP a Meta Muse: ordini e menu

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.

Connettori

iiko MCP Server: menu, ordini e prenotazioni

Gestione dei ristoranti iiko e Syrve tramite 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 ordine e pagamento, sconti e clienti fedeli. Accesso API dal back office web.