CLI и MCP-сервер для 1С:Фреш
1C-Fresh: CLI и MCP
CLI и локальный MCP-сервер на Go для 1С:Фреш через OData: товары, цены, остатки, покупатели, заказы, продажи и деньги
- 2 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- create_product, create_customer и update_product пишут данные в действующую базу 1С:Фреш
- Запись в живую базу отмечена автором как не до конца проверенная
Установка
- Работает в
- Сервисы
Ручная установка
go build -o bin/1c ./cmd/1cfreshСборка CLI и MCP-сервера из исходников на Go 1.25+.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- create_product, create_customer и update_product пишут данные в действующую базу 1С:Фреш
- Запись в живую базу отмечена автором как не до конца проверенная
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент дает единый Go-клиент к OData 1С:Фреш и открывает его в двух видах: команды CLI вида 1c ДЕЙСТВИЕ РЕСУРС и MCP-сервер по stdio. Поддерживается чтение и частично запись по группам номенклатуры, товарам, покупателям и поставщикам, ценам и документам установки цен, остаткам по складам, заказам покупателей, документам продаж и закупок, складским документам, деньгам по кассам и счетам и кассовым чекам. Отдельная команда audit receipts проверяет непроведенные чеки за период. Запись сейчас доступна для групп номенклатуры, папок контрагентов, товаров типа «Запас» и «Услуга», покупателей и поставщиков; проведение документов, удаление и произвольные запросы OData не реализованы.
Для кого. Для владельцев небольшого бизнеса и разработчиков, которые ведут учет в 1С:Фреш и хотят получать отчеты и вносить справочные данные из агента.
Подходит, если
- Нужно посмотреть остатки, цены или непроведенные чеки за период из переписки с агентом
- Нужно завести или переименовать товар, покупателя или поставщика без входа в само приложение 1С:Фреш
- Нужен CLI для скриптов вокруг 1С:Фреш
Не подходит, если
- Нужно проводить или удалять документы: таких инструментов пока нет
- Нужна работа с обычной десктопной 1С, а не с облачным сервисом 1С:Фреш
Пример запроса к агенту
Покажи непроведенные чеки продажи за последнюю неделю и остаток товара PRODUCT_GUID на складеMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
ONEC_ODATA_BASE_URLобязательная- Ссылка на приложение 1С:Фреш без /odata/ в конце.
ONEC_ODATA_USERNAMEобязательная- Пользователь с доступом к OData.
ONEC_ODATA_PASSWORDобязательная, секрет- Пароль пользователя OData.
Ограничения
Запись в действующую базу подтверждена README как непроверенная до конца: например, чтение счета на оплату по GUID на живой записи не проверялось, ресурс счетов пуст в проверенной базе. Нет удаления объектов и общего редактора OData. Некоторые чтения просматривают историю ресурса и могут занимать несколько секунд.
Как отключить. Удалите ссылку на бинарь 1c из PATH и уберите его из конфигурации MCP-клиента.
Частые вопросы
Может ли инструмент провести документ?
Нет, проведения документов, удаления и общего редактора OData в нем нет.
Что делает audit receipts?
Проверяет чеки продажи и возврата за период на Posted=false, максимум 31 день и 1000 чеков за вызов.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер 1С:Фреш на Python
1c-fresh-mcp
MCP-сервер для 1С:Фреш через стандартный OData: счета, продажи, контрагенты, обходит известные ограничения OData 1С:Фреш и учитывает НДС 22 процента
MCP-сервер для данных 1С:Предприятия через OData: дебиторка, продажи, остатки и деньги, а по отдельному флагу создание и проведение документов
MCP-шлюз на Go между агентом и HTTP-сервисом 1С: справочники, продажи, остатки, деньги и расчеты по нескольким базам
MCP-сервер для баз 1С:Предприятия через стандартный OData: справочники, документы, регистры и бухгалтерия без расширений в конфигурации
АИ Финансист: MCP-сервер для 1С
mcp_1c (AI Финансист)
Связка MCP-сервера, OData-клиента 1С и локальной языковой модели с чатом на Gradio для вопросов по данным 1С и загруженным PDF
MCP-сервер OData 1С с JSON-кэшем
MCP сервер для работы с OData 1C
Python MCP-сервер поверх OData 1С: читает и меняет справочники и документы, сохраняет все данные в JSON-файлы для локального анализа без повторных запросов
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| CLI и MCP-сервер для 1С:Фреш (эта карточка) | нет | не нужна | 2 | |
| MCP и CLI для SourceCraft: репозитории и CI/CD | нет | API-ключ | 0 | PR и CI/CD |
| MCP и CLI для СДЭК: заказы и отслеживание | нет | API-ключ | 0 | заказы и этикетки |
Коротко о README
README на русском языке перечисляет десятки CLI-команд по номенклатуре, ценам, остаткам, покупателям, поставщикам, заказам, продажам, закупкам, складским документам, деньгам и чекам, объясняет вход через 1c login с сохранением .env только для текущего пользователя и приводит таблицу MCP-инструментов чтения и изменения данных. Отдельно оговорено, что запись в действующую базу не до конца проверена, а удаление и произвольные OData-запросы отсутствуют.