Bilem Agent

Bilem Agent — программа для Windows, которая подключает базы 1С к ИИ-ассистентам (Claude, ChatGPT, Cursor и другим) через протокол MCP. Директор спрашивает в чате: «сколько денег на счетах?», «кто нам должен?», «пришли акт сверки с ТОО …» — агент отвечает по данным 1С.

Программа не передаёт данные в сеть, кроме случаев, когда этого явно попросил пользователь (письмо с документом, проверка обновлений на GitHub). Данные 1С читаются только на этом компьютере.

Сайт и документация: bilem.ai · docs.bilem.ai · вопросы — GitHub Issues и Обсуждения.

Что умеет

Отвечает по данным 1С: деньги на счетах и в кассах, контрагенты, документы — с датой «данные на …» (учёт в 1С отстаёт от жизни, агент говорит об этом честно).
Печатает документы, которые уже есть в 1С: счёт на оплату, доверенность (форма Д-1), акт сверки — PDF с логотипом, печатью и подписью вашей организации.
Отправляет их по почте через ваш почтовый ящик (SMTP): счета и акты — на любой адрес, доверенности — только на ваши адреса.
Вы решаете, что видит ИИ: вкладка «Доступ» — дерево разделов как в меню вашей 1С; зарплата и кадры (персональные данные) закрыты.

Bilem не меняет ваш бухгалтерский учёт. Агент читает данные; проведения и удаления документов в программе нет.

Что программа меняет в системе

Где	Что
Папка программы	`C:\Program Files\Bilem Agent` (установщик MSI)
Данные агента	`C:\ProgramData\Bilem` — настройки подключённых баз, токен MCP, печати и подписи, настройки почты, журналы. Доступ — только Администраторы и SYSTEM; пароли — зашифрованы для этого компьютера (DPAPI)
Базы 1С	в каждой подключённой базе — пользователь `bilem` с правами только на чтение (роли подбираются самые узкие) и состав стандартного интерфейса OData
IIS	публикация базы `bilem_<имя>` со своим пулом приложений; OData доступен только с этого компьютера (127.0.0.1)
Сеть	MCP-сервер агента — только `127.0.0.1:8796`, вход по токену

Расширения в базу 1С агент не ставит, конфигурацию не меняет.

Требования

Windows 10/11 или Windows Server 2016+ с .NET Framework 4.8, права администратора;
платформа 1С:Предприятие 8.3 с компонентой «Модули расширения веб-сервера»;
IIS (агент включит его сам);
файловая база 1С и логин администратора 1С. Проверено на «Бухгалтерии для Казахстана» 3.0.

Установка

Скачайте BilemAgent-<версия>.msi со страницы Releases и запустите (см. ниже, если Windows предупреждает).
Откройте «Bilem Agent» (ярлык на рабочем столе) → Базы 1С → Добавить… — выберите базу, введите логин и пароль администратора 1С (пароль не сохраняется).
MCP → Подключить к Claude Code (или Claude Desktop, Cursor) — и спрашивайте.

Если Windows предупреждает при запуске

Бета-версии пока выходят без подписи Microsoft (сертификат оформляется), поэтому Windows может остановить установку:

«Windows защитила ваш компьютер» (SmartScreen) — нажмите «Подробнее» → «Выполнить в любом случае».
Windows Server, файл скачан браузером — щёлкните MSI правой кнопкой → «Свойства» → внизу отметьте «Разблокировать» → «OK», затем запустите. Или в PowerShell: Unblock-File .\BilemAgent-<версия>.msi.

Убедиться, что файл настоящий, можно по SHA256SUMS в том же релизе: Get-FileHash .\BilemAgent-<версия>.msi — хеш должен совпасть.

Подробно — docs.bilem.ai. Проверка подлинности: в релизе есть SHA256SUMS и подпись SHA256SUMS.sig (Ed25519); агент проверяет их сам при обновлении.

Обновление

«Сервис» → «Обновления» → «Проверить сейчас» → «Обновить». Агент скачивает MSI с GitHub, проверяет подпись и хеш, закрывается, ставит новую версию и запускается снова; базы, токен MCP, печатные формы и почта остаются. Предыдущая версия хранится — «Откатить на …». Бета-версии — галочка «Получать бета-версии».

Удаление

В агенте для каждой базы — Базы 1С → Удалить (убирает публикацию IIS и пул; с галочкой — и пользователя bilem в базе). То же из командной строки: bilem-agent remove --slug <имя> [--drop-user --admin <логин>].
«Параметры Windows» → «Приложения» → Bilem Agent → Удалить.
Данные C:\ProgramData\Bilem при удалении остаются (на случай переустановки). Удалить и их: msiexec /x BilemAgent-<версия>.msi REMOVE_SETTINGS=1 или удалите папку вручную.

Безопасность

Как сообщить об уязвимости — SECURITY.md. Лицензия — MIT.

Для разработчиков

C#, .NET Framework 4.8 (WinForms + командная строка), сборка dotnet build Bilem.Agent.sln, тесты dotnet test tests/Bilem.Agent.Core.Tests, MSI — WiX 5 (installer/), релиз по тегу vX.Y.Z — GitHub Actions (.github/workflows/release.yml). Подробности — docs/development.md.

English

Bilem Agent is a Windows app that connects 1C:Enterprise databases (1C:Accounting for Kazakhstan) to AI assistants (Claude, ChatGPT, Cursor) over MCP. It reads data through the standard OData interface published for this machine only (127.0.0.1), prints documents that already exist in 1C (invoice, power of attorney, reconciliation statement) and can e-mail them on request. It never posts, changes or deletes accounting documents.

The app does not send data over the network unless the user explicitly asks for it (e-mailing a document, checking GitHub for updates).

Install: download BilemAgent-<version>.msi from Releases. Beta builds are not yet Microsoft-signed: on the SmartScreen prompt choose “More info → Run anyway”; on Windows Server unblock the downloaded file first (Properties → Unblock, or Unblock-File). Uninstall: remove each database in the app (Bases → Remove), then uninstall “Bilem Agent” in Windows Settings; C:\ProgramData\Bilem is kept unless you run msiexec /x … REMOVE_SETTINGS=1. Releases are signed: SHA256SUMS.sig (Ed25519) over SHA256SUMS. License: MIT. Security: see SECURITY.md.