MCP-сервер 1С через COM-соединение
mcp-1c-com
MCP-сервер на Python, подключающийся к информационной базе 1С через V83.COMConnector без установки расширения в саму базу
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- execute_script при отключенной защите выполняет произвольный код 1С через операторы Выполнить и Вычислить
- COM-доступ дает чтение и потенциальную запись данных информационной базы под правами указанного пользователя
Установка
Ручная установка
claude mcp add 1c-com -- "<путь>\.venv\Scripts\python.exe" "<путь>\server.py"Команда из README для подключения сервера к Claude Code.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер открывает внешнее COM-соединение к базе 1С и дает пять инструментов: execute_query выполняет запрос на встроенном языке запросов с параметрами и лимитом строк, list_metadata перечисляет объекты метаданных по видам, describe_object показывает реквизиты и табличные части объекта с типами, connection_info проверяет соединение и версии, а execute_script выполняет произвольный код или вычисляет выражение через отдельную обработку-исполнитель, потому что внешнее COM-соединение само по себе не поддерживает операторы Выполнить и Вычислить.
Для кого. Для разработчиков 1С на Windows, которым нужен MCP-доступ к базе без установки расширения внутрь самой конфигурации.
Подходит, если
- Нужен быстрый запрос к базе 1С без изменения самой конфигурации
- Нужно получить структуру объекта конфигурации по имени
- Нужно выполнить разовый код 1С через агента для отладки
Не подходит, если
- Работа идет не на Windows: COM-коннектор доступен только там
- Нужна безопасная работа с продуктивной базой: execute_script при включенной защите может выполнить произвольный код
Пример запроса к агенту
Покажи структуру справочника Контрагенты и выполни запрос по документам продаж за январьОграничения
Работает только на Windows с установленной платформой 1С:Предприятие 8.3 и требует совпадения разрядности Python и comcntr.dll. Ссылки в результатах запроса возвращаются как UUID без представления, если явно не запросить ПРЕДСТАВЛЕНИЕ. Инструмент execute_script требует отключить «Защиту от опасных действий» для пользователя ИБ, что явно ослабляет защиту от случайных вызовов Выполнить и Вычислить.
Как отключить. Удалите сервер 1c-com из .mcp.json проекта, командой claude mcp remove 1c-com в Claude Code.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| ONEC_FILE | Путь к файловой информационной базе. |
| ONEC_SRVR | Имя кластер-сервера для серверной базы. |
| ONEC_PWD секрет | Пароль пользователя 1С. |
Проверка безопасности
- execute_script при отключенной защите выполняет произвольный код 1С через операторы Выполнить и Вычислить
- COM-доступ дает чтение и потенциальную запись данных информационной базы под правами указанного пользователя
Коротко о README
README перечисляет пять MCP-инструментов, требования к разрядности Python и comcntr.dll, конфигурацию через переменные окружения для файловой и серверной базы, подключение к Claude Code через .mcp.json, отдельный раздел про execute_script с обработкой-исполнителем и необходимостью снять «Защиту от опасных действий», а также диагностику типичных COM-ошибок.
Частые вопросы
Почему execute_script требует отдельную обработку?
Потому что операторы Выполнить и Вычислить это конструкции языка, а не методы глобального контекста, и внешнее COM-соединение их напрямую не отдает.
Что означает ошибка TYPE_E_LIBNOTREGISTERED?
Не зарегистрирована библиотека типов коннектора, лечится повторной регистрацией comcntr.dll от имени администратора.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything