Zusammenfassung
iiko und Syrve Restaurantmanagement über die iikoCloud API (Syrve Cloud API): Organisationen und Terminalgruppen, Menüs und externe Menüs, Stopplisten, 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 verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde iiko in der geführten Einrichtung und trag deine MCP-URL in Claude ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
AnythingMCP ist im Connector-Verzeichnis von Claude gelistet: Füg es mit einem Klick zu Claude hinzu (öffnet in neuem Tab), melde dich an und wähle, welche MCP-Server Claude nutzen darf.
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 + Claude
iiko und Syrve Restaurantmanagement über die iikoCloud API (Syrve Cloud API): Organisationen und Terminalgruppen, Menüs und externe Menüs, Stopplisten, Liefer- und Tischbestellungen, Reservierungen, Kuriere, Bestell- und Zahlungsarten, Rabatte und Treuekunden. API-Login aus dem Web-Backoffice.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
IIKO_API_HOST, IIKO_LOYALTY_API, IIKO_API_LOGIN
Schritt 1 — Zugangsdaten erhalten
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, die er erreichen 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 abschaltet, meldet die Einrichtungskontrolle ein fehlgeschlagenes Login.
Wo anfangen: 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ü auf 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 die Stoppliste).
Lieferbestellungen: iiko_list_deliveries_by_date_and_status (die tägliche Übersicht), iiko_search_deliveries (Textsuche und Problemunterdrückung), 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 Stoppliste 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 yyyy-MM-dd HH:mm:ss.fff ohne Zeitzone: Bestell- und Reservierungszeiten sind lokal zum Terminal (siehe die Zeitzone in iiko_list_terminal_groups), Treueberichtdaten 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ü, Stopplisten, Bestelllesungen und andere) und begrenzt 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 Stopplistenmethoden wachsen mit der Anzahl der Restaurants. Frage mehrere Organisationen in einem Aufruf an, anstatt einen Aufruf für jede 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 Fehlermeldung hat errorDescription und oft error (einen Code) sowie eine correlationId, die du dem iiko-Support nennen kannst. 401 bedeutet, dass das Token oder API-Login abgelehnt wurde, 400 benennt das falsche Feld, 408 bedeutet, dass das POS nicht rechtzeitig geantwortet hat (das Restaurant könnte offline sein).
Schritt 2 — Adapter installieren
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
Schritt 3 — Connector in Claude hinzufügen
Deine Server-URL: öffne in AnythingMCP MCP-Server → den Server, auf dem sich dieser Connector befindet, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Verwende sie überall dort, wo dieser LeitfadenYOUR_SERVER_IDzeigt.
Empfohlener Pfad: funktioniert auf claude.ai web ohne Bearbeitung einer Konfigurationsdatei.
- Öffne in Claude Plugins (in manchen Plänen noch Customize) → Connectors.
- Klicke auf + Add und dann auf Add custom connector.
- Gib einen Namen ein, z. B.
iiko, und die Remote-MCP-Server-URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Continue, übernimm die erkannten Einstellungen und klicke erneut auf Continue. - Wähle Sign in now, klicke auf Add und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.
Alle untenstehenden Tools erscheinen in deinem Chat: beginne mit dem Tippen von Eingabeaufforderungen.
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 wahr oder falsch. 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 Artikelkategorien, Artikeln, Größen, Preisen pro Organisation, Modifikatorgruppen, Allergenen, Nährwerten… |
iiko_get_stop_lists | Liest die Stopplisten (nicht vorrätige Artikel): pro Organisation und Terminalgruppe die Artikel mit productId, sizeId, sku, Bestand (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 Rabatte und Zuschläge auf, die im Backoffice pro Organisation eingerichtet sind: 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 aufbewahrt): dieselben Bestelldetails, gruppiert nach Organisation, maximal… |
iiko_search_deliveries | Durchsucht Lieferbestellungen nach Text (Präfixsuche bei 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) der angegebenen Tische 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) der 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 auf, die Lieferkuriere sind, pro Organisation: 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 Stoppliste): 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 Stoppliste 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 Stoppliste einer Terminalgruppe, damit sie wieder bestellt werden können. Benötigt ein API-Login mit dem zusätzlichen Recht, die Stoppliste zu ändern… |
Beispielaufforderungen
- "Welche Lieferbestellungen von heute sind noch nicht auf dem Weg, pro Restaurant?"
- "Was steht gerade auf der Stoppliste 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 an."
FAQ
Funktioniert es sowohl mit Claude Code als auch mit Claude Desktop? Ja, weise beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Woher kommt das API-Login? Ein Administrator meldet sich im Web-Backoffice (iikoWeb für iiko, Syrve Web für Syrve) an und öffnet Integrationen, API-Schlüssel (API-Einstellungen in älteren Versionen). Erstelle ein API-Login für den Connector, wähle die Organisationen, die er erreichen darf, und ein Ablaufdatum von maximal 2 Jahren, und kopiere den Schlüssel. Wähle dann dein Produkt für den API-Host und die Treuepfade: iiko verwendet api-ru.iiko.services, Syrve verwendet api-eu.syrve.live, und ein Schlüssel funktioniert nur auf dem Host seines eigenen Produkts.
Was deckt es ab? Organisationen und Terminalgruppen mit ihrem Online-Status, die externen Menüs mit Preisen und das Backoffice-Menü, Stopplisten, Lieferbestellungen nach Datum, Status, Telefon oder Textsuche, Tischbestellungen, Reservierungen mit Sälen und Tischen, Kuriere, Bestell- und Zahlungsarten, Rabatte und Stornierungsgründe sowie Treuegäste mit Wallet-Bilanzen und Bonus-Transaktionen. Es speichert die Stammdaten der Gäste, lädt jedoch niemals auf, hält oder schreibt ein Wallet ab, erfasst keine Zahlungen und erstellt keine Reservierungen.
Welche Tools sind standardmäßig deaktiviert? iiko_create_delivery, iiko_cancel_delivery, iiko_add_to_stop_list und iiko_remove_from_stop_list. Eine erstellte Bestellung gelangt direkt in die Küche und eine Stornierung kann nicht rückgängig gemacht werden, und die Stopplisten-Tools benötigen ein API-Login mit dem zusätzlichen Recht für die Stoppliste. Schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll.
Nächste Schritte
- Connector-Startseite
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
- Mit Microsoft Copilot verbinden
War dieser Guide hilfreich?