MCP-сервер для 1С: безопасная тестовая интеграция

MCP-сервер для 1С это не единый официальный продукт, а интеграционный слой между MCP-клиентом и интерфейсами конкретной базы 1С. Безопасный первый результат: локальный тестовый сервер показывает ограниченный набор инструментов только для чтения, получает данные из копии базы и не умеет создавать, менять или удалять документы. Готовые сторонние реализации нужно оценивать отдельно по коду, разрешениям и способу хранения секретов.

Что здесь является протоколом, а что реализацией

Model Context Protocol задаёт правила обмена между клиентом и сервером: сервер объявляет инструменты и их схемы, а клиент позволяет модели вызвать выбранный инструмент. Официальная спецификация MCP Tools прямо указывает, что инструменты могут обращаться к внешним системам, а человек должен иметь возможность отказать в вызове.

1С со своей стороны предоставляет интерфейсы интеграции. На официальной странице REST-интерфейса 1С сказано, что опубликованное решение может принимать HTTP-запросы через OData 3.0, причём интерфейс способен читать, создавать, изменять и удалять объекты. Последние три возможности для первого теста нужно закрыть правами, а не только обещанием в промпте.

Связка выглядит так: MCP-клиент вызывает инструмент, ваш или сторонний MCP-сервер проверяет вход и права, затем адаптер обращается к тестовой 1С через разрешённый интерфейс. Протокол MCP не знает структуру справочников и документов вашей конфигурации. Эту схему задаёт конкретная реализация сервера.

Правило безопасного старта: запрет записи должен действовать на уровне пользователя 1С и кода адаптера. Фраза «только читать» в инструкции модели не является контролем доступа.

Карта результата тестовой интеграции

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

База: тестовая копия, без персональных и платёжных данных
Пользователь 1С: только чтение нужного справочника
Инструмент MCP: find_test_counterparty
Вход: test_code
Выход: id, name, status
Запрещено: create, update, delete, проведение документов
Приёмка: эталонная запись совпала, запись отклонена, секретов в журнале нет

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

По теме: Команда ИИ-агентов: роли, передача задач и контроль в 2026

Как выбрать или проверить реализацию MCP-сервера

На официальных страницах MCP и 1С, использованных для этой инструкции, не описан единый совместный сервер. Поэтому название репозитория или расширения не доказывает совместимость. Запросите точную версию, исходный код, лицензию, список инструментов, способ подключения к 1С и модель угроз.

• Код сервера доступен для аудита или поставщик даёт проверяемую сборку и документацию.
• В описании перечислены точные конфигурации и версии платформы 1С, а не только слово «1С».
• Каждый инструмент имеет узкую схему входа и понятный набор возвращаемых полей.
• Секреты читаются из защищённого хранилища или окружения и не попадают в ответы модели.
• Операции записи отсутствуют в тестовой сборке или блокируются отдельной ролью 1С.
• Есть журнал вызовов без содержимого токенов и персональных данных.

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

Шаг 1. Подготовить контур 1С только для чтения

Создайте копию базы штатным способом, удалите реальные персональные данные или замените их синтетическими. Заведите отдельного пользователя и дайте ему доступ только к нужному справочнику или отчёту. Не используйте администратора, даже если MCP-сервер работает только на вашем компьютере.

1. Записать версию платформы, конфигурацию и расширения тестовой базы.
2. Выбрать один объект, например отдельный учебный справочник.
3. Создать три синтетические записи с заранее известными значениями.
4. Опубликовать только нужный интерфейс во внутреннем тестовом контуре.
5. Проверить тем же пользователем чтение эталона и отказ при попытке записи.
6. Сохранить результат без пароля, токена и полного ответа с закрытыми данными.

REST-интерфейс 1С технически допускает изменение данных, поэтому проверка отказа обязательна. Если запись проходит, исправьте роль или публикацию до подключения MCP.

Шаг 2. Сузить инструменты MCP

Начните с одного инструмента, который принимает тестовый код и возвращает заранее определённый набор полей. Не добавляйте универсальный запрос, произвольный текст запроса к 1С или инструмент выполнения команд. Чем шире вход, тем труднее доказать, какие данные и действия доступны модели.

name: find_test_counterparty
input: { test_code: string }
output: { id: string, name: string, status: string }
timeout: 5 seconds
limit: 1 record
write_access: false
on_error: return code and safe message, no credentials

Проверьте схему инструмента в MCP-клиенте до первого вызова. Название, описание и поля должны совпадать с фактическим поведением. Не доверяйте аннотации вроде readOnlyHint как единственной защите: права 1С и серверная реализация должны независимо запрещать запись.

По теме: Личный ИИ-агент: как настроить безопасную работу

Шаг 3. Выбрать транспорт и хранение доступа

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

Доступ к 1С храните отдельно от настроек модели. Не вставляйте пароль в промпт, URL, параметры инструмента или журнал. Для локального процесса секрет можно читать из окружения с ограниченными правами, для сетевого сервера нужен управляемый секрет и ротация. В руководстве по Codex MCP описано подключение клиента, но разрешения источника данных настраиваются отдельно.

Шаг 4. Провести приёмочные проверки

Тестируйте не только счастливый путь. Один корректный ответ не доказывает безопасность. Выполните матрицу из разрешённых, ошибочных и запрещённых случаев.

• Известный код возвращает ровно одну эталонную запись.
• Неизвестный код возвращает пустой результат, а не случайную запись.
• Слишком длинный или неверный ввод получает контролируемую ошибку.
• Лишнее поле не раскрывается автоматически.
• Попытка создания, изменения и удаления получает отказ в 1С.
• Остановка 1С приводит к понятной ошибке без повторов записи.
• Журнал содержит время, инструмент и итог, но не пароль и содержимое закрытых полей.

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

По теме: Сколько стоит ИИ-агент: бюджет и расчёт в 2026 году

Диагностика частых сбоев

• MCP-клиент не видит сервер. Проверьте команду запуска, транспорт и журнал старта без вывода секретов.
• Инструмент виден, но вызов падает. Сверьте схему входа и протестируйте адаптер к 1С отдельно.
• 1С возвращает отказ чтения. Проверьте права тестового пользователя на выбранный объект.
• Ответ содержит лишние поля. Введите явный список полей на сервере, не передавайте сырой объект OData.
• Запрос выполняется долго. Ограничьте фильтр, число записей и тайм-аут, затем повторите на эталоне.
• Запись неожиданно разрешена. Немедленно остановите сервер и исправьте роль 1С и код адаптера.

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

Когда тест можно расширять

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

Рабочее подключение не следует автоматически из успешного теста. Перед ним нужны владелец сервиса, резервное копирование, мониторинг, ротация доступа, аудит стороннего кода и отдельное решение о допустимых операциях. Если задача решается обычным отчётом или API без модели, MCP может быть лишним слоем.

Частые вопросы

Есть ли официальный MCP-сервер 1С?

В официальных материалах, проверенных для этой статьи, описаны протокол MCP и интерфейсы интеграции 1С, но не единый совместный продукт. Каждую стороннюю реализацию проверяйте отдельно.

Можно ли подключить MCP сразу к рабочей базе?

Для первого запуска нет. Нужна тестовая копия, синтетические данные и пользователь только для чтения.

Достаточно ли написать агенту «ничего не менять»?

Нет. Запись запрещают правами пользователя 1С и кодом MCP-сервера, затем отказ проверяют отдельным тестом.

Когда нужен доступ на запись?

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