AI-запись в NailLounge через MCP
Создали отдельный MCP-контур для AI-клиентов: он помогает подобрать услугу, мастера и свободное время, а запись проводит только после явного подтверждения пользователя.
Итог: Реализован отдельный MCP-сервер с опубликованными контрактами read- и write-инструментов. Production-результаты не заявляются: запись управляется независимыми kill-switches и по умолчанию отключена.
Product surface
Website + web booking
7 tools
публичных MCP-инструментов в контракте
2 gates
независимых переключателя для write-операции
1 token
проверяемый контекст выбранного слота
0
YCLIENTS credentials в MCP-сервере
01 / Brief
С чем пришёл клиент
Онлайн-запись NailLounge уже использует отдельный серверный слой между клиентскими каналами и YCLIENTS. Для AI-клиентов нужен такой же управляемый путь: без передачи им партнёрских токенов, Redis-ключей и внутренних идентификаторов.
Диалоговый интерфейс должен уметь найти услугу, мастера и свободное время, но не имеет права сам составлять параметры визита. Иначе ошибка в выборе студии, времени или специалиста превращается в ошибочную запись.
Write-сценарий требует более строгой границы, чем поиск: человек должен увидеть итог, подтвердить имя и номер, дать согласие на обработку данных, а система — повторно проверить слот непосредственно перед созданием записи.
02 / Execution
Как мы это решали
Решения разложены как цепочка продуктовых слоёв: от входа в запись до аналитики, кэша и SEO-структуры. Каждый слой поддерживает основной сценарий, а не существует ради отдельной технологии.
Контракт вместо произвольного диалога
MCP публикует отдельные инструменты для услуг, мастеров, профилей, отзывов, свободных слотов, проверки и создания записи. Входы и ответы валидируются схемами, а read- и write-действия разделены на уровне контракта.
Слот как проверяемый контекст
Поиск возвращает короткоживущий непрозрачный slotToken. AI-клиент не собирает вручную studio, service, master и datetime: prepare_booking восстанавливает итог по токену и показывает его пользователю до write-шага.
Подтверждение до создания записи
create_booking принимает только нормализованный российский мобильный номер, userConfirmed, personalDataConsent и idempotency key. Перед вызовом агент обязан один раз подтвердить с человеком услугу, студию, время и контакт.
MCP без прямого доступа к YCLIENTS
Сервер передаёт валидированный запрос в защищённый Booking API, а тот остаётся границей cache/YCLIENTS-контура. Перед записью API снова проверяет срок токена, доступность и защитные ограничения; write включается только двумя независимыми переключателями.
04 / Stack
На чём собрано
Технический стек показан как производственная схема: интерфейс, интеграции и инфраструктура поддерживают одну цепочку записи.
MCP-сервер
- Node.js 22, TypeScript strict и @modelcontextprotocol/sdk
- Streamable HTTP transport: POST, GET и DELETE для /mcp
- Express: /mcp, /health и /llms.txt
Контракты и данные
- Zod-схемы для публичных input/output и кодов ошибок
- Непрозрачные public IDs и короткоживущий slotToken
- Booking API с server-to-server X-API-Key и валидацией ответов
Защита записи
- Явное userConfirmed и personalDataConsent
- Idempotency key и повторная проверка доступности слота
- Независимые kill-switches в MCP и Booking API
05 / Materials
Визуальные материалы кейса
Материалы показывают интерфейс, архитектурную иллюстрацию или рабочий сценарий — в зависимости от формата проекта.
Product surfaces
AI-иллюстрация объясняет продуктовый принцип. Реальная граница в коде: AI-клиент → NailLounge MCP → защищённый Booking API → cache/YCLIENTS-контур; запись разрешается только после подтверждения и серверной перепроверки.
Мобильный продукт под ваш бренд
Безопасный AI-канал записи для сервисного бизнеса
Такой контур можно адаптировать для сети салонов, клиник, фитнеса или любой услуги с расписанием. Мы подключаем AI-каналы к существующему Booking API или CRM, сохраняя контроль над данными, подтверждением и реальным созданием визита.
Обсудить AI-интеграцию- AI-клиенты, голосовые агенты и внутренние ассистенты
- Ваши услуги, специалисты, филиалы и правила доступности
- CRM, booking API или существующий серверный контур
- Пошаговое включение write-операций после end-to-end проверки
Связанные материалы
Как этот проект связан с экосистемой NailLounge
Вопросы, которые чаще всего задают по проекту
Коротко по техническим и продуктовым решениям NailLounge.
Приём заявок временно приостановлен
Мы временно не обрабатываем заявки через форму. Свяжитесь с нами напрямую:
- Email: it@nextprism.ru
- Телефон: +7 904 555 92 92