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

MCP-сервер DHTMLX Kanban: карточки, редактор и REST-синхронизация

Рабочая доска DHTMLX Kanban складывается из нескольких частей, которые должны быть согласованы между собой: поля карточки и редактора связываются общим ключом, Toolbar работает как отдельный виджет, привязанный к доске, а синхронизация с сервером опирается на конкретный набор обработчиков действий. Сгенерированный код оказывается рабочим тогда, когда в нём совпадают ключи полей карточки и редактора, Toolbar подключён отдельно, а синхронизация с сервером построена на сегодняшних обработчиках действий, а не на срезе из обучающей выборки.

MCP-сервер DHTMLX заставляет ассистента работать с актуальной документацией Kanban, а не строить догадки. Спросите про привязку полей редактора к полям карточки, кастомизацию Toolbar или подключение backend через RestDataProvider, и ассистент подтянет актуальный справочник, прежде чем писать код.

MCP-эндпоинт​

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

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

Документация Kanban через MCP-сервер​

Внутри сервер хранит полный индекс документации DHTMLX Kanban и готов обрабатывать запросы вроде таких:

  • Поиск актуального API Kanban - методы, события и свойства, включая сигнатуры и значения по умолчанию.
  • Генерация готового к запуску кода инициализации как для доски Kanban, так и для отдельного конструктора Toolbar.
  • Настройка полей карточки и редактора (cardShape, editorShape) и их связывание по ключу, включая типы полей combo, multiselect, color, date и files.
  • Кастомизация шаблонов карточек, контекстных меню и заголовков колонок через описанные в документации калбэки шаблонов.
  • Стилизация колонок, строк и карточек с помощью CSS-переменных и условных CSS-классов.
  • Локализация интерфейсов Kanban и Toolbar через встроенные или собственные объекты локали.
  • Загрузка, экспорт и изменение карточек, колонок, строк, связей и комментариев через API данных.
  • Подключение REST-backend через RestDataProvider или настройка мультипользовательской доски, которая синхронизирует изменения по WebSocket.
  • Интеграция Kanban с другими виджетами DHTMLX, такими как Gantt и Scheduler, или с React, Vue, Angular и Svelte.

Что запрос про Kanban запускает в MCP​

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

Разберём по шагам на примере запроса «Как подключить DHTMLX Kanban так, чтобы при добавлении пользователем новой карточки она автоматически синхронизировалась с моей базой данных на backend?»:

  1. Ассистент выделяет часть, для которой нужна документация: как RestDataProvider синхронизирует новую карточку с сервером.
  2. Сервер сопоставляет это с документацией по интеграции с сервером.
  3. Поскольку ответ требует генерации кода, запрос уходит в Search (вопрос с одним правильным ответом вместо этого попал бы в Inference).
  4. Search достаёт подходящие страницы из векторного индекса, построенного на актуальной документации Kanban.
  5. Ассистент получает эти страницы обратно в качестве контекста.
  6. На основе этого контекста ассистент настраивает RestDataProvider для операции add-card, а специфичные для вашего backend детали запроса дополняет из собственных знаний, а не гадает об API Kanban.

Предлагаемый код для Kanban остаётся согласованным с тем API, который работает сегодня.

Регистрация MCP-сервера в разных инструментах​

И через терминал, и через файл конфигурации вы указываете инструменту приведённый ниже URL, и после регистрации сервер доступен для любой доски Kanban, которую вы собираете в этом инструменте.

https://docs.dhtmlx.com/mcp

Ниже описаны шаги настройки для самых распространённых инструментов.

Claude Code​

К сведению

Все поддерживаемые способы регистрации MCP-сервера описаны в документации самого Claude Code.

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

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

Настраиваете вручную? Добавьте такую запись в .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 приведено в официальной документации.

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

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

Antigravity CLI​

К сведению

Отдельное руководство описывает переход с Gemini CLI на Antigravity CLI.

Чтобы подключить MCP-сервер DHTMLX к 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.

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

Инструменты, для которых здесь нет отдельного раздела, обычно тоже поддерживают MCP. В настройках это чаще всего называется "Model Context Protocol" или "Context Sources". Добавьте туда https://docs.dhtmlx.com/mcp как пользовательский источник.

Что MCP-сервер делает с вашими данными​

MCP-сервер размещён на нашей стороне: на вашей машине ничего не запускается, файлы вашего проекта не читаются, персональные данные не сохраняются.

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

При более строгих требованиях к приватности организации могут запросить коммерческое развёртывание с отключённым логированием запросов. За подробностями пишите на info@dhtmlx.com.

Готовые запросы для доски Kanban​

Запросы ниже сгруппированы по той части API, к которой они относятся. Возьмите подходящий и подстройте детали под свою доску.

Карточки, колонки и строки

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

Редактор и типы полей

Как привязать собственное поле редактора к полю карточки, чтобы оно отображалось и на карточке, и в редакторе?
Как настроить поле multiselect с аватарами пользователей в редакторе DHTMLX Kanban?
Как включить автосохранение с задержкой debounce в редакторе DHTMLX Kanban?

Toolbar и элементы управления доской

Как добавить собственный элемент поиска в Toolbar Kanban и связать его с доской?
Как убрать кнопки undo и redo из Toolbar DHTMLX Kanban?

REST и мультипользовательская синхронизация

Как подключить DHTMLX Kanban к backend на Go и загрузить начальные данные?
Как настроить, каким образом DHTMLX Kanban синхронизирует конкретное действие с моим backend?
Как настроить мультипользовательскую доску DHTMLX Kanban, которая синхронизирует изменения в реальном времени по WebSocket?

Как получить более точные ответы по Kanban​

  • Называйте целевой элемент. Различайте доску, колонку, строку (swimlane) и карточку (например, "на доске Kanban", "для конкретной строки", "на карточке в колонке Testing"). Точно названная цель помогает серверу подобрать нужные страницы справочника.
  • Указывайте тип поля. cardShape и editorShape поддерживают множество типов полей (combo, multiselect, color, date, files). Называйте тип явно (например, "поле multiselect с аватарами") вместо просто "поле", и тогда ассистент подтянет подходящий раздел конфигурации.
  • Добавляйте "Используй документацию" в запрос. Эта фраза подсказывает ассистенту, что нужно обратиться к MCP, а не отвечать только по данным обучения. Особенно это важно для обработчиков RestDataProvider и конфигурации полей, где API меняется чаще всего.
  • Уточняйте, где выполняется операция: на клиенте или на сервере. Kanban работает как с локальными данными, так и с REST API через RestDataProvider. Укажите, что именно вам нужно (например, "через RestDataProvider" или "без backend"), чтобы ассистент не подмешивал специфичные для REST вызовы в клиентский пример.
Need more help?Contact Support