MCP для 1С — это MCP-сервер, который подключает ИИ-агента (Claude Code, Codex или Cursor) к конфигурации и к базе: ИИ-агент для 1С читает настоящий код и настоящие данные. Чем шире доступ, тем дороже ошибка. Ниже: какие бывают серверы, что ломается на практике и как устроить доступ, чтобы агент помогал, а рабочая база оставалась целой. Как MCP устроен в целом, разобрано в статье MCP для ИИ-агента.
Что такое MCP-сервер для 1С
MCP — общий разъём между агентом и системой. Для 1С это MCP-сервер, который даёт агенту код и метаданные конфигурации, данные базы, справку платформы или проверки. Многие серверы совмещают несколько. Устроено это так же, как для любой другой системы: 1С — ещё один чужой контекст, как Jira или GitLab, с тем же разъёмом и теми же агентами. Своё у 1С только одно — как сервер добирается до неё: через выгрузку, среду 1С, расширение конфигурации или внешнюю обработку.
Что даёт MCP-сервер
| Код и метаданные | Данные базы | |
|---|---|---|
| Что видит агент | модули, метаданные, формы | справочники, документы, регистры, отчёты |
| Откуда берёт | выгрузка конфигурации или 1C:EDT | база 1С через расширение конфигурации или внешнюю обработку |
| Зачем | пишет код по настоящей конфигурации, меньше выдумывает | отвечает цифрами из базы, разбирает данные |
| Главный риск | правка не той конфигурации | запись в рабочую базу, чужие данные |
Вывод
КодАгент перестаёт придумывать методы и реквизиты, которых нет в конфигурации.
ДанныеАгент отвечает по базе, а значит, может и изменить её. Здесь нужны правила доступа.
Что сделатьНачните с кода: это безопаснее. Доступ к данным включайте только по схеме ниже, даже если сервер умеет и то и другое.
Чем 1С отличается для ИИ-агента
Вайбкодинг в 1С устроен иначе, чем в обычных языках: программа живёт в базе и в визуальных конструкторах, код — только её часть. Схема показывает путь программы от компьютера ИИ-агента до рабочей среды в GitLab и в 1С.
Путь программы: локально, тест, прод
ЛокальноУ GitLab агент правит файлы и сразу запускает тесты. У 1С он правит выгрузку, а проверить может только после загрузки в базу — локальную или тестовую.
ВерсииУ GitLab версии в git-репозитории с проверкой. У 1С — в хранилище конфигурации, git бывает, но необязателен.
Тест и продУ GitLab программа и данные лежат отдельно. У 1С в каждой среде своя база, где они вместе: обновить прод — значит обновить рабочую базу.
Где ломается ИИ-агент в 1С и почему
Выберите номер — под схемой откроется, что ломается и что помогает. Пять особенностей чаще всего обсуждают в чатах 1С-разработчиков, шестая — про MCP.
Что ломается и где
ОсобенностьМодели плохо знают язык 1С и БСП
Что ломаетсявыдуманные методы, синтаксис SQL вместо языка запросов 1С
Что помогаетсправка платформы через MCP, 2–3 образца из самой типовой
ОсобенностьСлужебные файлы нельзя править как текст
Что ломаетсяпроект расходится с базой, загрузка висит часами
Что помогаетправки только через MCP-сервер, запрет прямой записи
ОсобенностьФормы, СКД и макеты собираются мышкой
Что ломаетсяагент не привязывает события, оставляет пустой отчёт, макет не меняется
Что помогаеткаркас руками, агенту только код; снимок формы для проверки
ОсобенностьМедленный цикл проверки
Что ломаетсяобновление базы на десятки минут, агент обрывается и отчитывается раньше времени
Что помогаетобновление в фоне, тесты на отдельном сервере
ОсобенностьТиповая на поддержке, доработки в расширении
Что ломаетсяагент пишет в основную конфигурацию, тянет лишние заимствования
Что помогаетпроект расширения указан в правилах агента, основная закрыта
ОсобенностьЗапись в рабочую базу через MCP
Что ломаетсяправка мимо хранилища и теста, сразу в живых данных
Что помогаетрабочая база только на чтение, запись в тестовую
Вывод
ОтличиеАгенту в 1С нужен посредник: среда разработки, справка и запущенная платформа. Без них он правит то, чего не видит.
РазмерТиповые конфигурации огромны, модули по 15–26 тысяч строк. Агенту дают поиск по конфигурации и читают только нужный кусок.
Что сделатьНачните с кода и запросов, формы и отчёты СКД оставьте человеку, пока агент не покажет стабильный результат.
Бесплатные MCP-серверы для 1С и 1C:EDT
Готовых серверов много, и они быстро меняются. Перед подключением прочитайте, какие действия сервер умеет: только чтение или ещё и запись.
mcp-1cСтруктура конфигурации, поиск по коду, справка по языку и запросы к данным только на чтениеКод и данныеGitHub
1c_mcpКонструктор своего MCP-сервера внутри 1С расширением конфигурации: конфигурация из коробки, данные — своими инструментамиКод и данныеGitHub
Вывод
ВыборКод включают первым, данные — вторым шагом и отдельно.
ПроверкаСписок инструментов сервера — это список того, что агент сможет сделать с базой.
Что сделатьВыпишите инструменты сервера и отметьте, какие из них меняют данные.
Что ломается на практике
В открытых чатах 1С-разработчиков описывают похожие случаи. Пересказ своими словами, без имён. Это примеры из практики: проверить каждый случай невозможно. Выберите случай — схема покажет, где он произошёл, а карточка — почему и как защититься.
Случаи из практики
Что случилосьСломал рабочую базуАгенту открыли запись в рабочую базу, чтобы было быстрее. Правка ушла сразу в учёт, откатывали из копии.
ПочемуМежду агентом и живыми данными не было тестовой базы, запись в рабочую открыта.
ЗащитаРабочую базу — только на чтение. Агент пишет в тестовую, переносит человек после проверки.
Что случилосьУдалил список из сотни базАгент наводил порядок на сервере и удалил лишнее — заодно со списком рабочих баз.
ПочемуУчётка с правами администратора сервера, хотя задача касалась одной базы.
ЗащитаОтдельный пользователь под задачу, права только на одну базу, без администрирования сервера.
Что случилосьОтветил бухгалтеру данными директораАгент на MCP отвечал сотрудникам. Бухгалтер получил цифры, которые ему видеть нельзя.
ПочемуСервер ходил в базу под одним общим пользователем с полными правами — роли и ограничения 1С не работали.
ЗащитаВход под тем, кто спрашивает: тогда действуют его роли и ограничения доступа к записям.
Что случилосьПароли и ключи попали в журналыПароль от базы передали агенту прямо в запросе. Он остался в журнале вызовов и в истории чата.
ПочемуСекреты передавались в аргументах инструментов и лежали в файлах рядом с проектом.
ЗащитаСекреты только в настройках сервера, агенту их не показывают. Папки с ключами закрыты от агента.
Что случилось«Готово», а изменений нетАгент добавил реквизит и отчитался. В пользовательском режиме изменений нет: базу после правки не обновили.
ПочемуОтчёт агента приняли без проверки результата.
ЗащитаПосле правки — обновление базы, проверка ошибок и автотест. «Готово» — только со ссылкой на результат.
Что случилосьЗапрос без ошибок, но ответ неверныйАгент написал запрос, он выполнился без ошибок, но цифры разошлись с отчётом 1С.
ПочемуМодель плохо знает регистры и периоды 1С и пишет запрос как в обычной базе.
ЗащитаСверка с типовым отчётом 1С или ответ через готовый отчёт вместо своего запроса.
Что случилосьПерсональные данные ушли в облакоАгенту отдали выгрузку с паспортами и зарплатами, и она ушла к облачной модели.
ПочемуАгенту дали всю базу вместо нужных полей.
ЗащитаОбезличивание, только нужные поля. Для чувствительных данных — модель внутри контура.
Вывод
ОбщееПочти все случаи — про права и проверку. Модель здесь вторична.
ПричинаАгенту дали столько же прав, сколько у администратора, и поверили его отчёту на слово.
Что сделатьПройдите по случаям и отметьте, какие защиты у вас уже есть.
Безопасная схема
Рабочую базу агент только читает. Пишет он в тестовую базу. В рабочую изменения переносит человек после проверки.
Чтение отдельно от записи
ШагАгент читаетДанные и код рабочей базы — для ответов и разбора.
ГдеРабочая база, под своим пользователем 1С с ролью только на чтение.
Почему такАгент видит настоящие данные, но изменить их не может.
ШагАгент пишетКод, метаданные и документы.
ГдеТестовая база или песочница с копией рабочей.
Почему такОшибка остаётся в тестовой базе и не доходит до учёта.
ШагПроверка и переносАвтотесты, затем человек смотрит изменения.
ГдеИзменения уходят в хранилище, рабочую базу обновляют из него.
Почему такВ рабочую попадает только проверенное, и у каждой правки есть версия.
Вывод
СхемаОшибка агента остаётся в тестовой базе и не доходит до учёта.
ЦенаНужна тестовая база рядом с рабочей. Это дешевле одного восстановления из копии.
Что сделатьЗаведите тестовый стенд с копией базы до того, как подключать сервер к данным.
Права: лестница доступа
Права агента собирают по ступеням: каждая следующая ступень открывается, когда предыдущая отработала без сюрпризов. Что такое права агента
Лестница доступа
Что может агентЧтение кодаМодули, метаданные, формы.
Когда открыватьСразу.
Как настроитьСервер с доступом к выгрузке конфигурации или проекту EDT, без доступа к базе.
Что может агентЧтение данныхЗапросы и отчёты под своим пользователем 1С.
Когда открыватьНа копии базы, после того как код отработал без сюрпризов.
Как настроитьПользователь 1С с ролью только на чтение; инструмент «выполнить любой код» выключен.
Что может агентЗапись в тестКод, метаданные, документы.
Когда открыватьКогда есть автотесты.
Как настроитьОтдельная тестовая база; после каждой правки — проверка ошибок и автотесты.
Что может агентЗапись в рабочуюНичего: ступень закрыта для агента.
Когда открыватьНикогда — только человек.
Как настроитьПеренос делает человек через хранилище после проверки.
Свой пользователь 1САгент входит под отдельным пользователем или под тем, кто задал вопрос. Тогда работают обычные права и ограничения доступа к записям.
Роль только на чтениеДля рабочей базы — роль без права записи и проведения. Пример: в mcp-1c запросы к базе по устройству только на чтение.
Без произвольного кодаИнструмент «выполнить любой код» на рабочей базе отключите: через него обходятся все права.
Секреты отдельноПароли и ключи — в настройках сервера. Агенту их не показывают и в запросы не передают.
Вывод
Данные как командыКомментарий в документе или письмо в базе может содержать указание агенту. Это промпт-инъекция, и права ограничивают её вред.
ПравилоАгент получает права обычного пользователя. Чего не может пользователь, того не может и агент.
Что сделатьКак отличать данные от команд, разобрано в статье про промпт-инъекции.
Проверка результата
Отчёт агента «готово» — это заявка. Подтверждают её проверки и человек в контуре.
Четыре проверки до результата
ПроверкаПроверка ошибок среды
Что ловитСинтаксис, несуществующие методы и реквизиты.
Как запускатьПосле каждой правки; агент показывает итог проверки в отчёте.
ПроверкаАвтотесты
Что ловитСценарий не проходит, форма не открывается.
Как запускатьСценарные и модульные тесты на тестовой базе в каждом цикле.
ПроверкаСверка с отчётом 1С
Что ловитЦифры агента не совпадают с учётом.
Как запускатьТот же период и организация в типовом отчёте; расхождение — стоп.
ПроверкаПросмотр изменений человеком
Что ловитПравки не там, лишние заимствования, обход инструментов.
Как запускатьСравнение изменений перед переносом: только расширение, только нужные объекты.
Вывод
Частая ошибкаАгент правит файлы конфигурации в обход инструментов среды, и проект расходится с базой.
ПравилоКаждое «готово» подтверждено проверкой или ссылкой на результат.
Что сделатьВпишите в правила агента: после правки запустить проверку ошибок и показать её итог.
Claude Code, Codex и Cursor для 1С
MCP-сервер для 1С подключается к любому агенту с поддержкой MCP. Отличается только место настройки.
Подключение за 3 шага
1. Выбрать серверК коду или к данным, из списка выше
2. Поручить агенту«Подключи MCP-сервер для 1С по инструкции из README»
3. Проверить на копииПопросить список инструментов и найти один справочник
Где настройка
Где настроить
~/.codex/config.toml или .codex/config.toml в проектеДля команды
.codex/config.toml в доверенном проектеДокументацияMCP в Codex
Вывод
ОбщееПрава задают сервер и пользователь 1С. Схема выше работает с любым из трёх.
ПодтвержденияОставьте подтверждение для инструментов, которые меняют данные.
Что сделатьПоручите подключение самому агенту, как описано в статье про MCP.
С чего начать
Три шага. Каждый следующий — после того, как предыдущий прошёл без сюрпризов.
Вывод
Неделя 1Сервер к коду и чтение данных на копии базы. Проверьте 5 ответов агента руками.
Неделя 2Запись в тестовую базу и автотесты. Агент сам показывает, что проверил.
ДальшеРабочая база остаётся только на чтение. Перенос изменений — за человеком.