SkillFoxx
Telegram

MCP-сервер Контур.Эльбы

Kontur.Elba MCP

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

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

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

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

  • Инструмент elba_request может создавать и менять счета, накладные, УПД и банковские счета
  • Любой POST, PUT или DELETE в схеме Эльбы меняет реальные бухгалтерские данные
Все причины и проверки
Российский стек

apo100l/elba-kontur-mcpАвтор:apo100l

Установка

Сервисы

Ручная установка

git clone https://github.com/apo100l/elba-kontur-mcp.git && cd elba-kontur-mcp && npm install && npm run build

Сборка из исходников, требуется Node.js 20 и новее.

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

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

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

  • Инструмент elba_request может создавать и менять счета, накладные, УПД и банковские счета
  • Любой POST, PUT или DELETE в схеме Эльбы меняет реальные бухгалтерские данные

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

Что делает

Сервер запускается локально по stdio и обращается к официальному Elba Public API Контур.Эльбы, передавая ключ только в заголовке X-Kontur-ApiKey. Он разрешает только те операции, что описаны в приложенной OpenAPI-схеме elba's, а не произвольные запросы. Четыре инструмента: список разрешенных операций с поиском, описание конкретной операции с телом запроса и ответами, быстрый список организаций по ключу и универсальный вызов любой операции схемы. Перед созданием или изменением данных агенту нужно сначала запросить описание операции, чтобы понять точную структуру тела запроса. Через универсальный вызов можно создавать банковские счета, контрагентов, товары, а также счета, акты, накладные и УПД.

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

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

  • Нужно быстро найти или создать контрагента прямо из чата с агентом
  • Нужно посмотреть схему создания счета или накладной перед тем, как создавать документ вручную
  • Нужен единый MCP-инструмент, который умеет вызвать любую операцию Elba Public API

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

  • Нужен готовый набор именованных инструментов под каждую операцию, а не универсальный вызов по схеме
  • Нельзя доверять агенту создание бухгалтерских документов без пошаговой проверки

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

Покажи схему создания счета, но пока ничего не создавай

MCP

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

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

ELBA_API_KEY обязательная, секрет
Ключ Elba Public API из настроек сервиса
ELBA_API_BASE_URL
Базовый URL API, по умолчанию https://elba-api.kontur.ru
ELBA_API_TIMEOUT_MS
Таймаут запроса в миллисекундах, по умолчанию 30000

Ограничения

0 звезд, автор один, репозиторий совсем свежий. Официальный статус у сервиса Контур.Эльба, а не у самого MCP-сервера: это независимая реализация поверх официального Elba Public API, а не проект СКБ Контур. Требуется собственный ключ API из настроек Эльбы, доступный по платному тарифу с включенным API.

Как отключить. Удалите блок elba-kontur-mcp из конфигурации MCP клиента и отзовите ключ ELBA_API_KEY в настройках сервиса Эльбы.

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

Сервер может выполнить любой запрос к Эльбе?

Нет, только операции, перечисленные в приложенной OpenAPI-схеме elba API; произвольные маршруты и URL отклоняются.

Как понять, какие поля нужны для создания документа?

Сначала вызвать elba_describe_operation для нужной операции: она вернет точные параметры и структуру тела запроса.

Обсуждение

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

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

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

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

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

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

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

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

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

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

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

ПлагинРасширенный доступ34
Российский стек

MCP-сервер по всему API Диадока (Контур): документы, контрагенты, подписание и МЧД, с подтверждением перед записью и необратимыми действиями

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

Коротко о README

README на русском объясняет, что сервер работает по stdio и ограничен операциями из openapi.json, дает пошаговую инструкцию получения ключа с предупреждением не хранить его в коде или .env в Git, показывает подключение в Codex и Claude Desktop, таблицу четырех инструментов, переменные окружения и раздел безопасности: ключ не пишется в логи, произвольные маршруты отклоняются, запросы ограничены таймаутом.

Бейдж для README

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