Налаштування MCP

Кінцева точка Zimun MCP дозволяє зовнішнім клієнтам 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.» (українською: «Резервування часу: цим резервуванням договір щодо послуги ще не укладено. Ціна організації, оплата на місці; ціна та договір узгоджуються на місці.») Ваш інтерфейс повинен показати кінцевому клієнтові цю примітку не пізніше ніж разом із результатом запису; це ваш обовʼязок згідно з підпунктом c пункту 8(5) Частини B Умов. Відповідь на запит утримання містить її, щоб її можна було показати ще до того, як кінцевий клієнт надішле запит на запис; переклад іншою мовою має бути повним і точним за змістом. Zimun через цей інтерфейс не отримує й не документує згоди кінцевого клієнта з власними положеннями, не приймає ні онлайн-оплати, ні платіжних карток та надсилає на адресу електронної пошти, передану разом із записом, повідомлення про резервування, а не підтвердження запису.

Режим лише для читання

Режим лише для читання можна ввімкнути в розділі «Налаштування» → MCP.

• Дозволено: перелік послуг і локацій, перевірка доступності та пошук наявного запису.
• Заблоковано: створення утримання, створення запису, скасування запису та перенесення запису.

Операційні примітки

• MCP вимкнено за замовчуванням для кожної організації.
• Діють обмеження швидкості для захисту публічних процесів бронювання.
• Створення запису використовує Idempotency-Key, щоб запобігти повторним надсиланням.
• Відповіді інструментів мінімізують персональні дані клієнтів.

Повʼязана документація

Для вбудовуваного діалогового потоку запису, що використовує ті самі правила доступності та запису, див. Чат-агент запису.