MCP-Konfiguration

Der Zimun-MCP-Endpunkt ermöglicht externen MCP-Clients, Services zu entdecken, Verfügbarkeit zu prüfen, Holds zu erstellen und Buchungen für eine Organisation einzureichen.

Der Organisationskontext ist Teil des URL-Pfads, daher sollten Clients die in den Einstellungen angezeigte genaue MCP-URL verwenden.

Diese Seite behandelt das Kundenbuchungs-MCP. Für Ihr eigenes Team gibt es ein separates Verwaltungs-MCP mit eigenem Schalter auf derselben Einstellungsseite.

MCP für eine Organisation aktivieren

1. Öffnen Sie Einstellungen → MCP.
2. Aktivieren Sie das Kundenbuchungs-MCP für diese Organisation und speichern Sie.
3. Kopieren Sie die MCP-URL der Organisation von dieser Seite.

Beim Einschalten des Kanals wird zusätzlich ein Bestätigungshäkchen auf der betreffenden Seite abgefragt, und der Auftragsverarbeitungsvertrag Ihrer Organisation muss unter Einstellungen → Organisation → Rechtliches hinterlegt sein — ohne beides wird das Speichern abgelehnt.

Zu konfigurierende Client-URL

Verwenden Sie die MCP-Transport-URL der Organisation:

https://zimun.online/o/<org_id>/mcp

Beispiel:

https://zimun.online/o/o_your-org-id/mcp

Unterstützte Buchungstools

• list_services
• list_locations
• get_availability
• create_hold
• create_booking
• get_booking
• cancel_booking
• reschedule_booking

list_services liefert für jede Leistung price_state: exact (price_cents ist der feste Preis), from (price_cents ist ein Ab-Preis; der endgültige Preis kann höher sein) oder none (kein Preis). Stellen Sie einen from-Betrag nie als den Preis dar.

Reservierungen (Leistungen mit festem Preis). Ein über diese Schnittstelle angelegter Hold oder eine darüber angelegte Buchung für eine Leistung oder Ressource mit festem Preis ist eine Terminreservierung im Sinne der AGB (Teil C Ziffer 13 Abs. 2), kein Vertrag über die Leistung. Die Hold-Antwort und die Buchungsantwort tragen dann kind: "reservation", contract: "on_site", den Preis in price_cents mit dem price_label genau „Preis der Organisation, zahlbar vor Ort; Preis und Vertrag werden vor Ort geregelt“ sowie notice mit diesem festen Text: „Terminreservierung: Mit dieser Reservierung ist noch kein Vertrag über die Leistung geschlossen. Preis der Organisation, zahlbar vor Ort; Preis und Vertrag werden vor Ort geregelt.“ Ihre Oberfläche muss dem Endkunden diesen Hinweis anzeigen, spätestens mit dem Buchungsergebnis; das ist Ihre Pflicht nach AGB Teil B Ziffer 8 Abs. 5 Buchstabe c. Die Hold-Antwort trägt ihn, damit er angezeigt werden kann, bevor der Endkunde die Buchung absendet; eine Wiedergabe in einer anderen Sprache muss vollständig und sinngetreu sein. Zimun holt über diese Schnittstelle keine Zustimmung des Endkunden zu eigenen Bestimmungen ein und dokumentiert keine, nimmt keine Online-Zahlung und keine Karte entgegen und sendet an die mit der Buchung übermittelte E-Mail-Adresse eine Reservierungsmitteilung, keine Buchungsbestätigung.

Nur-Lesen-Modus

Der Nur-Lesen-Modus kann in Einstellungen → MCP aktiviert werden.

• Erlaubt: Services und Standorte auflisten, Verfügbarkeit prüfen und eine bestehende Buchung abrufen.
• Blockiert: Hold erstellen, Buchung erstellen, Buchung stornieren und Buchung verschieben.

Betriebshinweise

• MCP ist standardmäßig pro Organisation deaktiviert.
• Rate Limits gelten zum Schutz öffentlicher Buchungsabläufe.
• Create booking verwendet einen Idempotency-Key, um doppelte Übermittlungen zu vermeiden.
• Tool-Antworten minimieren personenbezogene Kundendaten (PII).

Zugehörige Dokumentation

Informationen zu einem einbettbaren Konversationsbuchungsablauf, der dieselben Verfügbarkeits- und Buchungsregeln verwendet, finden Sie unter Buchungs-Chat-Agent.