Connector-Anleitung11 Minuten Lesezeit33 MCP-Tools7 Sprachen

iiko MCP mit ChatGPT verbinden

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.

HCVom HelpCode-TeamAktualisiert 11 Min. Lesezeit Open Source auf GitHub

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

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.

Tools

33

Region

INTL

Kategorie

E-Commerce

Authentifizierung

Sign-in token

Benötigte Env-Vars

IIKO_API_HOSTIIKO_LOYALTY_APIIIKO_API_LOGIN
Mit einem Klick in der Cloud installieren

7 Tage kostenlos testen · Keine Kreditkarte

  • 7 Tage kostenlos
    Keine Kreditkarte nötig
  • DSGVO & SOC 2 ready
    EU-Datenhaltung, Audit-Logs
  • Open Source auf GitHub
    Open-Source · AGPL-3.0
  • Funktioniert mit ChatGPT, Claude, Gemini
    Jeder MCP-kompatible Client

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

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde iiko in der geführten Einrichtung und trag deine MCP-URL in ChatGPT ein. Ohne Code, ohne eigenen Server.

Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar

Das AnythingMCP-Plugin im ChatGPT-Verzeichnis beantwortet auf AnythingMCP Cloud Fragen aus deinen Firmendatenbanken (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, nur lesend): Öffne den Eintrag (öffnet in neuem Tab) und klicke auf Install plugin. Alle anderen Connectors fügst du in ChatGPT als eigenen MCP-Server mit deiner AnythingMCP-MCP-URL hinzu.

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.

iiko · live via MCP
Teilen
Opus 4.7

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

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.

  1. 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).
  2. 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.
  3. Füge ihn in IIKO_API_LOGIN ein. Wähle dein Produkt zweimal: den API-Host in IIKO_API_HOST und dasselbe Produkt in IIKO_LOYALTY_API (iiko und Syrve benennen die Treuepfade unterschiedlich).
  4. Optional: Gib die ID deines Hauptrestaurants in IIKO_ORGANIZATION_ID nach dem ersten iiko_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 ChatGPT hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.

  1. Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
  2. Gib einen Namen ein, z. B. Name: iiko.
  3. Trag unter Connection als Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und lass Authentication auf OAuth.
  4. Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
  5. Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.

Verfügbare Tools

ToolWas es tut
iiko_list_organizationsListet die Organisationen (Restaurants) auf, die das API-Login erreichen kann: ID, Name und Code sowie Land, Adresse, Koordinaten, Zeitzoneneinstellungen…
iiko_list_terminal_groupsListet 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_nomenclatureLiest das vollständige Menü (Nomenklatur) einer Organisation, wie es aus dem Backoffice exportiert wurde: Gruppen, Produktkategorien, Produkte (Gerichte…
iiko_list_external_menusListet 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_menuLiest ein externes Menü mit seinen Artikelkategorien, Artikeln, Größen, Preisen pro Organisation, Modifikatorgruppen, Allergenen, Nährwerten…
iiko_get_stop_listsLiest die Stopplisten (nicht vorrätige Artikel): pro Organisation und Terminalgruppe die Artikel mit productId, sizeId, sku, Bestand (verbleibend…
iiko_list_order_typesListet die Bestellarten pro Organisation auf: ID, Name, orderServiceType (Common für Tischbestellungen, DeliveryByCourier, DeliveryByClient für…
iiko_list_payment_typesListet die Zahlungsarten auf: ID, Code, Name, paymentTypeKind (Bargeld, Karte, Extern, Treuekarte und andere), paymentProcessingType, das Terminal…
iiko_list_discountsListet die Rabatte und Zuschläge auf, die im Backoffice pro Organisation eingerichtet sind: ID, Name, Prozent oder Festbetrag, Modus, Mindestbestellsumme…
iiko_list_cancel_causesListet 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_statusListet Liefer- und Abholbestellungen nach Lieferdatum und Status auf: pro Organisation die Bestellungen mit ID, posId, creationStatus und der Bestellung…
iiko_list_deliveries_by_phoneFindet die aktuellen Lieferbestellungen einer Telefonnummer (garantiert für die letzten 7 Tage): dieselben Bestelldetails wie…
iiko_list_delivery_history_by_phoneFindet ältere Lieferbestellungen einer Telefonnummer in der Bestellhistorie (90 Tage aufbewahrt): dieselben Bestelldetails, gruppiert nach Organisation, maximal…
iiko_search_deliveriesDurchsucht Lieferbestellungen nach Text (Präfixsuche bei Bestellnummer, Kundenname, Telefon oder Adresse) mit Filtern für Datum, Status, Serviceart…
iiko_get_deliveries_by_idLiest 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_idLiest Tischbestellungen (vor Ort) nach ID: creationStatus und die Bestellung mit tableIds, Status (Neu, Rechnung, Geschlossen, Gelöscht), Kellner, Kunde…
iiko_list_table_orders_by_tableListet 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_groupsListet die Terminalgruppen der angegebenen Organisationen auf, die Tischreservierungen und Bankette akzeptieren: ID, Name, Adresse und Zeitzone sowie die…
iiko_list_restaurant_sectionsListet die Restaurantabschnitte (Säle) der Terminalgruppen auf, die Reservierungen akzeptieren, mit ihren Tischen: Abschnitts-ID und Name sowie pro Tisch-ID…
iiko_list_reservesListet die Reservierungen und Bankette auf, die in Restaurantabschnitten ab einem Startzeitpunkt gebucht sind: ID, tableIds, estimatedStartTime, durationInMinutes und…
iiko_get_reserves_by_idLiest Reservierungen und Bankette nach ID: creationStatus, isDeleted und die Reserve mit Kunde, Telefon, Gästeanzahl, Tischen, geschätztem Start…
iiko_list_couriersListet die Mitarbeiter auf, die Lieferkuriere sind, pro Organisation: ID, Vorname, Nachname, Anzeigename, Code und isDeleted. Nur lesbar
iiko_get_customerSucht einen Treuekunden (Gast) per Telefon, E-Mail, Kartennummer, Kartenbahn oder ID: ID, Name, Nachname, Telefon, E-Mail, Geburtstag, Geschlecht…
iiko_list_customer_categoriesListet die Kunden (Gast) Kategorien des Treueprogramms einer Organisation auf: ID, Name, isActive und isDefaultForNewGuests. Nur lesbar
iiko_list_loyalty_programsListet die Treueprogramme einer Organisation auf: ID, Name, Beschreibung, programType, isActive, Gültigkeitsdaten, walletId und das Marketing…
iiko_list_customer_transactionsListet die Treue-Transaktionen eines Kunden in einem Zeitraum (Bonusgutschriften und -abschreibungen, Wallet-Auffüllungen, Gutscheine): Typ, Typname, Summe…
iiko_create_or_update_customerErstellt 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_deliveryErstellt eine Liefer- oder Abholbestellung im POS. Es ist ein Befehl: die Antwort enthält eine correlationId und orderInfo mit creationStatus…
iiko_cancel_deliveryStorniert 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_listSetzt 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_listNimmt 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

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.

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.

Nächste Schritte

War dieser Guide hilfreich?

iiko in 2 Minuten mit ChatGPT verbinden

Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde iiko in der geführten Einrichtung und trag deine MCP-URL in ChatGPT ein. Ohne Code, ohne eigenen Server.

Verwandte Anleitungen

Connectors

iiko MCP mit Claude verbinden

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.

Connectors

iiko MCP mit Microsoft Copilot verbinden

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.

Connectors

iiko MCP mit Cursor verbinden

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.

Connectors

iiko MCP mit Gemini CLI verbinden

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.

Connectors

iiko MCP mit Meta Muse verbinden

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.

Connectors

iiko MCP-Server: Menüs, Bestellungen, Reservierungen

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.