ai-edt

---

AI-EDT - MCP-сервер в виде плагина, работающего внутри запущенного экземпляра 1C:EDT. Он позволяет Claude, Cursor, GitHub Copilot и другим MCP-клиентам исследовать и изменять метаданные и BSL, переходить по семантическим ссылкам, управлять отладчиком, проверять проекты и работать с подключенной информационной базой.

Вместо того чтобы воспринимать рабочее пространство EDT как каталог XML- и BSL-файлов, ассистент использует семантическую модель, индексы, валидаторы и службы отладки самой EDT.

[!IMPORTANT]
Текущая версия работает на 1C:EDT 2026.2 и 2026.1. Сборка идет против 2026.1, поэтому один артефакт ставится на обе. Плагин работает везде, где работает EDT; на Windows рассчитаны только описанные ниже скрипты сборки и установки.

🎯 Зачем нужен AI-EDT

Ассистент с доступом только к тексту может искать по файлам, но не способен надежно отвечать на вопросы, зависящие от модели IDE:

• На какой объект метаданных указывает эта ссылка?
• Какие формы, роли и подсистемы зависят от справочника?
• Какой тип EDT вывела в этой позиции BSL?
• Почему валидатор проекта отклоняет объект?
• Что происходит в приостановленной отладочной сессии 1С?
• Можно ли применить изменение метаданных без ручного редактирования XML EDT?
• Соберется ли этот запрос именно на этой конфигурации - есть ли в ней такие таблицы и поля?
• Что скажет о новом коде валидатор EDT, а не текстовый линтер со стороны?
• Откроется ли эта форма у пользователя или развалится при загрузке конфигурации в базу?
• Соберется ли схема компоновки так, чтобы отчет заработал, а не просто существовал в файле?

AI-EDT дает для этого специализированные MCP-инструменты - те же службы, которыми пользуется сама среда. Ассистент не просто пишет BSL, запрос, форму, схему компоновки или объект метаданных: он тут же проверяет результат валидаторами EDT, поэтому ошибка всплывает на месте, а не в тот момент, когда конфигурацию впервые загружают в информационную базу. Меньше гадания, меньше хрупких текстовых правок, и вся работа идет в той же модели, которую видит разработчик в IDE.

⚡ Что можно делать

Сценарий	Что может сделать ассистент
🔍 Исследовать код и метаданные	Искать по BSL, разрешать символы, находить семантические ссылки, строить иерархии вызовов, получать список модулей и структуру объектов.
🏗️ Создавать и изменять метаданные	Создавать справочники, документы, регистры, формы, роли, команды, сервисы и другие объекты через edit_metadata, включая предпросмотр и пакетные операции.
🐞 Отлаживать BSL	Запускать или подключать отладочную сессию, ставить обычные и exception breakpoints, смотреть переменные, вычислять выражения, выполнять шаги и собирать профилирование.
🩺 Диагностировать конфигурацию	Получать проблемы EDT, перевалидировать объекты, исследовать граф зависимостей, находить антипаттерны запросов и оценивать влияние изменений.
🧱 Собирать сложные артефакты	Работать со СКД, MXL, XDTO, расширениями, внешними объектами и внешними источниками данных через специализированные мастерские.
🧪 Тестировать и исследовать данные	Запускать и отлаживать тесты YAxUnit, выполнять сценарии Vanessa Automation и исследовать состояние исполнения в приостановленной сессии отладки.
🛡️ Проверять границы доступа	Аудировать роли и RLS, искать потенциально чувствительные данные в коде и метаданных, отключать записывающие инструменты пресетами.
📦 Забирать поставку одним файлом	Импортировать конфигурацию или расширение из .cf и .cfe прямо в проект - последний сценарий, ради которого приходилось открывать Конфигуратор.
👀 Видеть, что делал агент	Открыть историю вызовов из строки состояния: что вызывалось, с какими аргументами и что ответило.
📜 Смотреть, что было в базе	Читать журнал регистрации файловой информационной базы: входы, проведения, обновления конфигурации, ошибки платформы - с отбором по времени, событию, пользователю и важности.
🧭 Не путать запущенные EDT	Сервер называет рабочую область, в которой запущен, а self_status перечисляет живые экземпляры на машине с портами и открытыми проектами.

Сервер предоставляет более ста операций. Родственные действия объединены фасадами code_search, edit_metadata, launch_debugger, diagnostics, insights и security_audit, поэтому MCP-клиент видит компактный набор инструментов вместо длинного списка почти одинаковых команд.

🧮 Метаданные, запросы и формы - там, где текстовый ассистент ломается чаще всего

Метаданные создаются по описанию, а не правкой XML. Разработчику достаточно сказать, что нужно: справочник с такими-то реквизитами, документ с движениями, форма списка к нему. Ассистент раскладывает это в план операций edit_metadata и выполняет его одним пакетом, а не десятком разрозненных вызовов. Любой шаг заранее прогоняется с dryRun=true и показывает, что именно будет затронуто; удаление и прочие деструктивные операции требуют отдельного подтверждения. Изменения идут через модель EDT, а не текстом по .mdo, и сразу после применения объекты перевалидируются, так что ошибка видна на месте, а не при первой загрузке в информационную базу.

Запрос проверяется до того, как его кто-то запустит. validate_query разбирает текст в контексте проекта и возвращает синтаксические и семантические ошибки с номерами строк, отдельно для обычных запросов и для запросов СКД. Вместе с ними приходит список подсказок на типовые промахи: слова SQL вместо языка запросов 1С, УБЫВАНИЕ вместо УБЫВ. Ассистенту не нужно запускать конфигурацию, чтобы выяснить, что запрос не соберется.

И что этот запрос вернет - тоже. С describeResult=true тот же инструмент сообщает колонки каждого результата и их типы, взятые из модели конструктора запросов EDT, а не вычитанные из текста. Пакет разбирается целиком: временные таблицы не выдаются за результат, но занимают свою позицию в ВыполнитьПакет(), поэтому индексы совпадают с реальными. Тип, который определить нельзя, не указывается вовсе - уверенная неправда обошлась бы дороже честного пробела. Ассистент перестает угадывать имена колонок, а с ними уходит целый класс ошибок, которые иначе доживают до рантайма.

Форму собирает генератор EDT, а не ассистент. Достаточно описать, какая форма нужна: create_form принимает назначение - форма объекта, форма списка, форма выбора, русские синонимы тоже принимаются, - и форму строит тот же генератор, которым пользуется мастер IDE, с основным реквизитом и рабочей раскладкой. Дальше она правится по частям: реквизиты и колонки, поля, таблицы динамических списков, команды, обработчики событий, параметры, командный интерфейс, функциональные опции. Результат читается через get_form_structure и просматривается глазами через get_form_screenshot, а validate_for_export ловит дефекты формы, которые проходят валидацию EDT и проявляются только при загрузке в информационную базу.

🔄 Типичный цикл работы агента

flowchart TD
    Q["Разработчик описывает задачу"] --> S["AI исследует модель EDT:<br/>код, метаданные, зависимости"]
    S --> P["Показывает предлагаемые изменения"]
    P --> E["Изменяет BSL или метаданные"]
    E --> V["Запускает валидацию EDT и тесты"]
    V --> D{"Найдена проблема?"}
    D -- Да --> B["Отлаживает сессию 1С"]
    B --> E
    D -- Нет --> R["Возвращает проверенный результат"]

🧩 Как это работает

flowchart TD
    subgraph Client["MCP-клиент"]
        AI["Claude · Cursor · Copilot · Cline"]
    end
    subgraph Plugin["Плагин AI-EDT · внутри процесса EDT"]
        direction LR
        HTTP["MCP endpoint<br/>Streamable HTTP + SSE"] --> GATE["Политика доступа<br/>пресеты и разрешения"] --> TOOLS["Фасады<br/>и мастерские"]
    end
    subgraph EDT["Службы 1C:EDT"]
        direction LR
        BM["Семантическая<br/>модель"]
        AST["Парсер BSL"]
        CHECKS["Валидация"]
        DEBUG["Отладчик"]
    end
    subgraph Runtime["1С:Предприятие"]
        APP["Клиент · сервер · задания · тесты"]
    end
    AI <-->|"JSON-RPC · localhost:12250"| HTTP
    TOOLS --> BM
    TOOLS --> AST
    TOOLS --> CHECKS
    TOOLS --> DEBUG
    DEBUG <--> APP

По умолчанию сервер доступен по адресу http://localhost:12250/mcp. Плагин не является отдельным headless-сервером: EDT должна быть запущена, а целевой проект - загружен. Благодаря этому инструментам доступны разрешенные ссылки, выведенные типы, текущие маркеры валидации и состояние живой отладки.

🚀 Быстрый старт

📋 1. Требования

• 1C:EDT
  • 2026.2
  • 2026.1
• Java / JDK
  • 25 - для 1C:EDT 2026.2
  • 17 - для 1C:EDT 2026.1
• Maven 3.9+ для сборки из исходников
• MCP-совместимый клиент
• ОС - любая, где работает 1C:EDT. Плагин собирается и полностью прогоняет тесты на Linux в CI. Windows нужна только вспомогательным скриптам build.cmd и scripts/edt-selfupdate.ps1, а команды установки ниже записаны для PowerShell; сама установка через p2 director от ОС не зависит

Для дополнительных возможностей потребуются YAxUnit, Vanessa Automation или конфигурация Attach. Подробнее - в разделе Дополнительные интеграции.

🔨 2. Сборка

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

build.cmd [EDT_INSTALL_DIR]

Альтернативный вариант - собрать Maven-реактор напрямую:

cd mcp
mvn clean verify

Сгенерированный P2-репозиторий:

mcp/repositories/ru.aiedt.mcp.server.repository/target/repository

📦 3. Установка в EDT

🤖 Просто попросите агента установить плагин

Установка сводится к одному сообщению агенту: он поставит плагин сам, без единого щелчка мышью. Нужен AI-агент с доступом к оболочке на той машине, где стоит EDT.

Скопируйте ему этот промпт:

Установи мне плагин AI-EDT в 1C:EDT.

Рецепт: https://github.com/Desko77/ai-edt/blob/main/docs/agent-install.md
Прочитай его целиком и следуй ему.

Ставь с update site https://desko77.github.io/ai-edt/ через Equinox p2 director
(1cedtc.exe из каталога установки EDT). Мастер "Установить новое ПО" не используй.
Это первая установка, поэтому -uninstallIU не передавай.

Перед установкой закрой запущенный сеанс EDT, запомнив его командную строку;
после установки запусти его теми же аргументами и дождись ответа status: ok
от health endpoint.

После этого поставь себе скил из каталога skills/ai-edt репозитория - без него
ты будешь пользоваться сервером вслепую. Порядок в skills/README.md.

Ничего не завершай принудительно. Если EDT не закрывается сам - остановись и скажи мне.

Если плагин уже установлен и вы его обновляете, замените предложение про первую установку на: Плагин уже установлен, обновляй его одним запросом director с -uninstallIU и -installIU.

Полный рецепт вместе с правилами обращения с запущенной средой - в docs/agent-install.md.

🖱️ Через интерфейс EDT

Оба ручных пути - мастер EDT и командная строка - ставят ту же фичу с того же update site, поэтому собирать плагин самостоятельно не обязательно:

https://desko77.github.io/ai-edt/

Этот адрес указывается в EDT так же, как локальный архив.

Шаг 1. Запустите EDT и откройте Справка → Установить новое ПО.

Шаг 2. Нажмите Добавить рядом с полем Работать с.

Шаг 3. В диалоге Добавить репозиторий укажите, откуда ставить. Подходит любой из вариантов:

• поле Расположение и адрес update site https://desko77.github.io/ai-edt/;

• то же поле и адрес прямо на архив последнего релиза - p2 умеет читать репозиторий внутри zip по HTTP:

  jar:https://github.com/Desko77/ai-edt/releases/latest/download/AI-EDT-update-site.zip!/
  

  Этот вариант всегда указывает на свежий выпуск и не зависит от публикации страницы, поэтому отстать от релиза не может. Обратите внимание на префикс jar: и завершающие символы !/ - без них адрес не работает.

• Архив... и файл mcp/repositories/ru.aiedt.mcp.server.repository/target/AI-EDT-<версия>.zip из локальной сборки;

• Расположение... и каталог mcp/repositories/ru.aiedt.mcp.server.repository/target/repository.

Имя репозитория произвольное, например AI-EDT.

Шаг 4. Отметьте категорию AI-EDT или фичу AI-EDT (1C AI tools for EDT) внутри нее и нажмите Далее. Если список выглядит пустым, снимите флажок Группировать элементы по категории.

Шаг 5. Проверьте состав установки, примите лицензионное соглашение и нажмите Готово.

Шаг 6. Сборка не подписана, поэтому при первой установке EDT просит подтвердить установку неподписанного содержимого. Согласитесь, чтобы продолжить.

Шаг 7. Когда установщик предложит перезапустить EDT, нажмите Перезапустить.

После перезапуска переходите к разделу 4. Запуск и проверка.

⌨️ Из командной строки

Equinox P2 director ставит ту же фичу без интерфейса. Сначала закройте обновляемый сеанс EDT: запущенный экземпляр держит старый плагин в памяти до перезапуска, то есть перезапуск все равно понадобится, а сеанс, который сам выполняет операцию установки, удерживает блокировку профиля.

& "<EDT>\1cedtc.exe" -nosplash `
  -application org.eclipse.equinox.p2.director `
  -repository "file:///C:/path/to/AI-EDT/mcp/repositories/ru.aiedt.mcp.server.repository/target/repository" `
  -uninstallIU ru.aiedt.mcp.server.feature.feature.group `
  -installIU ru.aiedt.mcp.server.feature.feature.group `
  -profileProperties org.eclipse.update.reconcile=true

Фича - это p2-синглтон, поэтому установка новой версии поверх существующей не пройдет, если в том же запросе не удалить старую. При самой первой установке строку -uninstallIU нужно убрать: удалять еще нечего.

Для рабочей среды разработки скрипт scripts/edt-selfupdate.ps1 выполняет весь цикл: аккуратное закрытие, установку, перезапуск и проверку состояния.

🎓 И сразу поставьте скил агенту

Каким бы путем вы ни поставили плагин, установка на этом не заканчивается. Плагин дает агенту инструменты, но не объясняет, как ими пользоваться: какой фасад брать под задачу, какие проверки обязательны после правки, что означает ответ с ключом возврата. Это знание лежит в скиле skills/ai-edt и ставится копированием каталога:

Copy-Item -Recurse skills\ai-edt "$env:USERPROFILE\.claude\skills\ai-edt"

cp -r skills/ai-edt ~/.claude/skills/ai-edt

Это расположение для Claude Code на уровне пользователя; каталог .claude/skills/ai-edt внутри проекта ограничит скил одним проектом. Если вы ставили плагин с update site и чекаута рядом нет, заберите каталог поверхностным клоном:

git clone --depth 1 https://github.com/Desko77/ai-edt.git "$env:TEMP\ai-edt-skill"
Copy-Item -Recurse "$env:TEMP\ai-edt-skill\skills\ai-edt" "$env:USERPROFILE\.claude\skills\ai-edt"
Remove-Item -Recurse -Force "$env:TEMP\ai-edt-skill"

Для другого агента действует его собственное соглашение: SKILL.md - обычный Markdown с именем и описанием во front matter, файлы references/ подгружаются по мере надобности. Подробности - skills/README.md.

Скил необязателен: без него агент тоже работает, просто дороже - читает модули целиком, правит руками файлы, которыми владеет EDT, и повторяет вызов, который уже вернул ключ возврата.

▶️ 4. Запуск и проверка

Откройте Window → Preferences → AI-EDT и проверьте:

1. порт сервера, обычно 12250;
2. нажмите Start, чтобы запустить сервер сейчас, либо включите Auto-start и перезапустите EDT;
3. Plain text mode для клиентов без поддержки MCP resources;
4. активный пресет инструментов.

После этого проверьте health endpoint:

curl.exe http://localhost:12250/health

Готовый экземпляр возвращает ответ со значениями status: ok и phase: ready. Если указано phase: indexing, дождитесь завершения загрузки проекта в EDT.

🔗 5. Подключение AI-клиента

Claude Code

Добавьте сервер в %USERPROFILE%\.claude.json:

{
  "mcpServers": {
    "AI-EDT": {
      "type": "http",
      "url": "http://localhost:12250/mcp"
    }
  }
}

Cursor

Создайте .cursor/mcp.json в корне проекта и включите Plain text mode в настройках AI-EDT:

{
  "mcpServers": {
    "AI-EDT": {
      "url": "http://localhost:12250/mcp"
    }
  }
}

VS Code / GitHub Copilot

Создайте .vscode/mcp.json:

{
  "servers": {
    "AI-EDT": {
      "type": "http",
      "url": "http://localhost:12250/mcp"
    }
  }
}

Конфигурации для Claude Desktop, Cline и Antigravity находятся в docs/clients.md.

🎓 5a. Проверьте, что скил на месте

Скил skills/ai-edt ставится на шаге установки - И сразу поставьте скил
агенту. Если вы его пропустили, сейчас самый момент: клиент уже
подключен, и разница видна с первого задания. Проверить просто - в Claude Code скил появляется в
списке доступных под именем ai-edt.

💬 6. Первый вызов

Попросите клиента вывести список проектов EDT или версию EDT. Успешный ответ должен содержать структурированную информацию о проекте, а не сообщение "инструмент недоступен".

Примеры запросов:

Покажи проекты EDT в текущем рабочем пространстве и кратко опиши состояние их валидации.

Найди все семантические ссылки на Справочник.Номенклатура и сгруппируй их по метаданным, формам и модулям BSL.

Не заработало или непонятно - спрашивайте в группе Telegram.

🧰 Набор инструментов

В основе API AI-EDT лежат фасады. Фасад принимает дискриминатор операции и направляет родственные действия через единую стабильную точку входа.

[!TIP]
Открыть полный каталог инструментов →
Все группы инструментов, режимы доступа и раскрываемые описания ключевых фасадов.

Фасад	Область применения
code_search	Текстовый поиск, ссылки, разрешение символов, иерархия вызовов, информация о символах и content assist.
edit_metadata	Изменение метаданных, форм, команд, ролей, сервисов, макетов и других элементов модели.
launch_debugger	Запуск/подключение, точки останова, шаги, переменные, вычисление выражений и профилирование.
diagnostics	Проблемы проекта, документация проверок, очистка и точечная перевалидация.
insights	Зависимости, метрики, антипаттерны, сравнение и анализ влияния.
security_audit	Права ролей, нарушения RLS и поиск чувствительных данных.
project_admin / infobase_admin	Проекты рабочего пространства, конфигурации запуска, обновление ИБ и синхронизация.
dcs_workshop / mxl_workshop / xdto_workshop	Программные конструкторы сложных артефактов 1С.
extension_workshop / external_object_workshop	Жизненный цикл расширений, внешних отчетов и обработок.
yaxunit_tests	Запуск или отладка выбранных тестов YAxUnit и чтение отчетов.

Прежние отдельные имена инструментов сохранены как алиасы для обратной совместимости. Пресет Canonical скрывает их из tools/list, уменьшая расход контекста без потери возможностей.

🔐 Пресеты инструментов и безопасность

На странице настроек Tools инструменты сгруппированы по назначению и доступны следующие пресеты:

Пресет	Назначение
Canonical	Рекомендуемый вариант. В списке видны фасады, а алиасы совместимости остаются вызываемыми, но скрытыми.
All Tools	Показывает каждый зарегистрированный инструмент и алиас. Полезно для исследования API.
Read-only	Поиск, навигация и валидация без правок, отладки и обновления ИБ.
Editing	Чтение и запись без отладки.
Debug & Test	Чтение, отладка и тесты без изменения исходников и метаданных.
Code Review	Анализ кода и метаданных без записи.

У каждого инструмента может быть состояние listed, callable-hidden или disabled. Скрытые инструменты продолжают принимать вызовы, отключенные - отклоняются. Благодаря этому Canonical уменьшает шум в каталоге, а ограничивающие пресеты действительно устанавливают границы доступа.

[!CAUTION]
Плагин работает с правами процесса EDT. Он может изменять исходники, метаданные и информационные базы. Храните проект в системе контроля версий, проверяйте предпросмотр перед подтверждением разрушающих операций и не публикуйте локальный порт без аутентификации за пределами loopback-интерфейса.

Токен доступа и привязка к интерфейсу

По умолчанию сервер слушает только 127.0.0.1 и не требует аутентификации: за пределы машины он не выходит. Если endpoint нужно открыть наружу, на странице Preferences → AI-EDT есть две настройки, и включать их следует вместе:

• Bearer-токен. Кнопка генерации создает случайный токен; клиент передает его заголовком Authorization: Bearer <токен>. Сравнение идет за константное время, чтобы токен нельзя было подобрать по времени ответа. Запрос без верного токена отклоняется до того, как дойдет до инструмента.
• Привязка ко всем интерфейсам. Снимает ограничение loopback. Если ее включить без токена, плагин пишет предупреждение в лог: любой хост, который дотянется до машины, получит право читать и менять исходники и информационную базу.

Маскирование персональных данных

Отдельная настройка включает маскирование данных, попадающих в ответ инструмента, - по категориям 152-ФЗ: ИНН, СНИЛС, номер карты, паспорт, телефон, email. По умолчанию выключена.

Что важно понимать про нее честно:

• Маскирование сделано с приоритетом точности над полнотой. ИНН, СНИЛС и карта проверяются по контрольной сумме, у паспорта и телефона обязателен разделитель - поэтому произвольный числовой идентификатор не будет испорчен. Обратная сторона: это не ловит ФИО, адреса и прочие персональные данные в свободном тексте.
• Маскируется собственный вывод инструмента и текст ошибок, но не конверт JSON-RPC и не бинарные изображения: структура ответа не меняется, только содержимое строк.
• Это снижает риск утечки в облачную модель, но не заменяет решение о том, какие данные вообще показывать ассистенту.

История вызовов

Каждый вызов инструмента записывается: что вызвали, с какими аргументами, что ответили, сколько заняло. Открыть - из индикатора AI-EDT в строке состояния, пункт Call history. Окно немодальное: агент продолжает работать, пока вы читаете.

Заголовок окна показывает, сколько вызовов хранится и по скольку символов запроса и ответа, а над панелью ответа видно, какая часть сохранена: Response (303 of 1957 characters). Так урезанную запись нельзя принять за короткий ответ.

Настройки в Window -> Preferences -> AI-EDT, раздел Call history: вести ли запись вообще, сколько вызовов хранить, сколько символов запроса и ответа сохранять. Умолчания рассчитаны на вопрос "какие инструменты отработали", а не "что именно они ответили" - если нужен полный ответ, увеличьте число символов, оно и решает, что вы увидите.

Глубина и объем ограничены совместно: буфер целиком не превышает заданного предела памяти, и если запрошенные значения в него не помещаются, число символов уменьшается пропорционально. Фактические значения показаны в заголовке окна истории, так что урезание видно. Умолчания до этого предела не достают.

Отдельная настройка дописывает каждый вызов в файл в служебном каталоге плагина, чтобы запись пережила перезапуск EDT. По умолчанию выключена. Файл ограничен по размеру и ротируется. Пароли информационных баз в него не попадают: значения аргументов с ключом вида password, token, secret заменяются на *** до записи. Персональные данные в файле маскируются - это можно отключить, но по умолчанию включено, потому что файл живет дольше сессии и уезжает вместе с приложением к отчету об ошибке.

Прочие меры

• Инструменты рефакторинга метаданных используют сценарий preview/confirm.
• Для незнакомых проектов рекомендуется пресет Read-only.
• evaluate_expression выполняет код в живой сессии 1С.
• Удаление ИБ, импорт конфигурации и синхронизацию можно отключить отдельно.
• Перед структурными обновлениями, которые нельзя отменить через Git, сделайте резервную копию ИБ.

🐞 Отладка клиентского и серверного кода

Фасад отладки поддерживает обычные клиентские запуски и конфигурации Attach to 1C:Enterprise Debug Server. Attach необходим для HTTP-сервисов, серверных вызовов, фоновых и регламентных заданий, а также кода, выполняемого в rphost.

Агент получает список конфигураций запуска EDT, подключается к серверу отладки 1С, устанавливает точку останова и ждет приостановки. После этого AI-EDT возвращает стабильные ссылки на поток, стек и кадр, чтобы агент мог исследовать переменные, вычислять выражения, выполнять код по шагам и продолжать выполнение.

🔌 Дополнительные интеграции

Интеграция	Что становится доступно	Что нужно настроить
YAxUnit	Запуск и отладка unit-тестов, фильтрация наборов и разбор JUnit-отчетов.	Установить расширение YAxUnit в целевую информационную базу.
Vanessa Automation	Выполнение сценарных UI-тестов.	Отдельно настроить Vanessa и требуемую конфигурацию запуска.
Сервер отладки 1С	Отладка серверного BSL через Attach.	Запустить ragent с -debug -http и создать конфигурацию Attach в EDT.
BSL Language Server	Дополнительный анализ исходников через code_review.	Указать внешний JAR в настройках AI-EDT.

⚠️ Ограничения

• AI-EDT зависит от внутренних и публичных служб EDT; после крупного обновления EDT может потребоваться новая версия плагина.
• Сервер доступен только при запущенной EDT.
• Для части семантических инструментов необходимо дождаться завершения индексации проекта.
• По умолчанию endpoint слушает loopback и не требует аутентификации. Bearer-токен и привязка ко всем интерфейсам есть в настройках, но включать их нужно осознанно - см. раздел про безопасность.
• Update site публикуется автоматически при выпуске релиза. Промежуточные сборки между релизами ставятся из исходников или из локального P2-репозитория.

🤝 Участие в разработке

Проект принимает воспроизводимые сообщения об ошибках, сфокусированные предложения возможностей, улучшения документации и pull request. Баги и предложения - в Issues, вопросы и живое обсуждение - в группе Telegram.

Начните с документов:

• CHANGELOG.md - что изменилось в каждом выпуске, одной строкой со ссылкой на подробности;
• CONTRIBUTING.md - сборка, стиль кода и правила участия;
• SECURITY.md - закрытая передача уязвимостей и модель угроз;
• docs/PROVENANCE.md - происхождение исходников и история переимплементации.

Структура репозитория:

mcp/
├── bundles/       # реализация OSGi-плагина
├── features/      # устанавливаемая Eclipse feature
├── repositories/  # генерируемый P2-репозиторий
├── targets/       # target platform EDT
└── tests/         # тесты плагина и контрактов

docs/              # руководства, аудиты и release notes
scripts/           # автоматизация разработки и обновления

Перед созданием pull request соберите Maven-реактор и опишите, как изменение было проверено на запущенном экземпляре EDT.

📜 Происхождение проекта

AI-EDT - самостоятельный продукт, созданный на основе EDT-MCP автора DitriX. Проект распространяется под лицензией AGPL-3.0-or-later; сохраненные уведомления и подробная история исходников описаны в LICENSE и docs/PROVENANCE.md.

⚖️ Лицензия

GNU Affero General Public License версии 3.0 или новее. Полный текст - в LICENSE.