Установка

Сервер опубликован в npm под именем @dineug/erd-editor-mcp. Это один самодостаточный файл без зависимостей времени выполнения, и npx загружает его, когда агент впервые запускает сервер, поэтому больше ничего устанавливать не нужно. Серверу требуется Node.js версии 22.12 или новее.

Чтобы агент мог редактировать диаграмму вживую, настройте также редактор, в котором она находится: VS Code, Obsidian или IDE JetBrains. Если ни один редактор не обслуживает документ, агент редактирует файл на диске — см. Режимы Live и Headless.

Claude Code

Выполните в папке проекта:

claude mcp add --transport stdio erd-editor -- npx -y @dineug/erd-editor-mcp

Добавьте --scope project перед --transport, чтобы вместо этого записать сервер в файл .mcp.json проекта, откуда его подхватывает каждый, кто клонирует проект.

Codex

Выполните один раз. Codex CLI, приложение и расширение для IDE используют общую настройку:

codex mcp add erd-editor -- npx -y @dineug/erd-editor-mcp

Или добавьте сервер в файл ~/.codex/config.toml либо в файл .codex/config.toml доверенного проекта:

[mcp_servers.erd-editor]
command = "npx"
args = ["-y", "@dineug/erd-editor-mcp"]

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

Запустите npx -y @dineug/erd-editor-mcp как stdio-сервер: команда — npx, а аргументы — -y и @dineug/erd-editor-mcp.

Сервер отсчитывает относительный путь к документу от своего рабочего каталога, поэтому запускайте его в папке проекта. Он поддерживает версии протокола MCP 2025-06-18, 2025-03-26 и 2024-11-05, а клиенту с более поздней версией отвечает версией 2025-06-18.

Настройка VS Code

Окно VS Code обслуживает диаграммы в папках своей рабочей области и любую диаграмму, открытую в нем.

1. Установите расширение ERD Editor версии 4.0.0 или новее. Ему требуется VS Code версии 1.101.0 или новее.
2. Откройте папку проекта и отметьте рабочую область как доверенную. Расширение обслуживает агентов только в доверенной рабочей области.
3. Оставьте настройку dineug.erd-editor.agentHub.enabled включенной. Она включена по умолчанию.

Расширение версий с 3.0.0 по 3.1.0 и сервер версии 1.0.0 отклоняют друг друга, а расширение до версии 3.0.0 не обслуживает агентов — см. Обновление.

Расширение запускается в рабочей области, содержащей файлы .erd, .erd.json, .vuerd или .vuerd.json, поэтому агент получает доступ к этим диаграммам еще до того, как вы откроете одну из них. В рабочей области без таких файлов оно запускается, когда вы открываете диаграмму, а до тех пор агент вносит правки на диске.

Настройка	Значение по умолчанию	Действие
dineug.erd-editor.agentHub.enabled	true	Позволяет MCP-серверу агента редактировать документы этого окна через локальный сокет, а в Windows — через именованный канал. Если настройка выключена или рабочая область не является доверенной, агенты по-прежнему могут читать диаграммы окна с диска, но никогда не записывают диаграмму в обход ее редактора.

Настройка Obsidian

Окно хранилища Obsidian обслуживает диаграммы в своем хранилище.

1. Установите плагин ERD Editor версии 1.0.0 или новее из раздела Community plugins и включите его. Он работает только в настольном приложении, и ему требуется Obsidian версии 1.5.7 или новее.
2. Оставьте параметр Settings → ERD Editor → Coding agents включенным. Он включен по умолчанию, и у каждого хранилища своя настройка.

Более ранняя версия плагина и сервер версии 1.0.0 отклоняют друг друга — см. Обновление.

Окно хранилища обслуживает агентов с момента загрузки плагина, поэтому агент получает доступ к диаграммам хранилища еще до того, как вы откроете одну из них. Подтверждать доверие не требуется. Файл, которого нет в списке файлов хранилища, например файл в папке, имя которой начинается с точки, нельзя открыть в ERD Editor, поэтому правка такого файла отклоняется.

Попросите агента давать новым диаграммам имена с расширением .erd. К имени без расширения добавляется .erd.json, а проводник файлов Obsidian показывает файл .erd.json, только пока включен параметр Settings → Files and links → Detect all file extensions.

Настройка	Значение по умолчанию	Действие
Coding agents	Включено	Позволяет MCP-серверу агента редактировать диаграммы этого хранилища через локальный сокет, а в Windows — через именованный канал. Если параметр выключен, агенты по-прежнему могут читать диаграммы хранилища с диска, но никогда не записывают диаграмму в обход ее редактора.

Obsidian, установленный из Flathub, работает в песочнице Flatpak, к которой у сервера нет доступа. В этом случае плагин не обслуживает агентов и не создает файл блокировки, поэтому агент редактирует файлы на диске, даже диаграмму, которая у вас открыта. Obsidian перезагружает диаграмму, как и после любого изменения, сделанного вне него, а ваша правка, которую он еще не сохранил, уступает место правке агента. Плагин сообщает об этом при каждом открытии хранилища, пока вы не выключите параметр Coding agents.

Настройка IDE JetBrains

IDE JetBrains обслуживает диаграммы каждого открытого в ней проекта и любую диаграмму, открытую в ее ERD Editor.

1. Установите плагин ERD Editor версии 1.0.0 или новее. Ему требуется IDE на основе IntelliJ версии 2025.2 или новее, работающая на JetBrains Runtime.
2. Откройте проект и отметьте его как доверенный. В проекте, которому IDE не доверяет, например в проекте, открытом в безопасном режиме, агенты читают диаграммы, но никогда их не изменяют.
3. Оставьте флажок Settings | Tools | ERD Editor → Coding agents установленным. Параметр включен по умолчанию и действует для всей IDE.

Плагин версии 0.9.0 или 0.10.0 и сервер версии 1.0.0 отклоняют друг друга, а плагин до версии 0.9.0 не обслуживает агентов — см. Обновление.

IDE обслуживает агентов с момента открытия первого проекта, поэтому агент получает доступ к диаграммам проекта еще до того, как вы откроете одну из них.

Настройка	Значение по умолчанию	Действие
Coding agents	Включено	Позволяет MCP-серверу агента редактировать диаграммы этой IDE через локальный сокет, а в Windows — через именованный канал. Если параметр выключен, агенты по-прежнему могут читать диаграммы открытых проектов с диска, но никогда не изменяют диаграмму в обход ее редактора.

Страница настроек сообщает, когда агенты для программирования недоступны: в IDE без JCEF (где не может работать и ERD Editor), в IDE, установленной как Flatpak в Linux, и когда хаб IDE не смог запуститься. В этих случаях IDE не создает файл блокировки, и агент редактирует файлы на диске. ERD Editor не перезагружает диаграмму, измененную на диске, пока она открыта, а ваша следующая правка в ней записывает всю диаграмму обратно поверх изменений агента, поэтому сначала закройте диаграмму.

Попробуйте

1. Откройте папку с диаграммами: в VS Code — как рабочую область, которой вы доверяете; в Obsidian — как хранилище; в IDE JetBrains — как проект, которому вы доверяете.
2. Запустите агента в той же папке и попросите его обычными словами, например «Добавьте в schema.erd.json таблицу reviews, связанную с users и products».
3. Посмотрите, как изменение появится на холсте. В VS Code сохраните его, нажав Ctrl + S (Windows/Linux) или ⌘ + S (Mac), либо попросите агента сохранить диаграмму. Obsidian и IDE JetBrains сохраняют изменение так же, как сохраняют ваши собственные правки, а если попросить агента сохранить, изменение записывается сразу.

Диаграмма, которая еще не открыта, открывается в ERD Editor при первой правке агента, не забирая фокус клавиатуры. Агент создает новый документ с помощью инструмента erd_open_document, а к имени без расширения добавляется .erd.json.

Обновление

В командах выше версия не указана, поэтому каждый раз, когда агент запускает сервер, npx проверяет, нет ли в npm его более новой версии. Уже запущенный сервер остается на своей версии, пока агент не запустит его снова.

Перед подключением сервер проверяет, какую версию протокола использует редактор. Если версии различаются, каждый вызов, доходящий до этого редактора, отклоняется с кодом protocolMismatch, в том числе чтение и вызов erd_list_documents, и ничего не записывается. В сообщении указано, какую сторону нужно обновить: сервер или ERD Editor в редакторе, т. е. расширение в VS Code и плагин в Obsidian и IDE JetBrains.

Сервер версии 1.0.0, расширение VS Code версии 4.0.0 или новее, плагин Obsidian версии 1.0.0 или новее и плагин JetBrains версии 1.0.0 или новее используют протокол 2. Все более ранние версии сервера используют протокол 1, как и все более ранние версии редакторов, которые обслуживают агентов: расширение VS Code версий с 3.0.0 по 3.1.0, плагин Obsidian версий 0.1.0 и 0.2.0 и плагин JetBrains версий 0.9.0 и 0.10.0. Такой редактор и сервер версии 1.0.0 отклоняют друг друга, как и более ранний сервер и редактор, использующий протокол 2. Расширение VS Code до версии 3.0.0 или плагин JetBrains до версии 0.9.0 вообще не обслуживает агентов, поэтому агент редактирует файлы на диске, даже диаграмму, открытую в нем.

Сочетание	Конец сообщения
Сервер версии 1.0.0 с расширением или плагином, использующим протокол 1	Update the ERD Editor extension or plugin in the editor until its hub speaks protocol 2.
Более ранний сервер с расширением или плагином, использующим протокол 2	Update the MCP server (npx -y @dineug/erd-editor-mcp@latest) until it speaks protocol 2.

Обновляйте сервер и расширение или плагин вместе. Обновляйте также ERD Editor везде, где открываются диаграммы. Расширение VS Code до версии 4.0.0, плагин Obsidian до версии 1.0.0 и плагин JetBrains до версии 1.0.0 показывают диаграмму, сохраненную более поздней версией или отредактированную агентом на диске, без значков первичного ключа. При сохранении файла они удаляют из него группы таблиц и скрипты Схемы SQL. Расширение VS Code до версии 3.1.0, плагин Obsidian до версии 0.2.0 и плагин JetBrains до версии 0.10.0 при сохранении файла также удаляют из диаграммы действия ON DELETE и ON UPDATE. В Obsidian после обновления плагина перезапустите приложение: до этого окно хранилища продолжает работать с ERD Editor той версии плагина, которую оно загрузило первой.