Что такое MCP:RSV Server — для программиста 1С

Простое введение в плагин MCP:RSV Server: что это за зверь, как он работает изнутри, чем отличается от прямой правки XML и как подключить к нему ИИ-ассистента. С аналогиями из мира 1С.

Зачем эта статья

Если вы программист 1С и слышали про «AI-разработку через MCP» — но толком не понимаете, как это устроено, какие там нужны куски и что за чем подключается, — этот текст для вас.

Я объясню всё простыми словами и с аналогиями из 1С, потому что термины из мира Java и Eclipse поначалу кажутся неподъёмными. Когда вы дочитаете до конца, у вас в голове сложится полная картина: что такое плагин MCP:RSV Server, что такое MCP-сервер, какая модель, какой клиент, какой провайдер, и как это всё в итоге собирается в рабочий инструмент.

Что такое MCP:RSV Server

MCP:RSV Server — это плагин для 1С:EDT, написанный на Java. Слово «плагин» в мире Eclipse / 1С:EDT означает то же, что «расширение» в мире 1С: некий внешний модуль, который подключается к основной программе и расширяет её возможности.

Аналогия из 1С: плагин EDT — это как расширение конфигурации

Чтобы было сразу понятно, проведём аналогию между двумя мирами:

То есть представьте: у вас есть типовая ERP, и вы пишете для неё расширение. В этом расширении вы программно создаёте документы, формируете движения, вызываете экспортные функции из БСП — потому что у БСП внутри уже всё реализовано, и нет смысла писать своё.

MCP:RSV Server устроен по той же логике, только применительно к 1С:EDT. Он подключается к EDT как плагин и программно использует то, что уже реализовано внутри самой EDT: создание объектов метаданных через те же конструкторы, что открываются по двойному клику; запись BSL-кода через тот же парсер, что подсвечивает синтаксис; поиск по проекту через те же индексы, что работают на F3.

Что такое «штатные API EDT» простыми словами

В 1С вы привыкли к терминам «процедура», «функция», «модуль», «экспортная процедура из общего модуля». В мире Java те же сущности называются по-другому, но смысл идентичный:

Когда вы в EDT нажимаете в дереве конфигурации правой кнопкой → «Создать справочник», EDT внутри себя вызывает определённый набор методов: создаёт объект в EMF-модели, добавляет его в Configuration, генерирует .mdo-файл с правильной структурой, обновляет ссылки в индексах, перерисовывает дерево. Этот набор методов и есть штатный API EDT.

Плагин MCP:RSV Server вызывает те же самые методы — только не в ответ на ваш клик мышью, а в ответ на запрос ИИ-агента. Поэтому результат гарантированно идентичен ручному действию: тот же файл, те же связи, та же индексация. Никаких «своих» парсеров, никакого ручного формирования XML.

Почему не получится просто редактировать XML

Метаданные 1С:EDT хранятся в XML-файлах: .mdo для объектов метаданных, .form для форм, .dcs для схем компоновки, и так далее. Возникает законный вопрос: а может, попросить ИИ просто редактировать эти XML напрямую? Получится же?

Простой справочник с двумя реквизитами — может быть, и получится. Но как только нужно сделать что-то реальное:

• форма с десятками элементов и нестандартным размещением;
• СКД-схема с группировками, отборами, условным оформлением;
• табличный макет с объединениями ячеек и именованными областями;
• регистр с измерениями, ресурсами и реквизитами правильных типов;
• расширение с заимствованными объектами и реквизитами на них;
• картинка на кнопке формы с правильной привязкой к ОбщаяКартинка.*;
• подписка на событие, привязанная к нужному типу объектов;

...всё это XML становится огромным, со ссылками между файлами, EMF-связями (внутренние идентификаторы объектов), специфическими порядками тегов. Любая мелкая ошибка ломает проект целиком: пропадают ссылки, EDT начинает показывать красные крестики, объект становится «битым».

Что в этой ситуации делает ИИ:

Именно поэтому в плагине MCP:RSV Server выбран путь «нативные сервисы», а не «прямая правка XML». Это не идеология, это инженерное требование: иначе полноценная разработка через ИИ просто не работает.

Что плагин умеет: программное расширение функционала EDT

До этого момента мы говорили в общем: «плагин использует штатные API EDT». Теперь — конкретно, что именно он делает. Это первая из двух ролей плагина (вторая — MCP-сервер, про неё ниже).

Создание и изменение объектов конфигурации

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

• Справочники, документы, обработки, перечисления, константы, роли, подсистемы.
• Регистры всех четырёх видов — накопления, сведений, бухгалтерии, расчёта (с измерениями, ресурсами и реквизитами).
• Отчёты с СКД — на отчётах и на любых других объектах со схемами компоновки.
• Реквизиты любых типов — простые, ссылочные, составные. Табличные части.
• Формы любого вида: формы элемента, списка, выбора, группы, записи регистра, общие. Со всеми элементами интерфейса — поля, группы, кнопки, таблицы, декорации, динамические списки, обработчики команд, цвета, шрифты, картинки.
• Макеты табличных документов — ячейки с оформлением, объединения, именованные области, в том числе матричные отчёты.
• Макеты схем компоновки данных (СКД) — наборы данных, поля, группировки, отборы, условное оформление, ресурсы, варианты, композитор настроек на форме.
• Расширения — полная поддержка: заимствование объектов поштучно, пакетно или рекурсивно, реквизиты и формы в расширении, автозаимствование связанных ссылочных типов.
• Подписки на события — создание одним вызовом с заглушкой-обработчиком в общем модуле.

Каждый из этих видов работ опирается на штатный конструктор EDT — тот самый, который открывается, когда вы кликаете на дереве правой кнопкой и выбираете «Создать».

Поиск и навигация — через нативные индексы и графы

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

1С:EDT внутри себя строит индексы и графы по всему проекту — это то, благодаря чему работают:

• F3 (Перейти к объявлению);
• «Найти ссылки» (Find References);
• «Иерархия вызовов» (Call Hierarchy);
• автодополнение, подсветка ошибок, refactoring.

Плагин MCP:RSV Server даёт ИИ-агенту инструменты, которые обращаются к этим же самым индексам:

Это даёт ИИ-агенту огромное преимущество: он работает с проектом, как опытный программист с IDE — «прыгает» по ссылкам, смотрит иерархию вызовов, точечно читает нужное. А не пытается удержать в контексте всю конфигурацию целиком.

Полноценная отладка через Eclipse Debug API

Ещё одна важная вещь — отладка. У EDT внутри есть полноценный отладчик 1С (Eclipse Debug API), который умеет всё то, что есть в Конфигураторе и даже больше: точки останова, шаги (step over, step into), стек вызовов, чтение переменных, и — что особенно ценно — выполнение произвольных BSL-выражений в текущем контексте отладки.

Плагин MCP:RSV Server пробрасывает этот отладчик ИИ-агенту:

• Скажите агенту: «поставь точку останова в обработчике ПриЗаписи у документа ЗаказПокупателя, я сейчас его проведу».
• Проведите документ в 1С:Предприятии.
• Агент видит, что попали в точку останова, читает значения переменных, выполняет evaluate любых выражений, шагает по коду.
• Может тут же предложить вам, что не так и где.

Всё это через инструмент launch_debugger с полным набором действий — около 16 операций.

Валидация — встроена в запись кода

Когда ИИ-агент пишет BSL-код через инструмент write_module_source, плагин сам дожидается валидации EDT и возвращает результат прямо в ответе. Если есть синтаксические ошибки или нарушения правил — агент видит их и исправляет в следующей итерации, пока количество ошибок не станет равным нулю.

Это очень удобно: не нужно отдельно «прогонять валидатор» — он вызывается автоматически после каждой записи. Можно сказать агенту «напиши процедуру X и убедись, что без ошибок», и он сам всё доведёт до конца.

Две роли плагина: расширение функционала + MCP-сервер

Всё, что мы обсуждали выше — это плагин как расширение функционала EDT. Программная часть, которая умеет создавать объекты, искать, отлаживать, валидировать.

Но это только половина дела. Чтобы весь этот функционал стал доступен внешнему ИИ-агенту (Claude Code, Cursor, Roo Code, Gemini CLI, любому другому), плагин должен уметь ещё и принимать запросы извне и отдавать ответы. Это и есть его вторая роль — MCP-сервер.

Что такое MCP-сервер — простыми словами

MCP = Model Context Protocol. Это открытый стандарт, придуманный Anthropic, чтобы ИИ-модели могли общаться с внешними инструментами по единому протоколу.

Самая простая аналогия — почтальон, или ещё точнее — переводчик-посыльный.

Представьте: есть две стороны.

• Слева — ИИ-агент. Он живёт в вашей IDE (или в браузере, или в терминале) и говорит на «языке моделей»: получает текст пользователя, формирует JSON-запросы, обрабатывает JSON-ответы.
• Справа — функциональная часть плагина MCP:RSV Server. Она живёт внутри EDT и говорит на «языке Java/EDT»: знает, как вызвать конструктор справочника, как поставить точку останова, как прочитать модуль.

Между ними — пропасть. Им нужен посредник, который умеет принимать сообщения от одной стороны и переводить их так, чтобы другая поняла. Этот посредник и есть MCP-сервер.

Как устроен обмен — пошагово

Что произошло:

1. Пользователь сказал ИИ-агенту человеческими словами: «создай справочник Контрагенты с реквизитами ИНН и КПП».
2. Агент знает, что у него подключён MCP:RSV Server с инструментом edit_metadata. Он формирует JSON-запрос: вызвать инструмент с операцией createCatalog, параметры — имя Контрагенты, реквизиты ИНН и КПП.
3. JSON по HTTP уходит на 127.0.0.1:8770 — это и есть MCP-сервер плагина внутри EDT.
4. MCP-сервер передаёт запрос в функциональную часть плагина — Java-код, который реализует операцию createCatalog.
5. Этот Java-код вызывает штатный конструктор справочника EDT — тот самый, что работает при ручном создании. Объект появляется в дереве конфигурации.
6. EDT возвращает результат «успешно». Плагин упаковывает его в JSON и отправляет агенту.
7. Агент видит ответ и сообщает пользователю: «справочник создан».

Все эти шаги занимают миллисекунды. Для пользователя это выглядит как одно непрерывное действие: попросил — получил.

Установка плагина в 1С:EDT

Прежде чем подключать ИИ — нужно поставить плагин. Делается это через стандартный механизм Eclipse, и в русскоязычной EDT все пункты меню называются по-русски.

Если у вас уже стоит старая версия — сначала удалите её

Это не обязательно, но надёжнее: Eclipse P2 кэширует архивы установки, и при обновлении бывают конфликты. Чистая переустановка их исключает.

1. Меню Справка → О программе.
2. В открывшемся окне «О программе» нажмите Детали установки.
3. В списке установленных компонентов найдите MCP:RSV Server (или похожее имя), выделите.
4. Нажмите Удалить внизу.
5. Подтвердите и перезапустите EDT.

Установка новой версии

1. Скачайте дистрибутив 1C-RSV-MCP-X.Y.Z-distr.zip с сайта плагина.
2. Меню Справка → Установить новое ПО…
3. В открывшемся окне нажмите Добавить… справа.
4. В диалоге «Добавить репозиторий» нажмите Архив…, выберите скачанный ZIP, дайте имя (например, «MCP:RSV Server») и нажмите Добавить.
5. В списке доступных компонентов поставьте галочку напротив MCP:RSV Server и нажмите Далее.
6. Примите лицензионное соглашение, нажмите Готово.
7. Если появится предупреждение о цифровой подписи — нажмите Trust all (Доверять).
8. EDT попросит перезапуститься — соглашайтесь.

После перезапуска плагин активен. Откройте Окно → Настройки → MCP:RSV Server — там увидите порт сервера (по умолчанию 8770) и состояние лицензии. При первом запуске вам 14 дней бесплатно доступен профиль «Архитектор» — с полным набором инструментов, без карты и без регистрации.

MCP-серверы подробнее: что такое инструменты

Шагнём чуть глубже — что MCP-сервер на самом деле предлагает агенту.

Любой MCP-сервер имеет набор инструментов. Один инструмент — это, как правило, одна функция или одно функциональное направление. У инструмента есть:

• Имя (например, show_edt_version);
• Описание — что он делает, человеческими словами;
• Схема параметров — какие у него входы, какого типа, какие обязательные.

Когда ИИ-агент впервые подключается к MCP-серверу, он спрашивает у сервера: «дай мне список твоих инструментов с описаниями». Сервер отдаёт. Теперь агент знает, что у него «в руках» — и при следующих запросах пользователя умеет правильно интерпретировать их в вызовы нужных инструментов.

То есть пользователь говорит «найди все ссылки на справочник Контрагенты» — агент видит, что у MCP-сервера MCP:RSV Server есть инструмент code_search с операцией поиска ссылок на объект, читает его описание, понимает, что нужно передать имя объекта, формирует вызов. Никаких хитростей.

Пример простого инструмента

Самые простые инструменты в MCP:RSV Server — это, например:

• show_edt_version — возвращает версию 1С:EDT, которая сейчас запущена. Параметров нет, возвращается строка вроде 2025.2.
• list_workspace_projects — возвращает список проектов в текущем workspace EDT. Тоже без параметров, на выходе — массив имён проектов.

Это «один инструмент = одна простая функция». Полный список и описания всех инструментов смотрите на странице Описание инструментов — она специально написана для того, чтобы ИИ-агент (и вы) знали, что доступно и как этим пользоваться.

Сложный инструмент на примере edit_metadata

Бывает по-другому: один инструмент содержит десятки операций. Так сделан главный «конструктор конфигурации» — edit_metadata.

Он один — но внутри него около 59 операций: создать справочник, добавить реквизит, создать форму, добавить поле на форму, создать макет, добавить именованную область в макет, настроить СКД, заимствовать объект в расширение, и так далее.

Зачем так? Потому что если каждую операцию сделать отдельным инструментом, у MCP-сервера их станет несколько сотен — и ИИ-агент захлебнётся в их описаниях. Контекст переполнится ещё до начала работы. Поэтому несколько десятков операций упакованы в один «зонтичный» инструмент с встроенной системой подсказок.

У edit_metadata есть встроенная справка:

• edit_metadata operation=help — список всех операций с кратким описанием каждой.
• edit_metadata operation=help topic=createCatalog — подробная справка по конкретной операции с примерами вызова.
• edit_metadata operation=help topic=workflow — типичный сценарий «от создания объекта до обработчиков».
• edit_metadata operation=help topic=types — каталог типов данных для реквизитов.
• ...и ещё несколько подсказок по сценариям (формы, СКД, матричные отчёты, табличные макеты).

По сути edit_metadata — это несколько десятков «скиллов», зашитых в код плагина. Агент не загружает все их описания сразу — он подгружает справку только по той операции, которая ему нужна сейчас. Контекст не разрастается, а функционал — огромный.

Такой же приём (один зонтичный инструмент с многими операциями и встроенным help) используется и в других сложных инструментах плагина — например, launch_debugger с ~16 действиями.

Подключение ИИ — какие модели бывают

Мы разобрались с плагином и MCP. Теперь — про вторую сторону: ИИ-агента и модель, которая его «питает».

Языковых моделей сейчас выпускают много компаний. Самые известные:

Есть отдельный класс моделей — открытые (open-weight): их веса можно скачать и запустить у себя на компьютере (Llama, Qwen-7B, и пр.). Звучит соблазнительно, но на практике:

• На обычной видеокарте (12–24 ГБ) запускаются только маленькие версии — 7–13 миллиардов параметров.
• Маленькие версии сильно проигрывают облачным моделям — путаются в инструментах, плохо держат длинный контекст 1С-проекта, медленно работают.
• Серьёзная open-weight модель (200B+) требует мощного сервера с несколькими GPU за десятки тысяч долларов — это уже не «домашний» сценарий.

Для реальной работы с 1С через MCP:RSV Server практически всегда выбираются облачные модели: запрос отправляется на сервер провайдера, ответ возвращается обратно. Стоит копейки за вызов и работает намного быстрее и надёжнее.

Варианты оплаты — два основных

Есть два подхода, как вы платите за работу с моделью.

Программистам 1С, которые только пробуют ИИ-разработку, обычно проще начать с pay-as-you-go: пополнили баланс на $10–20, попробовали разные модели, поняли, какая подходит — и дальше выбираете оптимальный вариант под свою нагрузку.

IDE и расширения для работы с ИИ

ИИ-агент должен где-то «жить». Это либо отдельная программа, либо расширение к привычной IDE. Самые популярные варианты:

Все эти варианты умеют подключаться к MCP-серверу MCP:RSV Server — потому что MCP это открытый стандарт, и все современные ИИ-клиенты его поддерживают.

Если вы пробуете в первый раз — рекомендую связку VS Code + Roo Code + бюджетная модель через OpenRouter. Это самый недорогой и гибкий вариант, описанный в отдельном конспекте к видео.

Провайдеры моделей — у кого «брать» модель

Есть два пути получить доступ к модели.

Маркетплейсов сейчас довольно много — OpenRouter самый известный, но не единственный (есть Together AI, Fireworks, DeepInfra, и др.). Они выгодны тем, что:

• Один аккаунт = десятки моделей и провайдеров.
• Цены часто ниже официальных (за счёт оптовых тарифов).
• Принимают разные способы оплаты, включая криптовалюту — что особенно полезно в регионах, где сложно напрямую оплатить иностранному сервису.
• Можно поставить лимит расхода в долларах — страховка от «убежавших» агентов.

Финальный стек — как всё собирается вместе

Когда у вас в голове сложилась полная картина, вы видите всю систему как стек из нескольких слоёв. Снизу вверх:

• 1
  1С:EDT с вашей конфигурацией Ваш проект, метаданные, BSL-код, формы, отчёты. Ничего не меняется в привычном.
• 2
  Плагин MCP:RSV Server — встроен в EDT как расширение Программная часть (умеет создавать объекты, искать, отлаживать) + MCP-сервер на 127.0.0.1:8770.
• 3
  ИИ-клиент Cursor / VS Code + Roo Code / Claude Code / Gemini CLI / любой другой с поддержкой MCP. Подключается к MCP:RSV Server по адресу http://127.0.0.1:8770/mcp.
• 4
  Провайдер модели Anthropic напрямую / OpenAI напрямую / OpenRouter / Together / любой другой. Даёт API-ключ.
• 5
  Языковая модель Claude Sonnet, GPT-5, Gemini, DeepSeek-V4-Flash, Qwen3.5-Flash — что выбрали. «Мозг» агента.
• 6
  Вы и естественный язык Просто говорите агенту: «создай справочник Контрагенты с реквизитами ИНН, КПП», «найди где используется метод такой-то», «поставь точку останова и отладь проведение документа».

Техники промтов: качественный код от агента

Иногда агент берётся за задачу и идёт «своим путём» — пишет код, который вообще не компилируется или работает с ошибками, либо технически работает, но плохо ложится в стиль вашей конфигурации. Например, делает запрос напрямую к регистру расчёта, когда в типовой ЗУП для этого есть готовая библиотека общих запросов. Или пишет своё фоновое задание с блокировками и гонкой версий вместо использования механизма длительных операций БСП. Или кладёт серверный код в общий модуль с двумя галочками (Клиент + Сервер) — и конфигурация не компилируется.

Это вопросы не к плагину, а к модели. Плагин технически умеет писать в любой модуль и читать любые исходники — он просто инструмент. А вот как агент использует этот инструмент — выбор готового паттерна или «изобретение» с нуля — целиком в его руках.

Для таких ситуаций есть две очень простые техники, которые почти всегда выручают. Их можно прописать один раз в правилах для агента (правила идут в комплекте с поставкой плагина — файл CLAUDE.md и его аналоги для других ИИ-клиентов, агент читает их автоматически в начале сессии), либо просто применять руками в нужный момент.

Техника 1 — заставить изучить паттерны типовой

Когда видите, что агент пошёл «своим путём» и явно не справляется — скажите ему буквально следующее:

«Посмотри, как эта задача решается в типовой конфигурации. Найди 2–3 готовых примера через инструмент поиска по коду, изучи их, и напиши код строго по этим примерам. Не изобретай свой подход».

Если вы сами знаете, что в вашем случае нужно использовать общие запросы из конкретного модуля (например, в задаче по ЗУП — это библиотека ОтчётыЗарплата.* и подобные) — напишите это явно: «используй общий запрос из модуля ОтчётыЗарплата, не строй запрос с нуля». После такой подсказки агент возьмёт правильную точку входа и пойдёт от неё.

Ещё один частый и сложный пример — отложенное проведение документа через фоновое задание. Тонкая задача: гонка версий, блокировки, повторная запись из обработчика. С нуля её правильно реализовать сложно, обычно человек неделю собирает пазл по форумам и техфорумам 1С. В типовых конфигурациях для этого есть готовый механизм — общий модуль ДлительныеОперации из БСП. Достаточно сказать агенту:

«Изучи механизм длительных операций в типовой конфигурации (общий модуль ДлительныеОперации БСП) и реализуй задачу с использованием паттернов этого механизма».

И агент возьмёт готовые паттерны вместо изобретения своих — задача закроется за несколько итераций, без сюрпризов в проде. Этот же подход работает для любого сложного механизма БСП: печать, обмен данными, версионирование, дополнительные реквизиты и сведения, файлы и т.д. — достаточно явно назвать имя модуля или раздела БСП в промте.

В последних релизах плагина инструмент поиска по коду (code_search) переработан — он теперь работает быстро даже на больших типовых вроде ЕРП и ЗУП КОРП, и потребляет мало токенов. Так что агент успеет найти готовые паттерны без перерасхода контекста и напишет органичный для вашей конфигурации код.

Совет — выносите найденные паттерны в свой референс

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

Удобное место для такого референса — файл .ai/project-knowledge.md в корне проекта. Агент создаёт эту папку автоматически и читает её в начале каждой сессии.

Техника 2 — обязательная проверка синтаксиса через справку платформы

Если паттернов в коде проекта взять негде (новая возможность, редкий API), скажите агенту:

«Перед записью кода обязательно проверь сигнатуры всех используемых методов через инструмент get_platform_docs».

Это синтаксис-помощник 1С, доступный агенту через MCP — справка очень полная и точная. Он там найдёт корректную сигнатуру практически любого платформенного метода или функции языка запросов. Единственное, чего там нет — это методов БСП и доменно-специфической логики типовых конфигураций. Но именно для этих случаев работает Техника 1 — пойти и посмотреть, как делают сами типовые.

Итог

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

Что дальше

Теперь у вас в голове есть полная картина: что это за плагин, как он работает изнутри, что такое MCP, какие модели бывают, и как всё это собирается в рабочий инструмент.

Логичные следующие шаги:

1. Скачайте и установите плагин (по инструкции выше).
2. Активируйте 14-дневный пробный период с полным доступом к Архитектору.
3. Подключите ИИ-клиент. Если выбрали бюджетный вариант — смотрите конспект про OpenRouter + Roo Code или видео-гайд на YouTube — там весь процесс показан на экране.
4. Прочитайте руководство пользователя — там есть готовые примеры запросов для каждого профиля (Аналитик / Разработчик / Архитектор).
5. Просмотрите описание всех инструментов — это поможет вам формулировать запросы к агенту точнее.
6. Если что-то непонятно — пишите в Telegram-канал или на почту prepod2003@yandex.ru.