Перейти к основному содержимому

DHTMLX Booking MCP-сервер: слоты, фильтры и бронирования

DHTMLX Booking предоставляет детальную конфигурацию виджета бронирования. Вы можете задавать правила слотов вплоть до дня недели или конкретной даты, менять раскладку карточки (для этого достаточно переключить её поля по умолчанию или подставить пользовательский шаблон) и полностью настраивать обработчик бронирования, который завершает процесс бронирования. Приоритет правил слотов, подход к раскладке и контракт бронирования в Booking должны соответствовать тому, что поставляется сегодня, а не догадке на основе обучающих данных.

Обращайтесь вместо этого к DHTMLX MCP-серверу, который предоставляет актуальные правила конфигурации слотов, контракт обработчика подтверждения и настройку фильтра. Ассистент работает с текущим API, а не с устаревшим.

MCP-эндпоинт​

https://docs.dhtmlx.com/mcp
Примечание

DHTMLX MCP-сервер охватывает все основные продукты DHTMLX, а не только DHTMLX Booking. Один и тот же эндпоинт и те же инструкции по настройке работают независимо от того, с каким компонентом DHTMLX вы работаете.

Вопросы о Booking, на которые рассчитан MCP-сервер​

Карточки, слоты и логика синхронизации с сервером в DHTMLX Booking входят в поисковый индекс MCP-сервера. Чаще всего запрашивают следующее:

Что MCP-сервер делает с запросом о Booking​

За вопросом о Booking стоит конвейер Retrieval-Augmented Generation (RAG), который DHTMLX MCP-сервер выполняет поверх Model Context Protocol (MCP). Сервер передаёт каждый запрос в один из двух сценариев: Search, который возвращает подходящие страницы справочника, или Inference, который читает эти страницы и отвечает самостоятельно. Поскольку запросы о Booking часто смешивают вопрос по коду с деталями собственного бэкенда пользователя, ассистент обрабатывает эти части по отдельности: он выделяет ту, для которой нужна документация, а на остальное отвечает сам.

Проследите путь запроса «Как настроить обработчик подтверждения, который отправляет бронирование во внутренний API управления бронированиями моей компании и разрешает его, как только тот ответит?» по этому процессу:

  1. В MCP попадает узкая часть: как построить обработчик подтверждения на полях confirm, slot и data.
  2. Сервер сопоставляет её с документацией по интеграции с сервером.
  3. Написание обработчика подтверждения требует кода, поэтому запрос забирает Search. Более узкий вопрос, например о том, какой параметр содержит время начала забронированного слота, ушёл бы в Inference.
  4. Search достаёт подходящие страницы из векторного индекса, построенного по актуальной документации Booking.
  5. Эти страницы возвращаются ассистенту в качестве контекста.
  6. Ассистент собирает обработчик подтверждения из полей confirm, slot и data, описанных на этих страницах, а затем дописывает конкретную обработку запроса и ответа для целевого бэкенда, опираясь на собственные знания.

Так предложения по Booking остаются привязанными к актуальным правилам слотов и логике бронирования виджета.

Настройка MCP: инструмент за инструментом​

Большинство команд, работающих с Booking, регистрируют MCP-эндпоинт один раз, при настройке бэкенда бронирований, а затем переиспользуют эту регистрацию во всех последующих проектах. Механика различается от инструмента к инструменту: где-то это команда CLI, где-то файл конфигурации JSON, но все они указывают на один адрес:

https://docs.dhtmlx.com/mcp

Выберите свой инструмент ниже, чтобы увидеть точные шаги настройки.

Claude Code​

К сведению

В официальной документации перечислены все способы подключения Claude Code к MCP-серверу.

Чтобы зарегистрировать сервер из командной строки, выполните:

claude mcp add --transport http dhtmlx-mcp https://docs.dhtmlx.com/mcp

Предпочитаете обойтись без CLI? Тогда добавьте в свой .mcp.json следующую запись:

{
  "mcpServers": {
    "dhtmlx-mcp": {
      "type": "http",
      "url": "https://docs.dhtmlx.com/mcp"
    }
  }
}

Cursor​

К сведению

Официальная документация описывает все способы настройки MCP в Cursor.

Шаги для добавления сервера:

  1. Откройте Settings (Cmd+Shift+J на Mac, Ctrl+Shift+J на Windows/Linux)
  2. Перейдите в Tools & MCP
  3. Нажмите Add Custom MCP
  4. Вставьте следующую конфигурацию:
{
  "mcpServers": {
    "dhtmlx-mcp": {
      "url": "https://docs.dhtmlx.com/mcp"
    }
  }
}

Google Antigravity​

Antigravity 2.0​

К сведению

Полные сведения об интеграции MCP в Antigravity приведены в официальной документации.

Чтобы подключить DHTMLX MCP-сервер к Google Antigravity, выполните следующие шаги:

  1. Откройте палитру команд
  2. Введите «mcp add»
  3. Выберите «HTTP»
  4. Укажите следующие значения:
  • Имя:
dhtmlx-mcp
  • URL:
https://docs.dhtmlx.com/mcp

Antigravity CLI​

К сведению

Переходите с Gemini CLI? Соответствующее руководство описывает миграцию на Antigravity CLI.

Чтобы подключить DHTMLX MCP-сервер к Antigravity CLI, создайте файл mcp_config.json в одном из следующих мест:

  • Глобально: ~/.gemini/config/mcp_config.json
  • В рабочей области: .agents/mcp_config.json

Добавьте следующую конфигурацию:

{
  "mcpServers": {
    "dhtmlx-mcp": {
      "serverUrl": "https://docs.dhtmlx.com/mcp"
    }
  }
}

Затем выполните в терминале agy.

ChatGPT​

К сведению

ChatGPT полностью описывает настройку MCP-коннектора в официальной документации.

Шаги для настройки коннектора:

  1. Перейдите в Settings → Apps & Connectors
  2. Нажмите Advanced settings
  3. Включите Developer mode
  4. Вернитесь в Apps & Connectors и нажмите «Create»
  5. Заполните данные коннектора:
  • Имя:
dhtmlx-mcp
  • URL:
https://docs.dhtmlx.com/mcp
  • Аутентификация: No authentication
  1. Нажмите Create

После создания коннектора ChatGPT подтягивает документацию с MCP-сервера во время диалогов.

К сведению

Для интенсивной работы с кодом другие инструменты с поддержкой MCP могут подойти лучше.

Другие инструменты​

Если вашего инструмента нет в списке выше, поищите в его настройках «Model Context Protocol» или «Context Sources» и добавьте https://docs.dhtmlx.com/mcp как пользовательский источник.

Как MCP-сервер обращается с данными​

DHTMLX MCP-сервер работает полностью вне вашей машины: он не обращается к локальным файлам и не хранит никакой персональной информации.

Логируются только те запросы, которые помогают в отладке или улучшении сервиса.

Коммерческое развёртывание полностью отключает логирование запросов для команд, которым нужна дополнительная гарантия. Договориться о нём можно по адресу info@dhtmlx.com.

Запросы, которые стоит попробовать при работе с Booking​

Называйте объект прежде, чем задать вопрос: карточка, слот, фильтр или обработчик подтверждения. Запросы ниже делают именно это и сгруппированы по задачам.

Карточки и слоты

Как скрыть поля цены и отзывов на карточке Booking? Используй документацию.
Как задать длительность слота в 45 минут только для вторников и пятниц в DHTMLX Booking?
Как пометить слот как уже забронированный в DHTMLX Booking?

Фильтрация

Как добавить пользовательский диапазон времени с меткой «Срочно» в панель фильтра DHTMLX Booking?
Как сделать, чтобы фильтр Booking применялся автоматически, без нажатия кнопки Search?

Бронирования и синхронизация с сервером

Как отправить бронирование на мой сервер и разрешить его, как только сервер ответит?
Как загрузить данные карточек с REST-эндпоинта и применить их к существующему экземпляру Booking?
Как отреагировать на подтверждённое бронирование, не заменяя обработчик подтверждения по умолчанию в DHTMLX Booking?

Локализация и стилизация

Как переключить DHTMLX Booking на немецкую локаль?
Как сделать колонку слотов Booking уже?

Полезные привычки при составлении запросов о Booking​

  • Называйте конкретное свойство. cardShape, cardTemplate, infoShape, infoTemplate, filterShape и formShape настраивают разные части виджета. Указывайте, какое именно вы имеете в виду, вместо «конфигурация карточки», чтобы ассистент нашёл подходящую страницу справочника.
  • Называйте нужное свойство слотов. slots задаёт правила доступности, usedSlots скрывает уже забронированное время, а availableSlots заменяет правила явным списком. Называя нужное, вы не дадите ассистенту смешать их в одно свойство.
  • Различайте публичный API и Event Bus. setConfig() и setConfirmHandler() покрывают большую часть повседневной настройки, тогда как api.on(), api.exec(), api.intercept() и api.setNext() обращаются к внутреннему Event Bus. Указывайте, какой уровень вы имеете в виду, если запрос касается событий.
  • Упоминайте часовой пояс. Booking работает в локальном времени, поэтому в запросе, затрагивающем серверные данные, стоит указать, приходят ли метки времени в UTC и нужно ли их конвертировать перед передачей в виджет.
Need more help?Contact Support