Configuración de MCP

El endpoint MCP de Zimun permite a clientes MCP externos descubrir servicios, comprobar disponibilidad, crear prerreservas y enviar reservas para una organización.

El contexto de la organización forma parte de la ruta URL, por lo que los clientes deben usar la URL MCP exacta mostrada en Configuración.

Esta página trata del MCP de reservas de clientes. Para tu propio equipo existe un MCP de gestión aparte, con su propio interruptor en la misma página de ajustes.

Habilitar MCP para una organización

1. Abre Ajustes → MCP.
2. Habilita el MCP de reservas de clientes para esta organización y guarda.
3. Copia la URL MCP de la organización desde esa página.

Al activar el canal también se pide marcar una casilla de confirmación en esa página, y el acuerdo de encargo de tratamiento de tu organización debe constar en Ajustes → Organización → Aspectos legales; sin ambos, el guardado se rechaza.

URL de cliente a configurar

Usa la URL de transporte MCP de la organización:

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

Ejemplo:

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

Herramientas de reserva compatibles

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

list_services devuelve price_state para cada servicio: exact (price_cents es el precio fijo), from (price_cents es un precio «desde»; el precio final puede ser mayor) o none (sin precio). Nunca presentes un importe from como el precio.

Reservas de cita (servicios con precio fijo). Una prerreserva o una reserva creada a través de esta interfaz para un servicio o un recurso con precio fijo es una reserva de cita (acuerdo de cita) en el sentido de las Condiciones Generales (Parte C, cláusula 13, apdo. 2), no un contrato sobre el servicio. En ese caso, la respuesta de la prerreserva y la respuesta de la reserva incluyen kind: "reservation", contract: "on_site", el precio en price_cents con price_label, cuyo texto es exactamente «Preis der Organisation, zahlbar vor Ort; Preis und Vertrag werden vor Ort geregelt» (precio de la organización, pagadero en el establecimiento; el precio y el contrato se acuerdan en el establecimiento), y notice con este texto fijo: «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 español: «Reserva de cita: Con esta reserva todavía no se ha celebrado ningún contrato sobre el servicio. Precio de la organización, pagadero en el establecimiento; el precio y el contrato se acuerdan en el establecimiento.») Tu interfaz debe mostrar este aviso al cliente final, a más tardar junto con el resultado de la reserva; es tu obligación conforme a la cláusula 8, apdo. 5, letra c), de la Parte B de las Condiciones Generales. La respuesta de la prerreserva lo incluye para que pueda mostrarse antes de que el cliente final envíe la reserva; una versión en otro idioma debe ser completa y fiel. Zimun no recaba ni documenta por esta interfaz ningún consentimiento del cliente final a disposiciones propias de Zimun, no acepta pagos en línea ni tarjetas y envía a la dirección de correo electrónico facilitada con la reserva una comunicación de reserva de cita, no una confirmación de reserva.

Modo de solo lectura

El modo de solo lectura se puede habilitar en Ajustes → MCP.

• Permitido: listar servicios y ubicaciones, comprobar disponibilidad y consultar una reserva existente.
• Bloqueado: crear una prerreserva, crear una reserva, cancelar una reserva y reprogramar una reserva.

Notas operativas

• MCP está deshabilitado por defecto por organización.
• Se aplican límites de uso para proteger los flujos públicos de reserva.
• Create booking usa una Idempotency-Key para evitar envíos duplicados.
• Las respuestas de herramientas minimizan los datos personales (PII) del cliente.

Documentación relacionada

Para un flujo de reserva conversacional integrable que use las mismas reglas de disponibilidad y reserva, consulta Agente de chat de reservas.