1c-odata-mcp
MCP-сервер для данных 1С:Предприятия через OData: дебиторка, продажи, остатки и деньги, а по отдельному флагу создание и проведение документов
Установка
{
"mcpServers": {
"1c-odata": {
"command": "npx",
"args": ["-y", "1c-odata-mcp"],
"env": {
"ODATA_BASE_URL": "https://<сервер>/<база>/odata/standard.odata/",
"ODATA_USERNAME": "...",
"ODATA_PASSWORD": "..."
}
}
}
}Перед подключением опубликуйте OData и добавьте нужные объекты в состав. После правки полностью перезапустите Claude Desktop.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к любой базе 1С с опубликованным стандартным интерфейсом OData, будь то облако, сервер с SQL или файловая база, и прячет технические имена сущностей за понятными инструментами. В режиме чтения агент ищет контрагентов и документы, строит дебиторку по счету 62, остатки товаров, продажи, движение денег, уплаченные налоги и историю взаиморасчетов. При включенной записи он заводит контрагентов, номенклатуру и договоры, создает счета, реализации, поступления, платежные документы и кассовые ордера, копирует документ по образцу и проводит его. Один сервер обслуживает несколько баз и организаций.
Для кого. Для руководителей, бухгалтеров и 1С-специалистов, которым нужны ответы из учетной базы и рутинные документы без программирования на стороне 1С.
Подходит, если
- Нужно спросить, кто из покупателей должен больше всего
- Нужно выставить ежемесячные акты по образцу прошлого месяца
- Нужен срез продаж или движения денег за период по нескольким организациям
Не подходит, если
- OData в базе не опубликован и включить его нельзя
- Нужны регламентные операции вроде закрытия месяца: сервер их не создает
Пример запроса к агенту
Кто из покупателей должен больше всего и на сколько?Ограничения
Работает только через OData, объекты должны быть добавлены в состав стандартного интерфейса. Аналитика и счета учета рассчитаны на Бухгалтерию предприятия 3.0. Документы создаются непроведенными, проводки формирует сама 1С при проведении. Большие выборки усекаются, а годовые запросы на медленных базах могут идти десятки секунд.
Как отключить. Удалите блок 1c-odata из конфигурации MCP клиента. Чтобы оставить только чтение, не задавайте READ_ONLY=false.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| ODATA_BASE_URL обязательная | Адрес стандартного интерфейса OData, слэш на конце обязателен |
| ODATA_USERNAME обязательная | Пользователь информационной базы 1С |
| ODATA_PASSWORD обязательная, секрет | Пароль пользователя 1С |
| READ_ONLY | false снимает глобальный запрет записи |
Проверка безопасности
- При включенной записи создает и проводит документы в рабочей учетной базе
- Формирует платежные поручения и кассовые ордера
- Требует логин и пароль пользователя 1С
Коротко о README
README объясняет, какие варианты размещения 1С подходят и что нужно включить на стороне базы. Описаны возможности чтения и записи с примерами фраз, пример диалога, быстрый старт в три шага и полный перечень инструментов. Отдельно разобраны два предохранителя записи, работа с несколькими базами и организациями, ограничения, устройство сервера и частые вопросы. Пошаговая публикация OData и подключение вынесены в docs. Лицензия MIT.
Частые вопросы
Как включить запись?
Нужны два флага: глобальный READ_ONLY=false и ODATA_DB_<ИМЯ>_WRITABLE=true для конкретной базы. Каждая запись сначала показывает предпросмотр и выполняется только с confirm=true.
Удаляет ли сервер данные?
Нет, есть только пометка на удаление, как в самой 1С.
Похожие
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Скиллы и MCP-сервер для опционных трейдеров: котировки, технический анализ, греки, спреды, сканеры и портфель Interactive Brokers
Square MCP Server
Square Model Context Protocol Server
Официальный MCP-сервер Square: агент вызывает любые методы API Square, от каталога и клиентов до заказов и платежей
CLI и скилл для доступа агента к счету Т-Инвестиций: портфель, доходность, скринеры облигаций и заявки с подтверждением