
draw.io MCP: схемы и диаграммы агентом в Claude, Codex и Cursor
Агент рисует блок-схемы, схемы процессов и архитектуры в draw.io: из XML, Mermaid или CSV, с иконками AWS, Azure, GCP и Cisco. Диаграмма открывается в редакторе или прямо в чате.
Удалённый сервер от авторов draw.io: ставить ничего не нужно, в клиентах с MCP Apps диаграмма показывается прямо в чате с кнопкой «Open in draw.io».
Как подключить
Что сделать до подключения
Клиент с удалёнными MCP-серверами: Claude.ai, ChatGPT, VS Code с GitHub Copilot, Cursor, GitHub Copilot CLI; в Claude.ai draw.io есть в каталоге коннекторов
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --transport http draw-io https://mcp.draw.io/mcpПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.draw-io]
url = "https://mcp.draw.io/mcp"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"draw-io": {
"url": "https://mcp.draw.io/mcp"
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"draw-io": {
"type": "http",
"url": "https://mcp.draw.io/mcp"
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"draw-io": {
"httpUrl": "https://mcp.draw.io/mcp"
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"draw-io": {
"httpUrl": "https://mcp.draw.io/mcp"
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"draw-io": {
"type": "remote",
"url": "https://mcp.draw.io/mcp"
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.draw.io/mcpПроверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"draw-io": {
"url": "https://mcp.draw.io/mcp"
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
create_diagramрисует диаграмму из XML или Mermaidsearch_shapesищет фигуры и иконкиget_drawio_referenceотдаёт справку по форматуЛокальный пакет npm от тех же авторов: открывает диаграмму в редакторе draw.io в браузере, понимает XML, CSV и Mermaid и правит отдельные страницы .drawio-файла.
Как подключить
Что сделать до подключения
Node.js с командой npx
DRAWIO_BASE_URLнеобязательно: адрес своего сервера draw.io вместо https://app.diagrams.net/
DRAWIO_BROWSERнеобязательно: off — только вернуть ссылку, без открытия браузера
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --transport stdio drawio-mcp \
-- npx -y @drawio/mcpПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.drawio-mcp]
command = "npx"
args = ["-y", "@drawio/mcp"]Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"drawio-mcp": {
"command": "npx",
"args": ["-y", "@drawio/mcp"]
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"drawio-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@drawio/mcp"]
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"drawio-mcp": {
"command": "npx",
"args": ["-y", "@drawio/mcp"]
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"drawio-mcp": {
"command": "npx",
"args": ["-y", "@drawio/mcp"]
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"drawio-mcp": {
"type": "local",
"command": ["npx", "-y", "@drawio/mcp"]
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"drawio-mcp": {
"command": "npx",
"args": ["-y", "@drawio/mcp"]
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"drawio-mcp": {
"command": "npx",
"args": ["-y", "@drawio/mcp"]
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
open_drawio_xmlоткрывает диаграмму из XMLopen_drawio_csvстроит диаграмму из CSVopen_drawio_mermaidоткрывает диаграмму из Mermaidsearch_shapesищет фигуры среди 10 000get_drawio_referenceотдаёт справку по XML или Mermaidlist_pagesвыводит страницы .drawio-файлаget_pageчитает XML страницыset_pageзаменяет содержимое страницыРаботает с живой диаграммой: свой редактор на localhost:3000 или расширение браузера, агент читает выделение и правит фигуры, связи, страницы и слои по одной.
Как подключить
Что сделать до подключения
Node.js 22 или новее
После перезапуска клиента открыть встроенный редактор http://localhost:3000/ или поставить расширение Draw.io MCP для Chrome или Firefox и открыть app.diagrams.net
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --transport stdio drawio-mcp-server \
-- npx -y drawio-mcp-server --editorПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.drawio-mcp-server]
command = "npx"
args = ["-y", "drawio-mcp-server", "--editor"]Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"drawio-mcp-server": {
"command": "npx",
"args": ["-y", "drawio-mcp-server", "--editor"]
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"drawio-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "drawio-mcp-server", "--editor"]
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"drawio-mcp-server": {
"command": "npx",
"args": ["-y", "drawio-mcp-server", "--editor"]
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"drawio-mcp-server": {
"command": "npx",
"args": ["-y", "drawio-mcp-server", "--editor"]
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"drawio-mcp-server": {
"type": "local",
"command": ["npx", "-y", "drawio-mcp-server", "--editor"]
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"drawio-mcp-server": {
"command": "npx",
"args": ["-y", "drawio-mcp-server", "--editor"]
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"drawio-mcp-server": {
"command": "npx",
"args": ["-y", "drawio-mcp-server", "--editor"]
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
list-documentsвыводит подключённые диаграммыget-selected-cellчитает выделенный элементget-shape-by-nameнаходит фигуру библиотекиlist-paged-modelвыводит элементы страницыshow-diagramпоказывает редактор в чатеadd-rectangleдобавляет прямоугольникadd-cell-of-shapeдобавляет фигуру из библиотекиadd-edgeпроводит связьedit-cellменяет текст, размер и стильedit-edgeменяет связьdelete-cell-by-idудаляет элементset-cell-shapeменяет вид фигурыlist-pagesвыводит страницыcreate-pageсоздаёт страницуlist-layersвыводит слоиcreate-layerсоздаёт слойmove-cell-to-layerпереносит элемент на слойexport-diagramвыгружает XML, SVG или PNGimport-mermaidвставляет диаграмму Mermaidsave-documentсохраняет документПоказано 20 из 31.
Форк lgazo без браузера: собирает XML draw.io в памяти, несёт 700 с лишним иконок Azure с нечётким поиском и пакетные операции; работает офлайн и в Docker.
Как подключить
Что сделать до подключения
Deno 2.3 или новее
Склонировать репозиторий: зависимости Deno подтянет при первом запуске
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --transport stdio drawio-mcp-server \
-- deno run --allow-net --allow-read --allow-env /path/to/drawio-mcp-server/src/index.tsПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.drawio-mcp-server]
command = "deno"
args = ["run", "--allow-net", "--allow-read", "--allow-env", "/path/to/drawio-mcp-server/src/index.ts"]Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"drawio-mcp-server": {
"command": "deno",
"args": [
"run",
"--allow-net",
"--allow-read",
"--allow-env",
"/path/to/drawio-mcp-server/src/index.ts"
]
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"drawio-mcp-server": {
"type": "stdio",
"command": "deno",
"args": [
"run",
"--allow-net",
"--allow-read",
"--allow-env",
"/path/to/drawio-mcp-server/src/index.ts"
]
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"drawio-mcp-server": {
"command": "deno",
"args": [
"run",
"--allow-net",
"--allow-read",
"--allow-env",
"/path/to/drawio-mcp-server/src/index.ts"
]
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"drawio-mcp-server": {
"command": "deno",
"args": [
"run",
"--allow-net",
"--allow-read",
"--allow-env",
"/path/to/drawio-mcp-server/src/index.ts"
]
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"drawio-mcp-server": {
"type": "local",
"command": [
"deno",
"run",
"--allow-net",
"--allow-read",
"--allow-env",
"/path/to/drawio-mcp-server/src/index.ts"
]
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"drawio-mcp-server": {
"command": "deno",
"args": [
"run",
"--allow-net",
"--allow-read",
"--allow-env",
"/path/to/drawio-mcp-server/src/index.ts"
]
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"drawio-mcp-server": {
"command": "deno",
"args": [
"run",
"--allow-net",
"--allow-read",
"--allow-env",
"/path/to/drawio-mcp-server/src/index.ts"
]
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
search-shapesищет фигуры и иконки Azureget-style-presetsотдаёт готовые стилиadd-cellsдобавляет фигуры и связи пачкойedit-cellsменяет фигуры пачкойedit-edgesменяет связиcreate-groupsсоздаёт группы и контейнерыadd-cells-to-groupкладёт элементы в группуcreate-layerсоздаёт слойcreate-pageсоздаёт страницуget-diagram-statsсчитает элементы и границыexport-diagramвыгружает XML draw.ioimport-diagramзагружает XML draw.ioЧто попросить агента
Для каких задач
Ограничения
Удалённый сервер mcp.draw.io получает диаграмму вместе с запросом; чтобы она не покидала машину, берите @drawio/mcp или разверните App Server у себя
Прямо в чате диаграмма видна только в клиентах с MCP Apps, остальные получают ссылку на draw.io
Инструменты страниц @drawio/mcp работают только с локальными файлами: Google Drive, OneDrive, Dropbox, GitHub и GitLab сервер не читает
Сервер simonkurtz без состояния между вызовами: каждый раз передаётся весь diagram_xml; у проекта 82 звезды и последнее обновление в мае 2026 года
Если не работает
Error: Port 3333 is already in use
Клиент получает ECONNREFUSED или 404 на /mcp у сервера lgazo
Claude Desktop рисует схему своими средствами вместо draw.io
Браузер открывается не на той машине: агент в SSH или CI
Какую реализацию выбрать
| Реализация | Кто делает | Звёзды | Запуск | Ключ | Инструменты | Обновлён |
|---|---|---|---|---|---|---|
| draw.io MCP App Serverразработчик сервиса | JGraph (draw.io) | 5,8 тыс. | HTTP | не нужен | 3 | 11 ноября 2026 |
| draw.io MCP Tool Server (@drawio/mcp)разработчик сервиса | JGraph (draw.io) | 5,8 тыс. | локально | не нужен | 8 | 11 ноября 2026 |
| Draw.io MCP server | Ladislav Gazo (lgazo) | 1,5 тыс. | локально | не нужен | 31 | 1 ноября 2026 |
| Draw.io MCP Server (simonkurtz) | Simon Kurtz | 82 | локально | не нужен | 12 | 15 мая 2026 |