aprovodka
MCP-сервер для баз 1С:Предприятия через стандартный OData: справочники, документы, регистры и бухгалтерия без расширений в конфигурации
Установка
{
"mcpServers": {
"aprovodka": {
"command": "npx",
"args": ["-y", "@theyahia/aprovodka"],
"env": {
"ONEC_BASE_URL": "https://server/base/odata/standard.odata",
"ONEC_LOGIN": "user",
"ONEC_PASSWORD": "pass"
}
}
}
}Добавьте ONEC_WRITE_MODE со значением preview или approval, чтобы включить защиту записи.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к живой базе 1С через интерфейс OData 3.0, который публикует сама платформа, поэтому в конфигурацию ничего не встраивается. 34 инструмента покрывают справочники, документы, все виды регистров, регистр бухгалтерии с виртуальными таблицами остатков и оборотов, константы, пакетные операции, отслеживание изменений и чтение метаданных. Агент может создавать и изменять документы, проводить и отменять проведение, ставить пометки удаления. Для записи есть защитный режим: предпросмотр или подтверждение, обратимые операции возвращают токен отката. Для БП 3.0, УТ 11, ЗУП 3.1 и ERP 2 подготовлены пресеты с описанием ключевых сущностей и типичных ловушек.
Для кого. Для 1С-разработчиков, бухгалтеров и финансовых аналитиков, которым нужны данные базы 1С в разговоре с агентом.
Подходит, если
- Нужно получить остатки и обороты по счетам без написания отчета
- Нужно найти документы и данные справочников по условию
- Нужно разобраться в структуре незнакомой конфигурации через метаданные
Не подходит, если
- OData в базе не опубликован и опубликовать его нельзя
- Агенту нельзя давать права на изменение учетных данных, а отдельного пользователя только на чтение нет
Пример запроса к агенту
Покажи остатки по счету 41 на конец прошлого месяца в разрезе складовОграничения
Нужна публикация стандартного интерфейса OData для базы и пользователь 1С с нужными правами. Защитный режим записи по умолчанию выключен (ONEC_WRITE_MODE=off), его нужно включить явно. Логин и пароль передаются в переменных окружения. Исходный код и полная документация лежат в монорепозитории WWmcp, а этот репозиторий служит страницей продукта. Проект не связан с фирмой 1С. Автор также предлагает платную настройку под конкретную базу.
Как отключить. Удалите блок aprovodka из конфигурации MCP клиента и отключите пользователя 1С, под которым работал сервер.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| ONEC_BASE_URL обязательная | Адрес стандартного интерфейса OData базы, заканчивается на standard.odata |
| ONEC_LOGIN обязательная | Пользователь 1С |
| ONEC_PASSWORD обязательная, секрет | Пароль пользователя 1С |
| ONEC_WRITE_MODE | Режим защиты записи: off, preview или approval, по умолчанию off |
Проверка безопасности
- Создает, изменяет и проводит документы в рабочей базе 1С
- Защита записи по умолчанию выключена
- Логин и пароль пользователя 1С хранятся в конфигурации
Коротко о README
README объясняет, что сервер работает через OData 3.0 без расширений, перечисляет охват: справочники, документы, регистры, бухгалтерию, пакеты и отслеживание изменений. Приведена конфигурация MCP с npx и переменными ONEC_*, описаны режимы защиты записи и пресеты типовых конфигураций. Есть раздел о переходе со старого пакета 1c-rest-mcp и оговорка о товарных знаках. Большая часть README также рекламирует платную услугу автора по сверке цифр. Лицензия MIT.
Частые вопросы
Нужно ли ставить расширение в конфигурацию?
Нет, сервер работает только через стандартный OData, который публикует платформа.
Как защитить базу от случайных изменений?
Задайте ONEC_WRITE_MODE=preview или approval. Надежнее всего дать серверу пользователя 1С только с правами чтения.
Чем отличается от @theyahia/1c-rest-mcp?
Это тот же проект после переименования в версии 4.0.0. Инструменты и переменные ONEC_* не изменились, поменялись только команда и имя сервера.
Похожие
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Официальный MCP-сервер и скиллы CCXT: рыночные данные, балансы и торговля по выбору на криптобиржах и рынках предсказаний
Плагины со скиллами для анализа акций, отчетностей, опционов и стартапов плюс чтение соцсетей и рыночных данных
Скиллы и MCP-сервер для опционных трейдеров: котировки, технический анализ, греки, спреды, сканеры и портфель Interactive Brokers