ready2order über MCP mit ChatGPT 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 + ChatGPT

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 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 + und dann auf Add custom MCP server.
2. Gib einen Namen ein, z. B. Name: ready2order.
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

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

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

• Connector-Startseite
• Mit Claude verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden