Veai 5.17: рефакторинги IDE и MCP-сервер для внешних агентов

Рефакторинг затрагивает связи между файлами: при переносе класса меняются пакет и импорты, при удалении нужно проверить использования, а при переименовании обновить обращения к символу. JetBrains IDE уже умеет находить эти связи и заранее показывать конфликты. В версии 5.17 мы дали агенту доступ к этим механизмам, чтобы он выполнял связанные изменения через IDE, а не собирал их из отдельных правок файлов.

Раньше агент Veai мог использовать только Rename. Теперь появились Move и Delete. Плагин Veai можно установить в OpenIDE и JetBrains IDE. Перед операцией агент получает от IDE список затронутых мест и конфликтов, а затем применяет изменения сразу к связанным файлам в пределах возможностей рефакторинга.

Те же IDE-инструменты теперь можно подключить к Claude Code, Codex, Cursor, OpenCode и другим MCP-клиентам. Встроенный MCP-сервер плагина Veai передаёт выбранные инструменты навигации, запуска, отладки и рефакторинга без собственного инференса: внешний агент продолжает работать на своей модели. MCP-режим доступен бесплатно, без подписки, поэтому IDE-инструменты можно попробовать с уже используемым агентом.

Отдельное изменение нужно для задач, в которых после общего исследования появляются несколько направлений. От выбранного сообщения можно создать новый чат и раздельно обсуждать тесты, документацию, ревью или варианты архитектуры. Истории чатов развиваются независимо, а файлы открытого проекта остаются общими.

Все три изменения сокращают число шагов, на которых агенту приходится самостоятельно восстанавливать сведения, уже известные IDE. При этом результат рефакторинга зависит от поддержки языка, состояния индексов и связей, которые распознаёт конкретная JetBrains IDE.

Содержание

• Рефакторинги через механизмы IDE
• Перемещение файлов и папок
• Безопасное удаление сущностей
• Переименование связанных сущностей
• Предварительный просмотр и конфликты
• Границы семантического анализа
• MCP-сервер для внешних агентов
• Подключение MCP-клиента
• Инструменты и журнал вызовов
• Отдельный чат от выбранного сообщения
• Производительность и исправления
• Что выбрать для своей задачи
• Обновить плагин Veai

Рефакторинги через механизмы IDE

До версии 5.17 агент уже мог переименовывать сущности через Rename. В 5.17 к нему добавлены две новые операции:

• Move: перемещение файлов, папок и поддерживаемых кодовых сущностей;
• Delete: удаление сущностей после проверки использований.

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

Эти операции выполняются нативными механизмами рефакторинга JetBrains IDE. IDE знает структуру проекта, разрешает ссылки и использует индексы для поиска зависимостей. Агент вызывает соответствующую операцию, получает сведения о затронутых местах и учитывает их в дальнейшей работе.

Перемещение файлов и папок

При простом переносе файла средствами файловой системы его содержимое остаётся прежним. Пакет, импорты и ссылки из других частей проекта могут перестать соответствовать новому расположению.

При перемещении через Veai операцию выполняет механизм рефакторинга. IDE обновляет импорты и другие ссылки, которые может найти в открытом проекте. Это подходит, например, для переноса класса в другой пакет или перераспределения файлов между каталогами проекта.

Перед применением перемещения нужно проверить предложенный список изменений. Если IDE не распознаёт связь в конкретном языке, конфигурации или текстовом ресурсе, она может не включить её в рефакторинг.

Безопасное удаление сущностей

Перед удалением Veai проверяет использования сущности и сообщает агенту о найденных зависимостях. Агент видит, где удаляемый код участвует в работе проекта, и может изменить план задачи до удаления.

Такой порядок помогает обнаружить обращения из других файлов до того, как сущность исчезнет. Наличие проверки не означает, что IDE найдёт любую возможную зависимость. Результат определяется поддержкой языка, состоянием индексов и тем, какие связи доступны анализу IDE.

Переименование связанных сущностей

Переименование через IDE меняет ссылки на выбранную кодовую сущность, а не каждое совпадение последовательности символов. Это снижает риск затронуть документацию, несвязанный идентификатор или часть другого слова.

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

Предварительный просмотр и конфликты

До применения операции Veai показывает:

• какие элементы будут перемещены, удалены или переименованы;
• какие файлы и ссылки войдут в изменение;
• какие конфликты мешают выполнить рефакторинг;
• какие связанные сущности IDE предлагает изменить вместе с выбранной.

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

Границы семантического анализа

Рефакторинг использует знания IDE о проекте, но не гарантирует обнаружение всех зависимостей. На результат влияют:

• поддержка языка и фреймворка в конкретной JetBrains IDE;
• корректность индексации проекта;
• динамические ссылки, рефлексия и генерируемый код;
• обращения из конфигураций, шаблонов и внешних систем;
• текстовые упоминания, которые не являются разрешёнными ссылками на символ.

После крупного рефакторинга проверьте diff, соберите затронутые модули и запустите подходящие тесты. Инструменты IDE сокращают объём ручного поиска, но итоговая проверка проекта остаётся частью задачи.

MCP-сервер для внешних агентов

Veai 5.17 может запустить MCP-сервер внутри IDE. Сервер предоставляет внешнему MCP-клиенту выбранные группы инструментов в контексте открытого проекта.

Этот сценарий предназначен для разработчиков, которые работают с Claude Code, Codex, Cursor, OpenCode или другим MCP-клиентом и хотят дополнить его операциями IDE. Внешний агент использует свою модель, а плагин Veai выполняет только вызовы выбранных инструментов. Собственный инференс продукта для MCP-режима не требуется.

MCP-сервер доступен бесплатно, без подписки. Его можно использовать как отдельный способ попробовать навигацию, запуск конфигураций, отладчик и рефакторинги IDE со своим агентом. Это менее тесная интеграция, чем работа встроенного агента Veai, поскольку внешний клиент сам управляет моделью, контекстом и последовательностью вызовов.

MCP-сервер не передаёт клиенту все возможности IDE автоматически. Пользователь выбирает доступные группы инструментов при настройке сервера.

Подключение MCP-клиента

Откройте окно MCP-сервера плагина Veai и выполните настройку:

1. Создайте конфигурацию сервера для текущей IDE.
2. Выберите группы инструментов, которые разрешено вызывать внешнему агенту.
3. Запустите сервер.
4. Выберите поддерживаемый клиент, обнаруженный плагином Veai, и подключите его.
5. Если нужного клиента нет в списке автоматического подключения, скопируйте подготовленную конфигурацию в настройки MCP-клиента вручную.
6. Запустите внешний агент и проверьте появление первого вызова в журнале MCP-сервера Veai.

Состав автоматически обнаруживаемых клиентов зависит от локальной установки и версии клиента. Для остальных MCP-совместимых приложений используйте конфигурацию, которую показывает плагин Veai.

Инструменты и журнал вызовов

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

• навигации по проекту;
• запуска конфигураций;
• работы с отладчиком;
• рефакторинга средствами IDE.

Доступный конкретному клиенту набор определяется выбранной конфигурацией сервера.

Правая часть окна содержит журнал вызовов. Для каждого обращения можно посмотреть:

• какой инструмент запросил внешний агент;
• какие аргументы он передал;
• какой ответ вернул инструмент;
• на каком шаге возникла ошибка.

Журнал помогает разбирать последовательность действий без чтения полного терминального вывода внешнего агента. Например, внешний агент может поставить breakpoint, запустить конфигурацию, остановиться на нужной строке и запросить состояние выполнения через отладчик. В журнале видны вызовы инструментов, их аргументы и ответы.

Большие ответы MCP-серверов в 5.17 обрабатываются корректнее. Перед передачей журналов или конфигураций другим людям проверяйте, нет ли в них путей, исходного кода или иных данных проекта, которые не должны покидать рабочую среду.

Отдельный чат от выбранного сообщения

В длинном разговоре можно вернуться к предыдущему сообщению и создать от него отдельный чат. Новый разговор получает историю до выбранной точки. Исходный чат сохраняется без изменений.

Функция подходит, когда после общего результата нужно:

• в одном чате обсудить тесты, а в другом подготовить документацию;
• отдельно провести ревью уже написанного кода;
• подробно разобрать несколько вариантов архитектуры;
• сравнить альтернативные способы реализации;
• сохранить полезную историю, не продолжая неудачное направление.

После ответвления чаты развиваются независимо. Сообщения, ответы и дальнейший контекст одного разговора не добавляются во второй.

Общая файловая система

Ответвление чата не создаёт Git-ветку, копию проекта или отдельный рабочий каталог. Оба разговора работают с файлами открытого проекта. Если агент изменил файл в одном чате, это изменение находится в той же файловой системе и доступно при работе во втором.

Поэтому перед параллельной работой над конфликтующими вариантами определите, как изолировать изменения: используйте разные Git-ветки, worktree или последовательно сохраняйте и откатывайте варианты. Ветвление чата разделяет историю обсуждения, но не состояние проекта на диске.

Производительность и исправления

Меньше служебных обновлений

Плагин Veai реже обновляет панель контекста и экономнее обрабатывает служебные данные проекта. Также ограничен рост файлов внутренних журналов. Эти изменения сокращают лишнюю фоновую работу без изменения пользовательского сценария.

Стабильнее фоновые задачи, файлы и MCP-подключения

В Veai 5.17 исправлены ошибки в нескольких рабочих сценариях:

• фоновые инструменты надёжнее продолжают работу в чатах;
• вызовы инструментов корректнее восстанавливаются при неполных аргументах;
• исправлена работа с абсолютными путями Windows;
• исправлены проблемы при работе с корпоративными моделями;
• улучшена обработка крупных ответов MCP-серверов.

Эти изменения не требуют отдельной настройки после обновления.

Что выбрать для своей задачи

Задача	Возможность Veai 5.17	Что проверить
Перенести класс, файл или папку	Перемещение через рефакторинг IDE	Предварительный просмотр, импорты, ссылки и сборку затронутых модулей
Удалить кодовую сущность	Проверка использований перед удалением	Найденные зависимости, динамические обращения и тесты
Изменить имя символа	Переименование через IDE	Связанные сущности и изменения в нескольких файлах
Дать Claude Code, Codex, Cursor или OpenCode доступ к IDE	Бесплатный встроенный MCP-сервер без собственного инференса	Выбранные группы инструментов, конфигурацию клиента и журнал вызовов
Разобрать ошибку времени выполнения внешним агентом	MCP-инструменты запуска и отладчика	Конфигурацию запуска, breakpoint, состояние выполнения, аргументы и ответы инструментов
Обсудить несколько вариантов после общей точки	Отдельный чат от выбранного сообщения	Границу истории и общую файловую систему проекта
Найти причину сбоя MCP-инструмента	Журнал вызовов	Название инструмента, аргументы, ответ и шаг с ошибкой

После обновления с предыдущей версии

Существующие чаты и настройки продолжают использоваться после обновления. Для новых функций проверьте следующее:

1. Перед первым рефакторингом дождитесь завершения индексации проекта.
2. Просмотрите изменения и конфликты до применения операции.
3. Для внешнего агента запустите MCP-сервер и выдайте только необходимые группы инструментов.
4. Проверьте первый вызов внешнего агента в журнале MCP-сервера Veai.
5. При создании отдельного чата учитывайте, что оба разговора работают с одними файлами проекта.

Обновить плагин Veai

Откройте Settings | Plugins | Installed, найдите плагин Veai и нажмите Update, если обновление доступно. После установки перезапустите IDE, если она предложит это сделать.

Если плагин Veai ещё не установлен, скачайте плагин на странице загрузки Veai и следуйте инструкции по установке.

После обновления проверьте номер версии плагина, откройте рабочий проект и дождитесь завершения индексации перед первым рефакторингом.