Anmelden um den Slug und den veröffentlichbaren Schlüssel Ihrer Location in jedem Beispiel zu sehen.
Ihr Konto hat noch keine Location, die Beispiele behalten daher ihre Platzhalter. Abmelden
Angemeldet als · . Legen Sie in der Konsole einen veröffentlichbaren Schlüssel an und laden Sie die Seite neu, um ihn hier zu sehen. Abmelden
Angemeldet als · . Die Beispiele zeigen den veröffentlichbaren Schlüssel Ihrer Location. Abmelden
Entwicklerdokumentation
Ihre Location mit einem KI-Assistenten führen
Vier Betreiber-Workflows über den MCP-Server – Briefing, Feiertagsschließung, Event-Start, Gutschein – mit den Werkzeugen und den Bestätigungen.
Der MCP-Server lässt einen Assistenten tun, was Sie sonst in der Konsole klicken würden, mit genau Ihren Berechtigungen. Dieses Tutorial zeigt vier Workflows aus der Woche eines Betreibers, wie sie tatsächlich ablaufen: was Sie fragen, welche Werkzeuge der Assistent aufruft, wo er anhält, um Sie zu fragen, und worauf Sie sich verlassen können. Verbinden Sie zuerst den Server (Assistenten verbinden); alles Folgende setzt voraus, dass Sie als Betreiber angemeldet sind.
Wie ein Agent arbeiten sollte
Dieselben vier Gewohnheiten machen jeden Workflow unten sicher, und ein gut erzogener Assistent tut sie, ohne dass man es ihm sagt:
- Lesen, bevor er schreibt. Werkzeuge, die eine ganze Liste ersetzen – die Wochenzeiten, die Menüs –, sagen das, und der Assistent liest zuerst den aktuellen Stand, damit nichts verloren geht, was Sie nicht erwähnt haben. Für eine kleine Änderung wählt er das Einzeländerungs-Werkzeug, etwa eine Schließung hinzuzufügen.
- Vorschau, dann bestätigen. Eine schwer rückgängig zu machende Änderung (Stornieren, Erstatten, Löschen, Entwerten, einen QR-Code neu erzeugen) läuft in zwei Schritten. Der erste Aufruf ändert nichts und antwortet mit einer Vorschau, was genau geschehen würde. Erst nach Ihrem Einverständnis ruft der Assistent erneut mit der Bestätigung auf, die fünf Minuten gilt, für Sie, für dieses Werkzeug und für genau diese Argumente. Ändert der Assistent zwischen beiden Aufrufen etwas, beginnt er mit einer neuen Vorschau von vorn.
- Innerhalb Ihrer Berechtigungen bleiben. Die API entscheidet, also lehnt das Werkzeug mit derselben Meldung ab, was die Konsole für Ihre Rolle oder Ihren Tarif ablehnt. Bei einem Konto mit mehreren Locations übergibt der Assistent das Argument
venuejedes Location-Werkzeugs;venues_listzeigt die Slugs. - Nie ein Geheimnis in den Chat tragen. Ein geheimer API-Schlüssel wird einmal auf einer eigenen Seite außerhalb der Unterhaltung angezeigt. Gutscheincodes, Ticketcodes, QR-Token-Werte und der Stornolink eines Gastes sind nie Teil der Antwort eines Werkzeugs.
Ein Aufruf über dem Limit – 120 Werkzeugaufrufe pro Minute, davon 30 mit Datenänderung – liefert einen Fehler, der sagt, wie lange zu warten ist.
1. Den Tag beginnen: das Briefing
Sie: Gib mir das heutige Briefing.
Der Prompt daily_briefing liest nur. Der Assistent ruft reservations_today_overview und reservations_list für die Buchungen des Tages und die Ankünfte in den nächsten Stunden auf und fasst zusammen, was Sie braucht: die heutigen Buchungen, noch offene Anzahlungen und die nächsten Ankünfte.
Sie: Welche der offenen Anzahlungen sind für heute Abend?
Assistent: Zwei Buchungen für heute Abend haben noch eine offene Anzahlung: BDP-… um 19:00 für sechs und BDP-… um 20:30 für vier. Soll ich ihnen schreiben?
messages_list und messages_reply bearbeiten Gästenachrichten. Eine Antwort sendet im Namen der Location eine E-Mail, daher zeigt ein sorgfältiger Assistent Ihnen den Text, bevor er sendet.
2. Für einen Feiertag schließen
Sie: Wir haben am 24. und 25. Dezember geschlossen und an Silvester bis 02:00 Uhr geöffnet.
Der Prompt set_holiday_hours tut drei Dinge der Reihe nach. Er liest die aktuellen Zeiten (hours_get), macht aus Ihrem Satz exakte Daten und listet die Buchungen, die auf die geschlossenen Tage fallen (reservations_list) – das, was ein Mensch vergisst. Dann zeigt er Ihnen den Plan:
Assistent: Ich würde eine Schließung für den 24. und 25. Dezember hinzufügen und für den 31. Dezember einen Sondertag von 17:00 bis 02:00 Uhr setzen. Elf Buchungen fallen auf den 24. und 25. Ich storniere keine davon; ich empfehle, diese Gäste zu kontaktieren. Soll ich die Zeiten anwenden?
Erst nach Ihrem Ja ruft er hours_add_closure für jeden geschlossenen Tag und hours_set_special_day für Silvester auf. Das sind Einzeländerungs-Werkzeuge: Der Wochenplan bleibt unberührt. Die elf Buchungen zu stornieren wäre ein eigener Schritt mit eigener Vorschau pro Buchung (reservations_set_status); der Assistent tut es nicht als Nebeneffekt des Schließens.
3. Ein Event starten
Sie: Leg einen Darts-Liga-Abend am 14. Januar an, 19:30 bis 23:00 Uhr, kostenlose Anmeldung, 48 Plätze, sechs pro Anmeldung.
Der Assistent ruft events_create mit einem Entwurf auf: Titel, Datum und Zeiten in Ortszeit der Location, kostenloser Anmeldemodus, Kapazität 48 und sechs Tickets pro Anmeldung. Das Event ist ein Entwurf – noch nichts ist öffentlich. Er zeigt Ihnen die Vorschau, die auch die Konsole zeigen würde (events_preview), einschließlich der gerenderten Beschreibung, und fragt nach allem, was Sie ausgelassen haben: ein Bild, eine Beschreibung, die Sprache.
Sie: Sieht gut aus, veröffentliche es.
events_publish macht es öffentlich. Ab dann können sich Gäste über das Events-Widget Ihrer Website anmelden. Um zu sehen, wie es sich füllt:
Sie: Wie viele Plätze sind noch frei, und wer ist angemeldet?
Der Assistent liest das Event (events_get) und event_registrations_list. Am Abend markiert event_checkin ein Ticket, und event_undo_checkin nimmt einen falschen Scan zurück. Ein bezahltes Event funktioniert genauso mit Ticketpreis und Erstattungsregel und braucht Premium und ein verbundenes Auszahlungskonto; payouts_status sagt dem Assistenten, ob er verkaufen kann.
Das Event abzusagen (events_cancel) oder eine Anmeldung zu erstatten (event_registrations_refund) ist eine bestätigte Änderung: Sie sehen genau, welche Anmeldungen und Beträge betroffen sind, bevor etwas geschieht.
4. Einen Gutschein ausstellen
Sie: Stell einen 25-Euro-Gutschein für Ada Lovelace aus, als Entschuldigung für letzten Freitag, ein Jahr gültig.
Der Assistent ruft vouchers_issue mit einer nicht bezahlten Zahlung (einem Kulanzgutschein), dem Betrag, dem Empfänger und dem Ablauf auf. Der Code wird nie im Chat gezeigt: Der Empfänger erhält ihn per E-Mail, und die Antwort enthält nur die Referenz des Gutscheins. Später:
Sie: Hat Ada ihn schon benutzt?
vouchers_get zeigt das Guthaben und das Kontobuch dessen, was mit ihm geschah. Ihn zu entwerten (vouchers_void), seinen Ablauf zu ändern (vouchers_change_expiry) und einen Verkauf zu erstatten (vouchers_refund_sale) folgt dem Muster aus Vorschau und Bestätigung. Am Tisch nehmen voucher_lookup und voucher_redeem einen Code entgegen, den Sie tippen oder einfügen: Der Assistent braucht den Code, um ihn einzulösen, geben Sie ihn also nur, wenn Sie es wollen, und wissen Sie, dass er nicht zurückgespiegelt wird.
Was ein Assistent nicht kann
- Eine Zahlung einziehen. Eine Anzahlung, ein Ticket oder ein Gutschein wird auf der Buchungsseite der Location oder in der BookDinePlay-App bezahlt. Der Assistent kann nichts starten, das das Geld eines Gastes bewegt.
- Ein Geheimnis lesen. Schlüssel, Codes und Links werden wie oben zurückgehalten.
- Ihren Tarif umgehen. Spielressourcen, Anzahlungen, der Online-Ticketverkauf und mehrere Locations folgen Ihrem Tarif genau wie in der Konsole.
Nächste Schritte
- Was die Werkzeuge tun – jedes Werkzeug und jeder Prompt nach Bereich.
- Assistenten verbinden – den Server zu Claude, ChatGPT oder VS Code hinzufügen.
- Mehrere Locations – das Argument
venueim Detail.