CLI и MCP-сервер для 1С:Фреш
1C-Fresh: CLI и MCP
CLI и локальный MCP-сервер на Go для 1С:Фреш через OData: товары, цены, остатки, покупатели, заказы, продажи и деньги
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- create_product, create_customer и update_product пишут данные в действующую базу 1С:Фреш
- Запись в живую базу отмечена автором как не до конца проверенная
Установка
Ручная установка
go build -o bin/1c ./cmd/1cfreshСборка CLI и MCP-сервера из исходников на Go 1.25+.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент дает единый Go-клиент к OData 1С:Фреш и открывает его в двух видах: команды CLI вида 1c ДЕЙСТВИЕ РЕСУРС и MCP-сервер по stdio. Поддерживается чтение и частично запись по группам номенклатуры, товарам, покупателям и поставщикам, ценам и документам установки цен, остаткам по складам, заказам покупателей, документам продаж и закупок, складским документам, деньгам по кассам и счетам и кассовым чекам. Отдельная команда audit receipts проверяет непроведенные чеки за период. Запись сейчас доступна для групп номенклатуры, папок контрагентов, товаров типа «Запас» и «Услуга», покупателей и поставщиков; проведение документов, удаление и произвольные запросы OData не реализованы.
Для кого. Для владельцев небольшого бизнеса и разработчиков, которые ведут учет в 1С:Фреш и хотят получать отчеты и вносить справочные данные из агента.
Подходит, если
- Нужно посмотреть остатки, цены или непроведенные чеки за период из переписки с агентом
- Нужно завести или переименовать товар, покупателя или поставщика без входа в само приложение 1С:Фреш
- Нужен CLI для скриптов вокруг 1С:Фреш
Не подходит, если
- Нужно проводить или удалять документы: таких инструментов пока нет
- Нужна работа с обычной десктопной 1С, а не с облачным сервисом 1С:Фреш
Пример запроса к агенту
Покажи непроведенные чеки продажи за последнюю неделю и остаток товара PRODUCT_GUID на складеОграничения
Запись в действующую базу подтверждена README как непроверенная до конца: например, чтение счета на оплату по GUID на живой записи не проверялось, ресурс счетов пуст в проверенной базе. Нет удаления объектов и общего редактора OData. Некоторые чтения просматривают историю ресурса и могут занимать несколько секунд.
Как отключить. Удалите ссылку на бинарь 1c из PATH и уберите его из конфигурации MCP-клиента.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| ONEC_ODATA_BASE_URL обязательная | Ссылка на приложение 1С:Фреш без /odata/ в конце. |
| ONEC_ODATA_USERNAME обязательная | Пользователь с доступом к OData. |
| ONEC_ODATA_PASSWORD обязательная, секрет | Пароль пользователя OData. |
Проверка безопасности
- create_product, create_customer и update_product пишут данные в действующую базу 1С:Фреш
- Запись в живую базу отмечена автором как не до конца проверенная
Коротко о README
README на русском языке перечисляет десятки CLI-команд по номенклатуре, ценам, остаткам, покупателям, поставщикам, заказам, продажам, закупкам, складским документам, деньгам и чекам, объясняет вход через 1c login с сохранением .env только для текущего пользователя и приводит таблицу MCP-инструментов чтения и изменения данных. Отдельно оговорено, что запись в действующую базу не до конца проверена, а удаление и произвольные OData-запросы отсутствуют.
Частые вопросы
Может ли инструмент провести документ?
Нет, проведения документов, удаления и общего редактора OData в нем нет.
Что делает audit receipts?
Проверяет чеки продажи и возврата за период на Posted=false, максимум 31 день и 1000 чеков за вызов.
Похожие
Набор скиллов для инвестиционного исследования компаний в Claude Code и Codex по методологиям четырех инвесторов. Это исследовательский инструмент, не инвестици
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Официальный MCP-сервер брокера Alpaca: заявки по акциям, ETF, крипте и опционам, управление позициями и рыночные данные на естественном языке
inn-check-ru: светофор риска по ИНН
inn-check-ru
Открытый скилл, который по ИНН сверяет ЕГРЮЛ, ФССП, суды, банкротства и санкции сразу по нескольким источникам и выдает светофор риска с датой и причиной