Configuration MCP

L’endpoint MCP de Zimun permet aux clients MCP externes de découvrir des services, vérifier la disponibilité, créer des holds et soumettre des réservations pour une organisation.

Le contexte d’organisation fait partie du chemin URL, les clients doivent donc utiliser l’URL MCP exacte affichée dans Paramètres.

Cette page traite du MCP de réservation client. Il existe un MCP de gestion distinct pour votre propre équipe, avec son interrupteur dédié sur la même page de paramètres.

Activer MCP pour une organisation

1. Ouvrez Paramètres → MCP.
2. Activez le MCP de réservation client pour cette organisation et enregistrez.
3. Copiez l’URL MCP de l’organisation depuis cette page.

À l’activation du canal, une case de confirmation est également demandée sur cette page, et le contrat de sous-traitance de votre organisation doit être enregistré sous Paramètres → Organisation → Mentions légales — sans les deux, l’enregistrement est refusé.

URL client à configurer

Utilisez l’URL de transport MCP de l’organisation :

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

Exemple :

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

Outils de réservation pris en charge

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

list_services renvoie price_state pour chaque prestation : exact (price_cents est le prix fixe), from (price_cents est un prix de départ ; le prix final peut être plus élevé) ou none (aucun prix). Ne présentez jamais un montant from comme le prix.

Réservations de rendez-vous (prestations à prix ferme). Un hold ou un rendez-vous créé via cette interface pour une prestation ou une ressource à prix ferme constitue une réservation de rendez-vous au sens des Conditions générales (partie C, clause 13, § 2), et non un contrat portant sur la prestation. La réponse de hold et la réponse de réservation contiennent alors kind: "reservation", contract: "on_site", le prix dans price_cents, avec price_label, dont le texte est exactement « Preis der Organisation, zahlbar vor Ort; Preis und Vertrag werden vor Ort geregelt » (prix de l’organisation, payable sur place ; le prix et le contrat sont convenus sur place), ainsi que notice, avec ce texte fixe : « 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. » (En français : « Réservation de rendez-vous : aucun contrat portant sur la prestation n’est encore conclu par cette réservation. Prix de l’organisation, payable sur place ; le prix et le contrat sont convenus sur place. ») Votre interface doit afficher cette mention au client final, au plus tard en même temps que le résultat de la réservation ; cette obligation vous incombe au titre de la partie B, clause 8, § 5, point c), des Conditions générales. La réponse de hold la contient afin qu’elle puisse être affichée avant que le client final n’envoie la réservation ; toute version dans une autre langue doit être complète et fidèle. Par cette interface, Zimun ne recueille ni ne documente aucun consentement du client final à ses propres conditions, n’accepte ni paiement en ligne ni carte de paiement, et envoie à l’adresse e-mail transmise avec la réservation un avis de réservation, et non une confirmation de réservation.

Mode lecture seule

Le mode lecture seule peut être activé dans Paramètres → MCP.

• Autorisé : lister les services et les emplacements, consulter les disponibilités et retrouver une réservation existante.
• Bloqué : créer un hold, créer une réservation, annuler une réservation et reprogrammer une réservation.

Notes opérationnelles

• MCP est désactivé par défaut par organisation.
• Des limites de débit s’appliquent pour protéger les flux publics de réservation.
• Create booking utilise une Idempotency-Key pour éviter les soumissions en double.
• Les réponses des outils minimisent les données personnelles client (PII).

Documentation associée

Pour un flux de réservation conversationnel intégrable qui utilise les mêmes règles de disponibilité et de réservation, voir Agent de chat de réservation.