SkillFoxx
Telegram

elba-mcp: MCP-сервер для Контур.Эльбы

elba-mcp

Счета, акты и УПД в Эльбе из чата с агентом, публичные ссылки на документы для клиентов и сводка неоплаченных счетов

  • 0 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Ключ API создает счета, акты и УПД от имени организации и видит данные ее клиентов
  • Журнал счетов на диске хранит реквизиты и суммы по клиентам
Все причины и проверки
Российский стек

igor-batrakov/elba-mcpАвтор:igor-batrakov

Установка

Сервисы

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/elba-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Ключ API создает счета, акты и УПД от имени организации и видит данные ее клиентов
  • Журнал счетов на диске хранит реквизиты и суммы по клиентам

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

MCP-сервер подключает Claude Code, Claude Desktop, Cursor и другие клиенты к публичному API Контур.Эльбы. Агент находит клиента по ИНН или названию, заводит нового, выставляет счет, акт или УПД, в том числе по образцу прошлого счета, и получает публичную ссылку на документ с печатью, подписью и QR-оплатой. Эльба не отдает список счетов, поэтому сервер ведет журнал выставленных счетов в каталоге состояния. По журналу и ленте новостей Эльбы он показывает оплаты с прошлой проверки, неоплаченные счета с общим долгом и сводку по проектам и периодам. Для типовых дел есть MCP-промпты `elba_invoice`, `elba_close_work` и `elba_remind_debtors`, письма клиентам они готовят только черновиками. Реквизиты по ИНН сервер берет из ЕГРЮЛ и ЕГРИП ФНС, ключ для этого не нужен.

Для кого. Фрилансерам, ИП и небольшим студиям, которые ведут учет в Эльбе и выставляют счета из проекта, где уже работает агент.

Подходит, если

  • Счет за выполненные работы нужно выставить одной фразой, пока проект открыт в Claude Code
  • Каждый месяц повторяется счет за поддержку, и его проще создать по образцу предыдущего
  • К закрытию месяца надо понять, кто оплатил, а кто должен дольше недели, и подготовить черновики напоминаний
  • Клиенту уходит ссылка на акт или УПД с подписью и QR-оплатой

Не подходит, если

  • Нужен PDF счета на диске: API Эльбы файл не отдает, клиент скачивает его по ссылке
  • Учет ведется в другой системе: сервер работает только с API Эльбы
  • Счета идут с НДС: по умолчанию сервер выставляет их без НДС, и ставку надо указывать явно

Пример запроса к агенту

Выстави ООО Ромашка счет на 40 000 за доработку сайта, проект romashka.ru, и подготовь письмо

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

ELBA_API_KEY обязательная, секрет
Ключ API Контур.Эльбы
ELBA_ORG_ID
Организация, если по ключу их несколько
ELBA_STATE_DIR
Каталог журнала счетов

Ограничения

Проект неофициальный, с СКБ Контур не связан. Нужны ключ API из настроек Эльбы и менеджер пакетов uv. PDF через API Эльбы скачать нельзя, клиенту уходит публичная ссылка. Журнал счетов лежит в `~/.local/state/elba-mcp` и хранит данные клиентов, поэтому его держат как бухгалтерские документы; счета, выставленные в Эльбе вручную, попадают туда только через `elba_track_bill`. Шаблон-оферта может описывать не тот договор, что ваши услуги, поэтому текст шаблона сверяют до первого счета.

Как отключить. Выполните `claude mcp remove elba` или уберите блок `elba` из конфигурации клиента, а ключ API отзовите в настройках Эльбы.

Частые вопросы

Как подключить elba-mcp к Claude Code?

Выполнить `claude mcp add --scope user elba -e ELBA_API_KEY=ключ -- uvx elba-mcp`. Ключ выпускают в Эльбе: «Настройки и оплата», «Настройки сервиса», «API».

Как узнать, какие счета оплачены?

Вызвать `elba_payment_news`: первый вызов лишь ставит отметку в ленте новостей, дальше сервер показывает оплаты с прошлого вызова. Общий долг считает `elba_unpaid`.

Создаст ли сервер дубль счета?

Нет: тому же клиенту на ту же сумму в пределах недели счет не создается без `allow_duplicate=true`. Второй акт или УПД по одному счету тоже блокируется.

Как вызвать инструмент без подключения MCP?

Из шелла командой вида `uvx elba-mcp call elba_find_contractor args.json`, где в `args.json` лежат аргументы, например ИНН клиента.

Какие документы создает сервер?

Счета, акты и УПД: `elba_create_bill`, `elba_create_act` и `elba_create_upd`, а по готовому счету акт и УПД делают `elba_act_from_bill` и `elba_upd_from_bill`.

Обсуждение

Вопросов и отзывов пока нет.

Контур — все инструменты
Российский стек

MCP-сервер поверх публичного API Контур.Эльбы: контрагенты, товары, счета, накладные и акты для ИП и небольших организаций

MCP-серверШирокий доступ
Российский стек

MCP-сервер поверх официального Elba Public API: контрагенты, товары, счета, акты, накладные и УПД для ИП и малого бизнеса

MCP-серверШирокий доступ
Российский стек

MCP-сервер для ЭДО Контур.Диадок: поиск организаций по ИНН, список и содержимое документов, отправка и подписание

MCP-серверШирокий доступ4
Российский стек

Монорепозиторий MCP-серверов для российских сервисов и API стран СНГ: платежи, CRM, маркетплейсы, доставка, HR и справочные данные

MCP-серверШирокий доступ38
Российский стек

Набор скиллов для операционки малого бизнеса в России: УСН, денежный поток, дебиторка, договоры, найм и проверка контрагента по ИНН

ПлагинРасширенный доступ34
Официальный

Официальный MCP-сервер Xero: агент смотрит счета, контакты, проводки и отчеты в бухгалтерии, а также создает счета, платежи и табели

MCP-серверШирокий доступ392

Коротко о README

Описаны установка через `uvx`, переменные окружения, таблица из 19 инструментов, журнал счетов, три сценария-промпта и запуск без MCP из шелла. Тесты идут на моке API, а CI гоняет их на macOS, Linux и Windows.

Бейдж для README

Сообщить о проблеме