Zusammenfassung
iiko und Syrve Restaurantmanagement über die iikoCloud API (Syrve Cloud API): Organisationen und Terminalgruppen, Menüs und externe Menüs, Stop-Listen, Liefer- und Tischbestellungen, Reservierungen, Kuriere, Bestell- und Zahlungsarten, Rabatte und Treuekunden. API-Login aus dem Web-Backoffice.
Geführte Einrichtung
iiko in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde iiko in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für iiko
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → iiko, füge das API-Login ein und wähle iiko oder Syrve als API-Host und die Treuepfade, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
iiko
iiko und Syrve Restaurantmanagement über die iikoCloud API (Syrve Cloud API): Organisationen und Terminalgruppen, Menüs und externe Menüs, Stop-Listen, Liefer- und Tischbestellungen, Reservierungen, Kuriere, Bestell- und Zahlungsarten, Rabatte und Treuekunden. API-Login aus dem Web-Backoffice.
Einrichtung
Die Einrichtung dauert etwa 5 Minuten.
- Melde dich als Administrator im Web-Backoffice (iikoWeb für iiko, Syrve Web / Syrve App für Syrve) an und öffne die Cloud-API-Einstellungen (Integrationen, API-Schlüssel; in älteren Versionen als API-Einstellungen oder Live-API-Einstellungen bezeichnet).
- Erstelle ein API-Login (API-Schlüssel) für diesen Connector: gib ihm einen Namen, wähle die Organisationen aus, auf die er zugreifen darf, und ein Ablaufdatum (maximal 2 Jahre). Kopiere den Schlüssel; ein neuer Schlüssel ist 36 Zeichen lang und wird nur einmal angezeigt.
- Füge ihn in
IIKO_API_LOGINein. Wähle dein Produkt zweimal: den API-Host inIIKO_API_HOSTund dasselbe Produkt inIIKO_LOYALTY_API(iiko und Syrve benennen die Treuepfade unterschiedlich). - Optional: Gib die ID deines Hauptrestaurants in
IIKO_ORGANIZATION_IDnach dem ersteniiko_list_organizations-Aufruf ein, damit Tools, die eine Organisation benötigen, diese weglassen können.
Der Connector tauscht das API-Login unter /api/1/access_token gegen ein Bearer-Token aus, das 1 Stunde gültig ist und sich selbst erneuert. iiko markiert diesen Login-Aufruf als veraltet zugunsten von /api/v2/access_token, das ebenfalls eine im Entwicklerportal registrierte App benötigt; wenn iiko den alten Aufruf deaktiviert, meldet die Einrichtungskontrolle ein fehlgeschlagenes Login.
Wo du anfangen kannst: iiko_list_organizations gibt die Organisations-IDs zurück, die jedes andere Tool benötigt. iiko_list_terminal_groups listet die POS-Installationen einer Organisation auf und iiko_check_terminal_groups_alive zeigt an, ob sie online sind.
Menü: iiko_list_external_menus und iiko_get_external_menu lesen die für Lieferkanäle vorbereiteten Menüs mit Preisen pro Organisation. iiko_get_nomenclature liest das vollständige Backoffice-Menü (groß; dokumentiert für Syrve, nicht mehr im iiko-Referenzhandbuch, daher bevorzuge das externe Menü bei iiko). iiko_get_stop_lists zeigt, was pro Terminalgruppe nicht vorrätig ist; iiko_add_to_stop_list und iiko_remove_from_stop_list ändern dies und sind standardmäßig deaktiviert (sie benötigen ein API-Login mit dem zusätzlichen Recht für Stop-Listen).
Lieferbestellungen: iiko_list_deliveries_by_date_and_status (die tägliche Übersicht), iiko_search_deliveries (Textsuche und Problemfilter), iiko_list_deliveries_by_phone, iiko_get_deliveries_by_id. Diese sind für die letzten 7 Tage garantiert; iiko_list_delivery_history_by_phone reicht 90 Tage zurück. Status: Unbestätigt, WarteAufKochen, BereitFürKochen, KochenGestartet, KochenAbgeschlossen, Wartend, UnterWeg, Geliefert, Geschlossen, Storniert. iiko_create_delivery und iiko_cancel_delivery sind standardmäßig deaktiviert: eine erstellte Bestellung gelangt in die Küche und eine Stornierung kann nicht rückgängig gemacht werden.
Tischbestellungen und Reservierungen: iiko_get_table_orders_by_id und iiko_list_table_orders_by_table lesen Bestellungen vor Ort. Für Reservierungen, iiko_list_reserve_terminal_groups, dann iiko_list_restaurant_sections (Säle und Tische), iiko_list_reserves (was ab einem bestimmten Zeitpunkt gebucht ist) und iiko_get_reserves_by_id (die Details). Der Connector erstellt keine Reservierungen.
Wörterbücher: iiko_list_order_types, iiko_list_payment_types, iiko_list_discounts, iiko_list_cancel_causes, iiko_list_couriers. Diese ändern sich selten: lies sie einmal pro Sitzung, nicht pro Bestellung.
Treue: iiko_get_customer findet einen Gast per Telefon, E-Mail oder Karte und zeigt die Wallet-Bilanzen an; iiko_list_customer_transactions listet die Bonusbewegungen auf; iiko_list_customer_categories und iiko_list_loyalty_programs beschreiben das Programm. iiko_create_or_update_customer speichert die Stammdaten des Gastes. Der Connector lädt niemals auf, hält oder schreibt ein Wallet ab und erfasst keine Zahlungen.
Befehle: Das Erstellen oder Stornieren einer Lieferung und das Ändern einer Stop-Liste antworten sofort mit einer correlationId; das POS führt den Befehl danach aus. Lies das Ergebnis mit iiko_get_command_status (InProgress, Success, Error).
Formate: IDs sind UUIDs. Daten sind im Format yyyy-MM-dd HH:mm:ss.fff ohne Zeitzone: Bestell- und Reservierungszeiten sind lokal zum Terminal (siehe die Zeitzone in iiko_list_terminal_groups), Treueberichtsdaten sind UTC. Summen sind in der Währung der Organisation. Fast jeder Aufruf ist ein POST mit einem JSON-Body, auch die Lesevorgänge.
Limits: iiko gruppiert die Methoden (Wörterbücher, Menü, Stop-Listen, Bestellabfragen und andere) und limitiert jede Gruppe pro Zeitfenster, normalerweise eine Minute; über dem Limit antwortet jeder Aufruf dieser Gruppe mit 429, bis das Zeitfenster endet. Limits für Bestell- und Stop-Listen-Methoden wachsen mit der Anzahl der Restaurants. Frage mehrere Organisationen in einem Aufruf an, anstatt jeden Aufruf einzeln zu machen, cachiere Wörterbücher und Menüs und pollere keine einzelnen Bestellungen. Das wiederholte Senden identischer oder fehlgeschlagener Anfragen in großen Mengen kann das API-Login blockieren.
Fehler: Eine Fehlerantwort hat errorDescription und oft error (einen Code) sowie eine correlationId, die du dem iiko-Support nennen kannst. 401 bedeutet, dass das Token oder das API-Login abgelehnt wurde, 400 nennt das falsche Feld, 408 bedeutet, dass das POS nicht rechtzeitig geantwortet hat (das Restaurant könnte offline sein).
Voraussetzungen: IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN
Installiere den Connector lokal
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
Öffne http://localhost:3000/connectors/store, wähle iiko und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
iiko_list_organizations | Listet die Organisationen (Restaurants) auf, die das API-Login erreichen kann: ID, Name und Code sowie Land, Adresse, Koordinaten, Zeitzoneneinstellungen… |
iiko_list_terminal_groups | Listet die Terminalgruppen (die POS-Installationen, an die Bestellungen gesendet werden) von einer oder mehreren Organisationen: pro Organisation die Gruppen mit ID… |
iiko_check_terminal_groups_alive | Überprüft, ob Terminalgruppen gerade online sind: pro Terminalgruppe ist isAlive true oder false. Verwende es, bevor du jemandem sagst, dass ein Restaurant… |
iiko_get_nomenclature | Liest das vollständige Menü (Nomenklatur) einer Organisation, wie es aus dem Backoffice exportiert wurde: Gruppen, Produktkategorien, Produkte (Gerichte… |
iiko_list_external_menus | Listet die externen Menüs (die für Lieferseiten und Apps im Web-Backoffice vorbereiteten Menüs) und die Preiskategorien des Kontos auf: ID… |
iiko_get_external_menu | Liest ein externes Menü mit seinen Artikel-Kategorien, Artikeln, Größen, Preisen pro Organisation, Modifikatorgruppen, Allergenen, Nährwerten… |
iiko_get_stop_lists | Liest die Stop-Listen (nicht vorrätige Artikel): pro Organisation und Terminalgruppe die Artikel mit productId, sizeId, sku, balance (verbleibend… |
iiko_list_order_types | Listet die Bestellarten pro Organisation auf: ID, Name, orderServiceType (Common für Tischbestellungen, DeliveryByCourier, DeliveryByClient für… |
iiko_list_payment_types | Listet die Zahlungsarten auf: ID, Code, Name, paymentTypeKind (Bargeld, Karte, extern, Treuekarte und andere), paymentProcessingType, das Terminal… |
iiko_list_discounts | Listet die im Backoffice pro Organisation eingerichteten Rabatte und Zuschläge auf: ID, Name, Prozent oder Festbetrag, Modus, Mindestbestellsumme… |
iiko_list_cancel_causes | Listet die Gründe für die Stornierung von Lieferungen auf: ID, Name und isDeleted. Eine ID wird benötigt, um eine Lieferung zu stornieren. Nur lesbar; cachiere die Antwort |
iiko_list_deliveries_by_date_and_status | Listet Liefer- und Abholbestellungen nach Lieferdatum und Status auf: pro Organisation die Bestellungen mit ID, posId, creationStatus und der Bestellung… |
iiko_list_deliveries_by_phone | Findet die aktuellen Lieferbestellungen einer Telefonnummer (garantiert für die letzten 7 Tage): dieselben Bestelldetails wie… |
iiko_list_delivery_history_by_phone | Findet ältere Lieferbestellungen einer Telefonnummer in der Bestellhistorie (90 Tage gespeichert): dieselben Bestelldetails, gruppiert nach Organisation, maximal… |
iiko_search_deliveries | Durchsucht Lieferbestellungen nach Text (Präfixsuche nach Bestellnummer, Kundenname, Telefon oder Adresse) mit Filtern für Datum, Status, Serviceart… |
iiko_get_deliveries_by_id | Liest bis zu 200 Lieferbestellungen nach ID: creationStatus (Success, InProgress, Error mit errorInfo) und die vollständige Bestellung mit Status, Kunde… |
iiko_get_table_orders_by_id | Liest Tischbestellungen (vor Ort) nach ID: creationStatus und die Bestellung mit tableIds, Status (Neu, Rechnung, Geschlossen, Gelöscht), Kellner, Kunde… |
iiko_list_table_orders_by_table | Listet die Tischbestellungen (vor Ort) von bestimmten Tischen auf, optional nach Status und Erstellungsdatum: dieselben Details wie iiko_get_table_orders_by_id.… |
iiko_list_reserve_terminal_groups | Listet die Terminalgruppen der angegebenen Organisationen auf, die Tischreservierungen und Bankette akzeptieren: ID, Name, Adresse und Zeitzone sowie die… |
iiko_list_restaurant_sections | Listet die Restaurantabschnitte (Säle) von Terminalgruppen auf, die Reservierungen akzeptieren, mit ihren Tischen: Abschnitts-ID und Name sowie pro Tisch-ID… |
iiko_list_reserves | Listet die Reservierungen und Bankette auf, die in Restaurantabschnitten ab einem Startzeitpunkt gebucht sind: ID, tableIds, estimatedStartTime, durationInMinutes und… |
iiko_get_reserves_by_id | Liest Reservierungen und Bankette nach ID: creationStatus, isDeleted und die Reserve mit Kunde, Telefon, Gästeanzahl, Tischen, geschätztem Start… |
iiko_list_couriers | Listet die Mitarbeiter, die Lieferkuriere sind, pro Organisation auf: ID, Vorname, Nachname, Anzeigename, Code und isDeleted. Nur lesbar |
iiko_get_customer | Sucht einen Treuekunden (Gast) per Telefon, E-Mail, Kartennummer, Kartenbahn oder ID: ID, Name, Nachname, Telefon, E-Mail, Geburtstag, Geschlecht… |
iiko_list_customer_categories | Listet die Kunden (Gast) Kategorien des Treueprogramms einer Organisation auf: ID, Name, isActive und isDefaultForNewGuests. Nur lesbar |
iiko_list_loyalty_programs | Listet die Treueprogramme einer Organisation auf: ID, Name, Beschreibung, programType, isActive, Gültigkeitsdaten, walletId und das Marketing… |
iiko_list_customer_transactions | Listet die Treue-Transaktionen eines Kunden in einem Zeitraum (Bonusgutschriften und -abschreibungen, Wallet-Auffüllungen, Gutscheine): Typ, Typname, Summe… |
iiko_create_or_update_customer | Erstellt einen Treuekunden oder aktualisiert einen, der per ID, Telefon oder Karte gefunden wurde: Name, Telefon, E-Mail, Geburtstag, Geschlecht, Kommentar, Einwilligungsstatus und… |
iiko_get_command_status | Überprüft das Ergebnis eines Befehls (Erstellen oder Stornieren einer Lieferung, Ändern einer Stop-Liste): Zustand InProgress, Success oder Error mit… |
iiko_create_delivery | Erstellt eine Liefer- oder Abholbestellung im POS. Es ist ein Befehl: die Antwort enthält eine correlationId und orderInfo mit creationStatus… |
iiko_cancel_delivery | Storniert eine Lieferbestellung mit einem Stornierungsgrund. Sie kann nicht rückgängig gemacht werden und bereits gedruckte Artikel werden abgeschrieben. Es ist ein Befehl: überprüfe die… |
iiko_add_to_stop_list | Setzt Produkte auf die Stop-Liste einer Terminalgruppe, mit der verbleibenden Menge (0 für ausverkauft). Gäste können ein ausverkauftes Produkt nicht mehr bestellen… |
iiko_remove_from_stop_list | Nimmt Produkte von der Stop-Liste einer Terminalgruppe, damit sie wieder bestellt werden können. Benötigt ein API-Login mit dem zusätzlichen Recht, die Stop-Liste zu ändern… |
Beispielaufforderungen
- "Welche Lieferbestellungen von heute sind noch nicht unterwegs, pro Restaurant?"
- "Was steht gerade auf der Stop-Liste jeder Terminalgruppe?"
- "Sind alle unsere POS-Terminalgruppen online?"
- "Zeige die Reservierungen für heute Abend ab 18:00 im Hauptrestaurant, mit Saal und Tisch."
- "Finde den Gast mit der Telefonnummer 79161234567 und zeige den Bonusstand und die letzten Transaktionen."
Nächste Schritte
War dieser Guide hilfreich?