Интеграция с ИИ (MCP-сервер)

Diagrammix включает встроенный MCP-сервер (Model Context Protocol), который позволяет ИИ-ассистентам вроде Claude и Codex напрямую читать и изменять ваши диаграммы. Опишите, что вам нужно, обычным языком — и ИИ сам разместит на холсте символы, коннекторы и компоновку.

Что умеет ИИ?

Создание диаграмм по описанию — попросите блок-схему, топологию сети или оргструктуру — и получите их на холсте мгновенно
Построение интеллект-карт — опишите тему и получите структурированную интеллект-карту
Чтение документа — ИИ видит текущие фигуры, коннекторы, слои и стили
Изменение существующих элементов — обновление текста, цветов, позиций или маршрутизации коннекторов
Пакетные операции — создание целых диаграмм с символами и коннекторами за один шаг
Автокомпоновка и выравнивание — упорядочивание элементов командами на естественном языке
Воспроизведение внешнего вида по изображению — дайте ИИ референсную картинку, и он создаст подходящий пользовательский шаблон и стиль
Экспорт — получение SVG, PNG, Visio (.vsdx) или Mermaid по запросу

Требования

Diagrammix PRO (единовременная покупка)
Diagrammix должен быть запущен с включённым MCP-сервером
Если ни один документ не открыт, ассистент может создать новый
ИИ-клиент и Diagrammix должны находиться на одном компьютере (localhost)

Node.js, npx или mcp-remote не требуются — для клиентов, которым это нужно, Diagrammix включает нативный вспомогательный модуль.

Настройка

1. Включите MCP-сервер

Откройте Diagrammix
Перейдите в Diagrammix > Настройки (или нажмите Cmd+,)
Переключитесь на вкладку Интеграция ИИ
В разделе MCP-сервер включите Включить MCP-сервер

Статус покажет Работает, как только сервер запустится. Сервер слушает http://localhost:8420/mcp.

2. Настройте Claude Desktop

Claude Desktop подключается через stdio. Diagrammix поставляет нативный stdio-помощник внутри бандла приложения, поэтому Node.js, npx или mcp-remote не требуются.

Нажмите Копировать конфигурацию в настройках Diagrammix — это подставит точный путь к встроенному помощнику для вашей установки
Откройте файл конфигурации Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
Вставьте конфигурацию. Она выглядит так — путь command указывает на помощника внутри места установки Diagrammix.app:

{
  "mcpServers": {
    "diagrammix": {
      "command": "/Applications/Diagrammix.app/Contents/MacOS/diagrammix-mcp-stdio",
      "args": ["--url", "http://localhost:8420/mcp"]
    }
  }
}

Примечание: используйте Копировать конфигурацию, а не вводите путь вручную — она указывает на помощника внутри вашего реального бандла приложения, который Diagrammix поддерживает подписанным и актуальным.

Перезапустите Claude Desktop. Инструменты Diagrammix появятся в чате.

3. Настройте Claude Code (CLI)

Claude Code изначально поддерживает Streamable HTTP — мост не нужен. Добавьте MCP-сервер типа HTTP, указывающий на:

http://localhost:8420/mcp

Команду или файл конфигурации ищите в документации Claude Code по MCP.

4. Настройте Codex

Codex (приложение, CLI и расширение для IDE используют общую конфигурацию MCP) подключается через Streamable HTTP. Настройте любым из способов:

Вариант A — config.toml. Нажмите Копировать конфигурацию в разделе Codex настроек Diagrammix и вставьте в ~/.codex/config.toml:

[mcp_servers.diagrammix]
url = "http://localhost:8420/mcp"
enabled = true
default_tools_approval_mode = "prompt"
startup_timeout_sec = 20
tool_timeout_sec = 60

Вариант B — CLI. Нажмите Копировать команду в настройках Diagrammix или выполните:

codex mcp add diagrammix --url http://localhost:8420/mcp

5. Другие MCP-клиенты

Любой MCP-совместимый клиент может подключиться, используя:

Транспорт: Streamable HTTP
Конечная точка: http://localhost:8420/mcp
Протокол: JSON-RPC 2.0 через HTTP POST

Примечание: ChatGPT Desktop требует HTTPS и не поддерживает прямые подключения к localhost.

Основные инструменты

Diagrammix предоставляет большой набор MCP-инструментов. Вот некоторые из самых полезных:

Инструмент	Что делает
`batch_create`	Создаёт множество символов и коннекторов за один шаг отмены
`apply_diagram_plan` / `preview_diagram_plan`	Проверяет структурированный план диаграммы, затем применяет его как один отменяемый шаг
`get_elements` / `update_element`	Читает и изменяет существующие элементы
`apply_layout`	Запускает автокомпоновку
`create_mindmap`	Строит интеллект-карту из вложенного дерева или структуры Markdown
`import_mermaid`	Вставляет диаграмму из текста Mermaid
`generate_radial_diagram`	Генерирует радиальную инфографику — сегментированное кольцо, круги или лепестки — с надписями и цветами
`combine_shapes`	Булевы операции (объединение, вычитание, пересечение, исключение)
`create_artboard`	Добавляет монтажную область для экспорта
`set_document_palette` / `apply_palette`	Сохраняет цветовую палитру документа и перекрашивает диаграмму по ней
`create_style` / `apply_style`	Создаёт и применяет пользовательские стили
`export_svg`, `export_png`, `export_vsdx`, `export_mermaid`	Экспортирует диаграмму или выделение; `export_vsdx` превращает каждую монтажную область в страницу Visio
`undo` / `redo`	Отменяет и повторяет изменения

Примеры использования

Создание блок-схемы

«Создай блок-схему с элементами «Начало», «Решение», «Процесс A», «Процесс B» и «Конец». Соедини «Начало» с «Решением», «Решение» — с «Процессом A» (Да) и «Процессом B» (Нет), а оба процесса — с «Концом».»

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

Изменение существующей диаграммы

«Сделай заливку всех прямоугольников синей и выдели текст жирным.»

ИИ считывает элементы с помощью get_elements, а затем обновляет каждый из них с помощью update_element.

Автокомпоновка

«Примени компоновку сверху вниз с отступом 60 пикселей между рядами.»

ИИ вызывает apply_layout с нужным направлением и отступом.

Воспроизведение внешнего вида по изображению

«Вот скриншот фирменного стиля наших диаграмм. Воссоздай эти фигуры и цвета как пользовательский шаблон и стиль, которые я смогу использовать повторно.»

Дайте ассистенту референсное изображение — и он сможет сгенерировать подходящие SVG-фигуры и наконечники стрелок, собрать их в пользовательский шаблон и определить подходящий пользовательский стиль. Для этого используются такие инструменты, как create_custom_template, add_custom_shape, add_custom_arrowhead и create_style, поэтому результатом становится многоразовый набор, а не разовый рисунок.

Советы

Начните с описания — чем точнее вы опишете задачу, тем лучше будет результат
Итерируйте — попросите ИИ скорректировать цвета, надписи или компоновку после первоначального создания
Не бойтесь отменять — все изменения ИИ поддерживают отмену через Cmd+Z
Используйте символы нотации — попросите ИИ использовать конкретные наборы нотации для единообразного оформления
Пакетная обработка лучше — для новых диаграмм ИИ создаёт всё за один шаг, поэтому отмена откатывает всё сразу