Ekwo OS MCP
Бухгалтерия Ekwo OS на вашем Supabase: Claude проводит счета, сопоставляет платежи и готовит НДС под вашими правами
- 42 ★ репозитория
- Последний коммит
- AGPL-3.0
Широкий доступ
Почему такой уровень
- Агент читает главную книгу и банковские данные компании и может создавать счета, платежи и проводки
- Пароль пользователя или токен сессии хранится в конфигурации клиента
- Подготовленные декларации по НДС и налогу влияют на отчетность перед налоговой
Установка
- Работает в
Ручная установка
npx -y ekwo-os@latest initСтавит ядро и пакеты стран в ваш проект Supabase, нужен Node 20+.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает главную книгу и банковские данные компании и может создавать счета, платежи и проводки
- Пароль пользователя или токен сессии хранится в конфигурации клиента
- Подготовленные декларации по НДС и налогу влияют на отчетность перед налоговой
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ekwo OS — двойная бухгалтерия с открытым кодом для вашей базы Postgres в Supabase. Схема, правила налогов по странам и команда ekwo лежат в одном пакете, а MCP-сервер дает ИИ-агенту работать с теми же книгами: прочитать главную книгу, выставить счет, провести его, сопоставить платеж и подготовить декларацию по НДС. Сервер действует от имени человека под политиками безопасности на уровне строк вашей установки и никогда не использует ключ service_role: при запуске с таким ключом он отказывается работать. Проводки создают только функции схемы, прямой записи строки главной книги нет. Инструментов удаления или правки проведенной проводки нет: счет возвращают в черновик или закрывают кредит-нотой. Обратиться к серверу можно двумя путями. Размещенный вариант https://mcp.ekwo.ai/mcp подключается как удаленный сервер с входом через браузер, а на экране согласия человек решает, может ли агент писать. Локальный запускается командой `npx -y @ekwo-ai/mcp@latest` по stdio и входит в Supabase под пользователем. Для каждой страны готовы пакеты данных: план счетов, налоги, формы деклараций и финансовые отчеты. Из них собирают файлы вроде французского FEC, XBRL, Peppol UBL и Factur-X. Есть модули основных средств, бюджетов, налога на прибыль и электронных счетов.
Для кого. Небольшим компаниям и бухгалтерским фирмам, которые ведут учет на своей базе Supabase и хотят поручить Claude подготовку проводок и НДС.
Подходит, если
- Счет поставщика пришел на иностранном языке, и его надо разнести по проводкам с подтверждением
- Банковская выписка загружена, платежи требуется сопоставить со счетами
- Перед сдачей декларации по НДС нужно собрать данные из книг
- Хочется ответов о запасе денег и скорости оплаты покупателей по данным книг
- Бухгалтерская фирма ведет несколько компаний в одной установке с отдельными правами
Не подходит, если
- Нужен готовый облачный сервис без своей базы: ставить придется Supabase, либо брать Ekwo Cloud
- Страна не входит в список поддерживаемых пакетов
- Требуется юридическая гарантия декларации: README отсылает к DISCLAIMER.md, это инструмент, а не бухгалтер
- Агенту надо дать право записи без решения человека: у размещенного сервера запись разрешает сам человек на экране согласия
Пример запроса к агенту
Покажи неоплаченные счета покупателей и подготовь черновик декларации по НДС за прошлый квартал. Ничего не проводи без моего подтверждения.MCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Переменные окружения
SUPABASE_URLобязательная- Адрес вашего проекта Supabase.
SUPABASE_ANON_KEYобязательная- Публичный (anon) ключ Supabase.
EKWO_EMAILобязательная- Адрес пользователя, от лица которого работает сервер.
EKWO_PASSWORDобязательная, секрет- Пароль пользователя. Вместо пары почты и пароля можно задать EKWO_ACCESS_TOKEN.
Ограничения
Нужен проект Supabase и Node 20 или новее, бесплатного тарифа Supabase хватает для старта. Установщик спрашивает строку подключения, страну, план счетов и первого администратора.
После установки README советует отключить публичную регистрацию в Supabase, держать двух администраторов и не хранить ключ service_role на лишних машинах.
Лицензия AGPL-3.0, для вкладов нужно подписать CLA. Проверка сервера идет в Postgres, собранном в WebAssembly, поэтому поведение на вашей версии Supabase стоит проверить командой `ekwo doctor`.
Подготовка декларации остается оценкой до подтверждения владельцем: налог на прибыль модуль считает как расчетную величину.
Как отключить. Удалите запись ekwo из конфигурации MCP-клиента. Размещенный сервер отключается в настройках подключений клиента, книги остаются в вашей базе Supabase, ее удаляют отдельно.
Частые вопросы
Как установить Ekwo OS?
Создайте проект на supabase.com и выполните `npx -y ekwo-os@latest init`. Установщик применит миграции, загрузит пакеты стран, создаст администратора в вашем Supabase Auth и откроет первый финансовый год. Повторный запуск ничего не дублирует.
Как подключить MCP-сервер Ekwo к Claude Code?
Добавьте в .mcp.json сервер с command npx, args -y @ekwo-ai/mcp@latest и env: SUPABASE_URL, SUPABASE_ANON_KEY, EKWO_EMAIL и EKWO_PASSWORD. Размещенный вариант https://mcp.ekwo.ai/mcp требует аккаунта Ekwo Cloud.
Может ли агент испортить проведенные записи?
Нет. Инструментов удаления и правки проведенной проводки нет, а закрытый период блокирует запись на уровне триггера. Отмена идет через возврат счета в черновик или кредит-ноту.
Какие страны поддерживаются?
Для каждой страны из списка в README есть пакет данных, и установщик ставит их все. Версия и статус проверки каждого пакета указаны в docs/packs.md репозитория.
Что такое Ekwo Cloud?
Веб-приложение той же команды на тех же книгах: счета, выписки, декларации по НДС и электронные счета. Размещенный MCP-сервер работает через Ekwo Cloud и требует бесплатной учетной записи.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыBeancount.io дает агенту книги учета: запросы BQL, правка файлов, проводки, разбор выписок и импорт из банка.
Официальный MCP-сервер Xero: агент смотрит счета, контакты, проводки и отчеты в бухгалтерии, а также создает счета, платежи и табели
Счета, акты и УПД в Эльбе из чата с агентом, публичные ссылки на документы для клиентов и сводка неоплаченных счетов
MCP подключает к AI-ассистенту налоговые справочники по юрисдикциям, где ставки и сроки сопровождаются источниками.
Плагин Claude Code ведет шведскую бухгалтерию через MCP: проводки, НДС, зарплата и закрытие периода только с вашего согласия.
MCP-эндпоинт графов RoboSystems: агент запрашивает финансовые данные компании и отчетность SEC XBRL в графе знаний
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Ekwo OS (эта карточка) | да | OAuth | 42 | |
| Xero MCP Server | да | OAuth | 392 | подключение к облачной бухгалтерии Xero |
| QuickBooks Online MCP Server | да | OAuth | 450 | подключение к QuickBooks Online |
| Odoo MCP | нет | API-ключ | 432 | доступ к ERP Odoo |
Коротко о README
README объясняет идею: данные принадлежат бизнесу, а работу с ними выполняет ПО, которым он тоже владеет. Далее идут перечень состава (ядро, пакеты стран, командная строка, MCP-сервер, модули, финансовый анализ), установка на свой Supabase, схема прав и безопасность.