Entwicklerdokumentation

MCP-Server

Führen Sie Ihre Location mit Claude, ChatGPT oder VS Code und lassen Sie Gäste per Assistent buchen. Was der BookDinePlay-MCP-Server ist und wie sicher er ist.

Der BookDinePlay-MCP-Server lässt einen KI-Assistenten das tun, was Sie sonst in der Konsole anklicken, und lässt den Assistenten eines Gastes eine Location finden und einen Tisch buchen. Er läuft unter https://mcp.bookdineplay.com und spricht das Model Context Protocol (MCP) über Streamable HTTP, sodass jeder MCP-Client ihn nutzen kann: Claude, Claude Code, ChatGPT, VS Code und andere.

Sie melden sich mit Ihrem BookDinePlay-Konto an. Der Assistent hat dann genau Ihre Rechte, nicht mehr: dieselbe Location, dieselben Tarifgrenzen, dieselben Regeln für gesperrte Konten wie in der Konsole. Ein Gast meldet sich genauso an und bekommt nur die Gast-Werkzeuge.

Für wen er ist

Sie sind Was der Assistent kann
Betreiber einer Location Alles, was die Konsole für Ihre Location tut: Buchungen, Öffnungszeiten, Ressourcen, Menüs und Specials, Events, Gutscheine, Bestellungen, QR-Codes, Nachrichten, Team, API-Schlüssel und Abrechnungslinks, dazu die Gast-Werkzeuge unten
Plattform-Admin Die Admin-Werkzeuge, als ein Mandant handelnd, so wie die Stellvertretung der Konsole, mit derselben Protokollierung
Eine neue Location Eine geführte Anmeldung: Der Assistent fragt, Sie lesen und akzeptieren die AGB in einem Formular auf Ihrem eigenen Bildschirm, Sie zahlen auf der Seite von Stripe, danach hilft er beim Einrichten
Ein Gast Locations finden, Menüs, Öffnungszeiten, Specials und Events lesen, Verfügbarkeit prüfen und einen Tisch oder ein Spiel buchen

Werkzeuge listet auf, was jede Gruppe kann und nicht kann. Verbinden zeigt, wie Sie den Server Ihrem Assistenten hinzufügen.

Wie er sicher bleibt

  • Die API entscheidet. Der Server hat keine eigene Geschäftsregel. Jedes Werkzeug wird zu einem Aufruf der öffentlichen oder der Operator-API, und die prüft Mandant, Rolle, Tarif, Sperrung und Einschränkungen auf eine Location genau wie für die Konsole.
  • Ihre Identität, kein gemeinsamer Schlüssel. Die Aufrufe eines Betreibers gehen mit einem Token für genau diese Person an die API. Das Token, das der Assistent dem MCP-Server vorgelegt hat, wird nie weitergereicht.
  • Was sich schwer rückgängig machen lässt, wird bestätigt. Stornieren, Erstatten, Löschen, Entwerten und Ähnliches zeigen erst eine Vorschau und warten dann auf einen zweiten Aufruf mit einer Bestätigung. Werkzeuge erklärt das Muster.
  • Geheimnisse bleiben aus dem Chat. Ein geheimer API-Schlüssel, ein Gutscheincode, ein Ticketcode und der Stornolink einer Buchung sind nie Teil der Antwort eines Werkzeugs.
  • Grenzen. Aufrufe sind pro Person begrenzt, und ein Gast kann über einen Assistenten höchstens 10 Buchungen pro Stunde machen.

Fragen, die oft gestellt werden

Was ist der BookDinePlay-MCP-Server?

Ein Dienst unter https://mcp.bookdineplay.com, mit dem KI-Assistenten, die das Model Context Protocol unterstützen, BookDinePlay nutzen können: Betreiber verwalten ihre Location, Gäste finden und buchen, jeweils mit den Rechten der angemeldeten Person.

Kostet er etwas?

Der Server selbst ist kostenlos anzubinden. Was Sie darüber tun können, hängt wie in der Konsole von Ihrem Tarif ab; Spiel-Ressourcen und Online-Zahlungen brauchen zum Beispiel einen höheren Tarif.

Kann ein Assistent für einen Gast einen Tisch buchen?

Ja. Die Gast-Werkzeuge suchen Locations, prüfen die Verfügbarkeit und legen eine echte Buchung an, nachdem der Gast die Angaben bestätigt hat. Die Bestätigungs-E-Mail mit dem Link zum Verwalten oder Stornieren der Buchung geht an den Gast; der Assistent sieht diesen Link nie.

Kann der Assistent eine Zahlung entgegennehmen?

Nein. Eine Anzahlung, ein Eventticket oder ein Gutschein wird auf der Buchungsseite der Location oder in der BookDinePlay-App bezahlt. Online-Zahlung bleibt optional.

Speichert der Server meine Unterhaltungen?

Nein. Er gibt Ihre Anfragen an die BookDinePlay-API weiter und protokolliert nur Betriebsdaten: welches Werkzeug lief, wann, für welche Location und ob es geklappt hat. Was Sie gefragt haben und was geantwortet wurde, protokolliert er nie. Was der Anbieter Ihres Assistenten mit einer Unterhaltung macht, regeln dessen eigene Bedingungen.