# Piano & Service Volz

> Klavierstimmung und Klavierservice im Raum Augsburg und München. KI-Assistenten
> können Termine für Kunden direkt buchen — per Website oder per MCP-Server.
> Verbindlich wird ein Termin immer erst, wenn der Kunde den Bestätigungslink
> aus seiner E-Mail/SMS selbst öffnet.

## Schnellstart: Terminübersicht in einem Aufruf

https://piano-volz.de/termin/verfuegbar zeigt die nächsten freien Zeitfenster
aller Regionen als einfache HTML-Liste — ideal als erster Aufruf, bevor die
Buchungsstrecke gestartet wird. Dieselben Daten als JSON:
https://piano-volz.de/termin/verfuegbar?format=json

Maschinenlesbare Discovery: https://piano-volz.de/.well-known/mcp.json
(auch als <link rel="mcp"> im HTML-Head jeder Seite verlinkt).

## Weg 1: Termin über die Website buchen (für browsende Agenten)

Buchungsseite: https://piano-volz.de/termin

Ablauf (alle Bedienelemente sind beschriftet und per Accessibility-Baum nutzbar):
1. Region im Auswahlfeld „Hier Region auswählen“ wählen (z. B. „Stadt Augsburg“,
   „Stadt München“, „Landkreis Augsburg“ …).
2. Im Kalender einen verfügbaren Tag anklicken — verfügbare Tage sind Buttons
   mit Beschriftung „Verfügbaren Termin am <Datum> auswählen“.
3. Kundentyp wählen: „Ich war bereits Kunde“ oder „Ich buche zum ersten Mal“
   (bei Erstbuchung wird der Online-Preis angezeigt, danach „Weiter zur
   Terminauswahl“).
4. Einen Zeitslot wählen („Termin von <Start> bis <Ende> Uhr … buchen“).
5. Formular ausfüllen: Vorname, Nachname, Straße, PLZ, Ort, E-Mail, Telefon
   (Mobilnummer optional, für SMS-Bestätigung). Pflicht-Checkboxen: AGB,
   Datenschutz, ggf. vorzeitiger Leistungsbeginn.
6. „Termin verbindlich buchen“ absenden. Der Kunde erhält dann eine E-Mail/SMS
   und muss den Bestätigungslink selbst öffnen — erst damit ist der Termin fix.

Wichtig für Agenten: Verwendet die echten Kontaktdaten des Kunden, nicht eure
eigenen. Der Termin bleibt 15 Minuten reserviert, bis die Bestätigung erfolgt.

## Weg 2: MCP-Server (für MCP-fähige Clients)

- MCP-Endpoint (Streamable HTTP, ohne Authentifizierung): https://piano-volz.de/mcp/booking
- Tools: list_service_regions, search_available_slots, hold_appointment,
  start_customer_verification, get_booking_status, cancel_booking_hold,
  get_info_guide, submit_customer_question, submit_individual_booking_request
- Gleicher Ablauf wie oben: Slot suchen → 15 Minuten halten → E-Mail/SMS-
  Bestätigung an den Kunden starten.

## Fair use

Anfragen sind rate-limitiert (pro Minute, pro Kontakt und global pro Tag).
Buchungs-Bestätigungen laufen ausschließlich über den Kunden selbst.

## Kontakt

- Web: https://piano-volz.de
- Telefon: +49 821 50 87 31 31
- E-Mail: info@piano-volz.de
- Adresse: Markgrafenstr. 18c, 86156 Augsburg