Настройка MCP

Точка MCP Zimun позволяет внешним MCP-клиентам находить услуги, проверять доступность, создавать удержания и оформлять записи для одной организации.

Контекст организации входит в путь URL, поэтому клиенты должны использовать ровно тот MCP URL, который показан в настройках.

Эта страница посвящена MCP для записи клиентов. Для вашей команды есть отдельный MCP для управления — со своим переключателем на той же странице настроек.

Включить MCP для организации

1. Откройте «Настройки → MCP».
2. Включите MCP для записи клиентов в этой организации и сохраните.
3. Скопируйте URL MCP организации с этой страницы.

При включении канала также запрашивается галочка подтверждения на этой странице, а договор об обработке данных вашей организации должен быть зафиксирован в разделе «Настройки → Организация → Правовые документы» — без того и другого сохранение отклоняется.

URL клиента для настройки

Используйте транспортный URL MCP организации:

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

Пример:

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

Поддерживаемые инструменты бронирования

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

list_services возвращает для каждой услуги price_state: exact (price_cents — фиксированная цена), from (price_cents — цена «от»; итоговая цена может быть выше) или none (цена не указана). Никогда не выдавайте сумму from за цену.

Резервирование времени приёма (услуги с фиксированной ценой). Удержание (hold) или запись, созданные через этот интерфейс для услуги или ресурса с фиксированной ценой, являются резервированием времени приёма в смысле Общих условий (часть C, пункт 13(2)), а не договором об услуге. В этом случае ответ на создание удержания и ответ на создание записи содержат kind: "reservation", contract: "on_site", цену в price_cents и price_label в точной формулировке «Preis der Organisation, zahlbar vor Ort; Preis und Vertrag werden vor Ort geregelt» (цена организации, оплата на месте; цена и договор согласуются на месте), а также notice со следующим фиксированным текстом: «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.» (по-русски: «Резервирование времени приёма: этим резервированием договор об услуге ещё не заключён. Цена организации, оплата на месте; цена и договор согласуются на месте»). Ваш интерфейс должен показать конечному клиенту это уведомление не позднее чем вместе с результатом бронирования; это ваша обязанность согласно Общим условиям (часть B, пункт 8(5), буква c). Ответ на создание удержания содержит уведомление, чтобы его можно было показать до того, как конечный клиент отправит запрос на запись; перевод на другой язык должен быть полным и точным по смыслу. Zimun не получает и не документирует через этот интерфейс согласия конечного клиента с положениями Zimun, не принимает ни онлайн-оплаты, ни банковских карт и отправляет на адрес электронной почты, переданный вместе с записью, сообщение о резервировании, а не подтверждение бронирования.

Режим только для чтения

Режим только для чтения можно включить в «Настройки → MCP».

• Разрешено: список услуг и локаций, проверка доступности и поиск существующей записи.
• Запрещено: создание резерва, создание записи, отмена записи и перенос записи.

Операционные заметки

• MCP по умолчанию отключён для каждой организации.
• Действуют ограничения частоты запросов для защиты публичных сценариев записи.
• Создание записи использует Idempotency-Key для предотвращения дублирующих отправок.
• Ответы инструментов минимизируют персональные данные клиентов.

Связанная документация

Для встраиваемого диалогового процесса записи, использующего те же правила доступности и записи, см. Чат-агент записи.