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

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

Что может ИИ?

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

Требования

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

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

Настройка

1. Включение сервера MCP

  1. Откройте Diagrammix
  2. Перейдите в Diagrammix > Settings (или нажмите Cmd+,)
  3. Перейдите на вкладку AI Integration
  4. Включите Enable AI Integration (MCP Server)

Сервер запускается по адресу http://localhost:8420/mcp.

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

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

  1. Нажмите Copy Config в настройках Diagrammix — это подставит точный путь к встроенному помощнику для вашей установки
  2. Откройте файл конфигурации Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
  3. Вставьте конфигурацию. Она выглядит так — путь command указывает на помощник внутри того места, где установлен Diagrammix.app:
{
  "mcpServers": {
    "diagrammix": {
      "command": "/Applications/Diagrammix.app/Contents/MacOS/diagrammix-mcp-stdio",
      "args": ["--url", "http://localhost:8420/mcp"]
    }
  }
}

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

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

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

Добавьте в .mcp.json вашего проекта или глобально в ~/.claude/mcp.json:

{
  "mcpServers": {
    "diagrammix": {
      "type": "url",
      "url": "http://localhost:8420/mcp"
    }
  }
}

Claude Code поддерживает Streamable HTTP нативно — мост не требуется.

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

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

Вариант A — config.toml. Нажмите Copy Config в разделе 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. Нажмите Copy Command в настройках 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 напрямую.

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

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

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

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

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

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

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

Автоматическая компоновка

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

ИИ вызывает apply_layout с вашим предпочтительным направлением и интервалом.

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

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

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

Советы

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