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

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

Что может ИИ?

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

Требования

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

Настройка

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, поэтому требуется мост mcp-remote (Node.js 18+).

  1. Нажмите Copy Config в настройках Diagrammix, чтобы скопировать конфигурацию в буфер обмена
  2. Откройте файл конфигурации Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
  3. Вставьте конфигурацию или добавьте вручную:
{
  "mcpServers": {
    "diagrammix": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8420/mcp"]
    }
  }
}

Примечание: Если вы используете nvm, кнопка Copy Config определяет вашу установку Node.js и генерирует конфигурацию с полным путём к npx и правильной переменной окружения PATH.

  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

  1. Откройте настройки Codex > MCP servers
  2. Нажмите Connect to a custom MCP
  3. Установите Name как Diagrammix
  4. Выберите вкладку Streamable HTTP
  5. Введите URL: http://localhost:8420/mcp
  6. Нажмите Save

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 с вашим предпочтительным направлением и интервалом.

Советы

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