ready2order über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → ready2order klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

ready2order + Gemini

Verbinde die ready2order-Kasse (Registrierkasse) mit deiner KI: Artikel, Preise und Lagerstand, Produktgruppen, Belege und Tagesumsätze, offene Bestellungen, Kunden, Zahlungsarten und Steuersätze, mit bestätigten Änderungen an Artikeln, Lagerstand und Kunden.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

READY2ORDER_ACCOUNT_TOKEN

Schritt 1 — Zugangsdaten holen

ready2order vergibt pro Kassenkonto ein Account Token über einen kurzen Freigabeablauf. Das dauert etwa 10 Minuten, einmal pro Konto, und braucht den Login des Kontoinhabers und eine kostenlose Entwickler-Registrierung.

1. Registriere dich unter https://api.ready2order.com als Entwickler. ready2order schickt dir per E-Mail ein Developer Token.
2. Beantrage damit den Zugriff:

   curl -X POST https://api.ready2order.com/v1/developerToken/grantAccessToken \
     -H "Authorization: Bearer <DEVELOPER_TOKEN>" -H "Content-Type: application/json" -d "{}"
   

   Die Antwort enthält grantAccessToken und grantAccessUri.
3. Öffne grantAccessUri innerhalb von 10 Minuten, melde dich mit dem Inhaber des ready2order-Kontos an und klicke auf Approve.
4. Lies das Account Token aus:

   curl https://api.ready2order.com/v1/developerToken/grantAccessToken/<grantAccessToken> \
     -H "Authorization: Bearer <DEVELOPER_TOKEN>"
   

5. Füge accountToken aus der Antwort in READY2ORDER_ACCOUNT_TOKEN ein und installiere den Connector. Das Token geht nur an ready2order und bleibt gültig, bis du es im ready2order-Admin unter Settings → API access widerrufst.

Das Developer Token allein wird mit 403 abgelehnt: Der Connector braucht das Account Token.

Was abgedeckt ist: Artikel mit Preis, Steuersatz, Artikelnummer, Barcode und Lagerstand, Lagerstände mit Meldebestand und Sicherheitsbestand, Produktgruppen, Belege mit Positionen, Zahlungen und Steueraufschlüsselung, ein PDF-Link pro Beleg, offene Bestellungen pro Tisch, Kunden und Kundengruppen, Zahlungsarten, Steuersätze, die Benutzer der Kasse und ob gerade ein Tagesabschluss-Zeitraum offen ist.

Erst bestätigen: Änderungen wirken sofort auf die laufende Kasse, ein neuer Artikel erscheint direkt im Kassensystem. Die KI nennt den Artikel oder Kunden und die neuen Werte und wartet auf dein Ja. Sie kann Artikel anlegen und bearbeiten, Lagerstand buchen (absolut nach einer Inventur oder als Zu- und Abgang, etwa für Wareneingang oder Bruch), Produktgruppen anlegen sowie Kunden anlegen und bearbeiten. ready2order_delete_product ist bei der Installation ausgeschaltet; um einen Artikel aus dem Verkauf zu nehmen, setzt die KI ihn stattdessen inaktiv.

Umsatzzahlen: ready2order_list_bills nimmt einen Zeitraum. Standardmäßig richten sich die Daten nach dem Tagesabschluss, zu dem ein Beleg gehört (dem Geschäftstag), auf Wunsch nach dem Zeitstempel des Belegs selbst. Mit den verkauften Positionen ergibt das die Umsätze pro Artikel. Belege sind steuerliche Aufzeichnungen: Der Connector kann sie weder ändern noch stornieren.

Ratenlimit: 60 Anfragen pro Minute und Account Token; nach einem 429 eine Minute warten.

Häufige Fehler: 401 Sorry, but your token is invalid.: Das Token ist falsch oder wurde widerrufen; wiederhole den Freigabeablauf. 403: Statt des Account Tokens wurde ein Developer Token eingefügt. 429: mehr als 60 Anfragen in einer Minute. 400 oder 422: Ein Feld ist ungültig, die Meldung nennt es, zum Beispiel ein Artikel ohne Steuersatz.

Der Connector erstellt und storniert keine Belege, druckt nicht und kümmert sich nicht um Gutscheine, Rabatte, Tische, Kartenterminals, Webhooks oder Buchhaltungsexporte.

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 Gemini 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.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die ready2order-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie hoch war der Umsatz gestern, und welche 10 Artikel haben sich am besten verkauft?“
• „Welche Artikel der Produktgruppe Getränke liegen unter ihrem Meldebestand?“
• „Wir haben 24 Flaschen von Artikelnummer 1002 bekommen: Buch sie in den Lagerstand ein.“
• „Erhöh den Preis für den Cappuccino auf 4,20 und zeig mir die Änderung, bevor du speicherst.“
• „Hol mir das PDF des letzten Belegs für die Müller GmbH.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden