Что ИИ-агент делает в Диадоке и Эльбе
- Находит контрагента и документы. Контур.Диадок MCP ищет организации по ИНН и КПП и показывает документы ящика с фильтрами по типу и статусу.
- Отправляет и подписывает документы. Тот же сервер передает документ контрагенту и подписывает входящие. Квалифицированную подпись он не создает. Ее формируют отдельно, например в КриптоПро, и передают в base64.
- Выставляет счета и акты в Эльбе. MCP-сервер Контур.Эльбы с 4 инструментами вызывает только операции из OpenAPI-схемы Elba Public API, среди них счета, акты, накладные и УПД.
- Ведет контрагентов и товары. MCP-сервер для Контур.Эльбы запускается в Docker из Claude Desktop и следит за долгими операциями по статусу задачи.
- Проверяет компанию через Фокус. В монорепозитории WWmcp есть отдельный сервер Контур.Фокуса, который ставится своим npm-пакетом.
- Встраивает Диадок в операционку малого бизнеса. Набор small-business-ru подключает Диадок вместе с 1С, ЮKassa и Битрикс24 по желанию, а без них работает по выгрузкам CSV и Excel.
Как получить ключ API Диадока
Доступ к API Диадока открывается по заявке на странице интеграции. Менеджер выдает доступ в Кабинет интегратора и идентификатор приложения client_id. В Кабинете интегратора, в разделе «API-ключи», выпускают client_secret и получают токен доступа по OpenID Connect через identity.kontur.ru.
Документация описывает 3 алгоритма получения токена. Для роботизированных решений она советует Refresh Token Flow, в котором приложение продлевает доступ без участия человека, и сервисную учетную запись с нужными правами вместо личной записи сотрудника. Срок жизни токена ограничен, поэтому его обновляют по refresh_token. Смена алгоритма в Кабинете интегратора вступает в силу примерно через 5 минут.
Тестовая площадка работает на diadoc-api-staging.kontur.ru, а рабочая на diadoc-api.kontur.ru. В быстром старте 2 тестовых ящика создают через форму, добавляют друг другу в контрагенты и отправляют документ с признаком тестовой подписи.
Контур.Диадок MCP авторизуется ключом разработчика, логином и паролем. Сверьте эту схему с текущей документацией Диадока до подключения к рабочему ящику. В агента сервер добавляет npx skillfoxx add mcp/kontur-diadoc-mcp.
Ключ Эльбы берут в ее настройках. Он доступен на платном тарифе с включенным API. Серверу Фокуса в WWmcp нужен собственный ключ этого сервиса.
Какой сервер выбрать
Официального MCP от Контура в каталоге нет. Все серверы сделали сторонние разработчики, и работают они без VPN. Серверы Диадока и Эльбы получили широкий уровень доступа: они отправляют юридически значимые документы или меняют бухгалтерские данные. Расширенный доступ у набора small-business-ru, потому что он работает с выгрузками и обращается к государственным реестрам. Налоговые ставки в нем заложены на 2026 год, и их нужно сверять с действующими нормами.
Серверы для Эльбы устроены по-разному. Сервер на OpenAPI-схеме запускается по stdio и требует, чтобы агент перед записью запросил описание операции. Docker-сервер дает готовые инструменты под счета и накладные, но образ придется собрать локально, а README не описывает лимиты API.
Серверы для 1С, МойСклада и банков ищите в российском стеке.
Ограничения и безопасность
Документ, подписанный в Диадоке, имеет юридическую силу. На первом этапе агенту хватит тестовой подписи в песочнице, а реальные документы пусть подписывает человек.
Контур.Диадок MCP хранит логин и пароль учетной записи, поэтому заведите для него отдельного пользователя с доступом только к нужному ящику. В Эльбе любой запрос на создание или изменение меняет реальный учет, и счета от агента стоит проверить до отправки контрагенту.
Docker-сервер Эльбы отчетность в налоговую не сдает: его задача ограничена документами и контрагентами.