Ekwo OS — MCP-сервер для Claude Code: запуск и функции
MCP-сервер связывает ИИ-агента с бухгалтерией Ekwo OS на Postgres или Supabase. Позволяет выставлять счета, проверять журнал проводок и сводить НДС с соблюдением прав доступа.
claude mcp add --transport http mcp https://mcp.ekwo.ai/mcpЧто делает Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres
Сервер открывает ассистенту доступ к двойной записи в базе данных Postgres или проекте Supabase. Агент умеет формировать черновики счетов, сопоставлять банковские выписки и готовить расчёты по НДС. Подключение работает в двух вариантах: удалённо по протоколу Streamable HTTP через https://mcp.ekwo.ai/mcp либо локально через stdio с помощью npx -y @ekwo-ai/mcp@latest.
Архитектура исключает опасные вольности модели. Сервер принципиально не принимает ключ service_role и завершает работу с ошибкой при попытке его передать. Все действия выполняются от имени конкретного пользователя через политики Row Level Security (RLS). Агент не увидит чужие компании или закрытые учётные периоды.
Удалять проведённые документы напрямую нельзя. Если в проведённом счёте допущена ошибка, база требует оформить сторно или корректировочную запись. Строки журнала создаются только встроенными процедурами схемы. Для прямого подключения к Postgres без PostgREST обязательно передавать EKWO_ACT_AS_USER_ID, а в среде должен быть установлен пакет postgres.
Какие задачи решает
- выставлять и регистрировать клиентские счета через диалог с агентом
- сверять банковские выписки и закрывать открытые платежи
- формировать отчёты и декларации по НДС на базе проводок
- проверять сальдо и записи главной книги без перехода в сторонний интерфейс
Примеры запросов агенту
- Проверь журнал проводок за прошлый месяц и найди неразнесённые платежи.
- Выстави черновик счёта для ООО "Вектор" на оплату консультационных услуг.
- Сформируй предварительный расчёт НДС по совершённым операциям за квартал.
Как установить Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://mcp.ekwo.ai/mcp2Командой платформы
claude mcp add --env SUPABASE_URL=<SUPABASE_URL> --env SUPABASE_ANON_KEY=<SUPABASE_ANON_KEY> --env EKWO_EMAIL=<EKWO_EMAIL> --env EKWO_PASSWORD=<EKWO_PASSWORD> --env EKWO_ACCESS_TOKEN=<EKWO_ACCESS_TOKEN> --transport stdio mcp -- npx -y @ekwo-ai/mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
1Командой платформы: удалённый сервер
codex mcp add mcp --url https://mcp.ekwo.ai/mcp2Командой платформы
codex mcp add mcp --env SUPABASE_URL=<SUPABASE_URL> --env SUPABASE_ANON_KEY=<SUPABASE_ANON_KEY> --env EKWO_EMAIL=<EKWO_EMAIL> --env EKWO_PASSWORD=<EKWO_PASSWORD> --env EKWO_ACCESS_TOKEN=<EKWO_ACCESS_TOKEN> -- npx -y @ekwo-ai/mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"mcp": {
"url": "https://mcp.ekwo.ai/mcp"
}
}
}{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@ekwo-ai/mcp"
],
"env": {
"SUPABASE_URL": "<SUPABASE_URL>",
"SUPABASE_ANON_KEY": "<SUPABASE_ANON_KEY>",
"EKWO_EMAIL": "<EKWO_EMAIL>",
"EKWO_PASSWORD": "<EKWO_PASSWORD>",
"EKWO_ACCESS_TOKEN": "<EKWO_ACCESS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.ekwo.ai/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ekwo-ai/mcp"
],
"env": {
"SUPABASE_URL": "<SUPABASE_URL>",
"SUPABASE_ANON_KEY": "<SUPABASE_ANON_KEY>",
"EKWO_EMAIL": "<EKWO_EMAIL>",
"EKWO_PASSWORD": "<EKWO_PASSWORD>",
"EKWO_ACCESS_TOKEN": "<EKWO_ACCESS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
1Командой платформы: удалённый сервер
gemini mcp add -t http mcp https://mcp.ekwo.ai/mcp2Командой платформы
gemini mcp add -e SUPABASE_URL=<SUPABASE_URL> -e SUPABASE_ANON_KEY=<SUPABASE_ANON_KEY> -e EKWO_EMAIL=<EKWO_EMAIL> -e EKWO_PASSWORD=<EKWO_PASSWORD> -e EKWO_ACCESS_TOKEN=<EKWO_ACCESS_TOKEN> mcp npx -y @ekwo-ai/mcpВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres
Как установить Ekwo OS в Claude Code?
Выполните в терминале команду claude mcp add --transport http mcp https://mcp.ekwo.ai/mcp. Инструмент подключится к удалённому серверу и запросит подтверждение авторизации через браузер.
Зачем нужен MCP-сервер Ekwo OS?
Он предоставляет ИИ-модели доступ к вашей бухгалтерской базе данных. Ассистент помогает разносить платежи, вести учёт и готовить налоговую отчётность в рамках прав конкретного пользователя.
Почему сервер запрещает использование ключа service_role?
Ключ администратора обходит политики безопасности строк (RLS), открывая доступ к данным чужих организаций. Сервер намеренно блокирует запуск с таким ключом и работает только через публичный анонимный ключ с токеном пользователя.
