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

MCP-сервер DHTMLX Spreadsheet: формулы, форматирование и API для работы с листами

Приложения на основе DHTMLX Spreadsheet требуют точной работы с формулами, форматированием ячеек, загрузкой данных и управлением листами. Ничего из этого не почерпнуть из данных, заученных при обучении модели: нужны актуальный синтаксис формул, методы API, которые Spreadsheet предоставляет уже сегодня, и параметры конфигурации, которые с тех пор не менялись.

MCP-сервер DHTMLX решает эту проблему, предоставляя ассистенту прямой доступ к актуальной справочной информации по Spreadsheet прямо в процессе работы. Направьте его к форматам чисел, Sheet Manager API или загрузке данных, и он сверится с актуальной документацией, прежде чем сгенерировать хотя бы одну строку кода.

Конечная точка MCP​

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

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

Возможности MCP-сервера для Spreadsheet​

Каждая страница документации DHTMLX Spreadsheet доступна для поиска через MCP-сервер. Типичные сценарии использования:

Как ассистент отправляет запросы к MCP-серверу​

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

Рассмотрим в качестве примера запрос: «Как настроить DHTMLX Spreadsheet, чтобы он получал актуальные биржевые котировки из фида рыночных данных моей компании и форматировал их как валюту?»

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

Результат: генерация кода для Spreadsheet остаётся привязанной к актуальному API формул и форматирования.

Настройка MCP-сервера в вашем AI-инструменте​

Регистрация MCP-сервера выполняется один раз для каждого инструмента с помощью команды CLI или фрагмента конфигурации JSON, в зависимости от инструмента. В любом случае укажите в вашем инструменте следующий URL:

https://docs.dhtmlx.com/mcp

После этого каждый проект Spreadsheet, открытый в этом инструменте, получает доступ к актуальной документации.

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

Claude Code​

К сведению

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

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

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​

К сведению

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

Чтобы добавить сервер:

  1. Откройте настройки (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​

К сведению

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

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

  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.

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

В настройках любого другого AI-инструмента для написания кода найдите раздел «Model Context Protocol» или «Context Sources» и добавьте туда https://docs.dhtmlx.com/mcp в качестве пользовательского источника.

Примечания о конфиденциальности данных​

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

Запросы могут логироваться в целях отладки и улучшения сервиса.

Организациям, которым требуется более строгий контроль конфиденциальности, доступен коммерческий вариант развёртывания с отключённым логированием запросов. По вопросам обращайтесь по адресу info@dhtmlx.com.

Примеры запросов для создания таблиц​

Чем конкретнее цель в вашем запросе, тем точнее ассистент сможет обратиться к нужной части API Spreadsheet. Запросы ниже сгруппированы по категориям задач и готовы к копированию и адаптации под ваши данные.

Загрузка и экспорт данных

Я хочу загрузить данные в DHTMLX Spreadsheet из JSON-файла. Как это сделать?
Как экспортировать DHTMLX Spreadsheet в файл Excel? Какой метод нужно вызвать?
В чём разница между методами load() и parse() DHTMLX Spreadsheet при работе с данными JSON?

Работа с ячейками и диапазонами

Как добавить проверку данных с выпадающим списком для ячеек в DHTMLX Spreadsheet? Используй документацию.
Как использовать setStyle(), чтобы применить цвет фона и форматирование текста к диапазону ячеек в DHTMLX Spreadsheet?
Как объединить ячейки и задать выравнивание для определённого диапазона в DHTMLX Spreadsheet?

Формулы и проверка данных

Какие функции формул доступны в DHTMLX Spreadsheet и как использовать пользовательские формулы?
Как задать тип ячейки «выпадающий список» для столбца в DHTMLX Spreadsheet?

Столбцы, строки и листы

Как закрепить определённые строки и столбцы в DHTMLX Spreadsheet?
Как программно добавлять листы и переключаться между ними в DHTMLX Spreadsheet?
Как обработать событие afterEditEnd и получить обновлённое значение ячейки?

Советы по составлению запросов для работы со Spreadsheet​

  • Назовите целевой объект. Различайте экземпляр таблицы, конкретный лист, ячейку и диапазон. Например: «на уровне экземпляра таблицы», «для конкретного диапазона ячеек» или «на листе 2». Чем точнее указана цель, тем легче серверу найти нужные страницы справочника.
  • Указывайте тип ячейки или формат данных. Запросы вроде «формат даты» или «числовой формат с двумя знаками после запятой» помогают получить более точную документацию, чем обобщённое «ячейка». Указывайте тип всякий раз, когда настраиваете столбцы или применяете форматы.
  • Добавляйте в запрос фразу «Используй документацию». Она сигнализирует ассистенту, что нужно выполнить обращение к MCP вместо ответа только на основе данных обучения. Это особенно полезно при работе с формулами или проверкой данных, где данные обучения чаще всего устаревают.
  • Чётко указывайте область действия операции. Операции в Spreadsheet могут применяться к одной ячейке, диапазону, целому столбцу или строке либо ко всему листу. Явно указывайте область действия (например, «для всего столбца B» или «по всем листам»), чтобы ассистент выбрал правильную перегрузку метода или путь API.
Need more help?Contact Support