MCP-сервер Контур.Эльбы
Kontur.Elba MCP
MCP-сервер поверх официального Elba Public API: контрагенты, товары, счета, акты, накладные и УПД для ИП и малого бизнеса
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструмент elba_request может создавать и менять счета, накладные, УПД и банковские счета
- Любой POST, PUT или DELETE в схеме Эльбы меняет реальные бухгалтерские данные
Установка
Ручная установка
git clone https://github.com/apo100l/elba-kontur-mcp.git && cd elba-kontur-mcp && npm install && npm run buildСборка из исходников, требуется Node.js 20 и новее.
Проверка безопасности
Как мы проверяемВысокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
- Инструмент 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-серверыУтилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Скиллы Anthropic
Skills
Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов
Коротко о README
README на русском объясняет, что сервер работает по stdio и ограничен операциями из openapi.json, дает пошаговую инструкцию получения ключа с предупреждением не хранить его в коде или .env в Git, показывает подключение в Codex и Claude Desktop, таблицу четырех инструментов, переменные окружения и раздел безопасности: ключ не пишется в логи, произвольные маршруты отклоняются, запросы ограничены таймаутом.