L’endpoint MCP di Zimun consente a client MCP esterni di scoprire servizi, verificare disponibilità, creare hold e inviare prenotazioni per un’organizzazione.
Il contesto organizzazione fa parte del percorso URL, quindi i client devono usare l’URL MCP esatto mostrato in Impostazioni.
Questa pagina riguarda l’MCP prenotazioni clienti. Per il tuo team esiste un MCP di gestione separato, con il proprio interruttore nella stessa pagina delle impostazioni.
Abilita MCP per un’organizzazione
- Apri Impostazioni → MCP.
- Abilita l’MCP prenotazioni clienti per questa organizzazione e salva.
- Copia l’URL MCP dell’organizzazione da quella pagina.
Attivare il canale richiede anche di spuntare una casella di conferma su quella pagina, e l’accordo sul trattamento dei dati della tua organizzazione deve risultare registrato in Impostazioni → Organizzazione → Informazioni legali — senza entrambi il salvataggio viene rifiutato.
URL client da configurare
Usa l’URL di trasporto MCP dell’organizzazione:
https://zimun.online/o/<org_id>/mcpEsempio:
https://zimun.online/o/o_your-org-id/mcpStrumenti di prenotazione supportati
list_serviceslist_locationsget_availabilitycreate_holdcreate_bookingget_bookingcancel_bookingreschedule_booking
list_services restituisce price_state per ogni servizio: exact (price_cents è il prezzo fisso), from (price_cents è un prezzo di partenza; il prezzo finale può essere più alto) o none (nessun prezzo). Non presentare mai un importo from come il prezzo.
Riserve di appuntamento (servizi a prezzo fisso). Se tramite questa interfaccia viene creato un hold o una prenotazione per un servizio o una risorsa con prezzo fisso, si tratta di una riserva di appuntamento ai sensi delle Condizioni generali (Parte C, punto 13, comma 2), non di un contratto relativo alla prestazione. In tal caso la risposta dell’hold e la risposta della prenotazione contengono kind: "reservation", contract: "on_site", il prezzo in price_cents con price_label che riporta esattamente «Preis der Organisation, zahlbar vor Ort; Preis und Vertrag werden vor Ort geregelt» (prezzo dell’organizzazione, pagabile in sede; prezzo e contratto vengono definiti in sede), nonché notice con questo testo fisso: «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.» (in italiano: «Riserva di appuntamento: con questa riserva non è ancora stato concluso alcun contratto relativo alla prestazione. Prezzo dell’organizzazione, pagabile in sede; prezzo e contratto vengono definiti in sede.») La tua interfaccia utente deve mostrare questo avviso al cliente finale, al più tardi insieme all’esito della prenotazione; è un tuo obbligo ai sensi delle Condizioni generali, Parte B, punto 8, comma 5, lettera c). La risposta dell’hold lo contiene affinché possa essere mostrato prima che il cliente finale invii la prenotazione; una traduzione in un’altra lingua deve essere completa e fedele. Tramite questa interfaccia Zimun non raccoglie né documenta alcun consenso del cliente finale alle proprie disposizioni, non accetta né pagamenti online né carte di pagamento e invia all’indirizzo e-mail trasmesso con la prenotazione una comunicazione di riserva, non una conferma di prenotazione.
Modalità sola lettura
La modalità sola lettura può essere abilitata in Impostazioni → MCP.
- Consentito: elencare servizi e sedi, verificare la disponibilità e consultare una prenotazione esistente.
- Bloccato: creare un hold e creare, annullare o riprogrammare una prenotazione.
Note operative
- MCP è disattivato di default per organizzazione.
- Si applicano limiti di frequenza per proteggere i flussi pubblici di prenotazione.
- Create booking usa una Idempotency-Key per prevenire invii duplicati.
- Le risposte degli strumenti minimizzano i dati personali del cliente.
Documentazione correlata
Per un flusso di prenotazione conversazionale incorporabile che utilizza le stesse regole di disponibilità e prenotazione, vedere Agente di chat di prenotazione.