diadoc-mcp-ru

API Диадока для ИИ-ассистентов: входящие и исходящие документы, статусы документооборота, контрагенты и приглашения к ЭДО, подписание, МЧД, печатные формы.

PyPI License: MIT Методов Сайт Звёзды

Install in VS Code Install in Cursor

Каталог собран из первоисточника (документация developer.kontur.ru/doc/diadoc-api) и лежит в репозитории как diadoc_mcp/endpoints.yaml: 114 методов, из них 78 на чтение, 29 на запись и 7 необратимых. Сервер исполняет ровно этот файл, поэтому таблица ниже не может разойтись с кодом.

Установка

uvx diadoc-mcp-ru

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "diadoc-mcp": {
      "command": "uvx",
      "args": ["diadoc-mcp-ru"],
      "env": { "DIADOC_CLIENT_ID": "...", "DIADOC_TOKEN": "..." }
    }
  }
}

Ключи

Идентификатор приложения запрашивается у Контура письмом, для продуктива нужна лицензия, для проб есть тестовый контур. Токен пользователя выдаёт метод Authenticate по логину и паролю или по сертификату.

переменная	секрет	что это
`DIADOC_CLIENT_ID`	нет	Идентификатор приложения Диадок, выдаёт Контур.
`DIADOC_TOKEN`	да	Токен пользователя Диадок, выдаёт метод Authenticate.

Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в ~/.ru-mcp/cabinets.json с правами 600, вне репозитория.

Карта методов

раздел	методов	чтение	запись	необратимое
Документы	17	10	5	2
Контрагенты	14	8	4	2
Сотрудники и пользователи	14	8	4	2
Сообщения	11	6	5	0
Организации и ящики	11	9	2	0
Машиночитаемая доверенность	8	4	3	1
Подписание	8	6	2	0
Генерация и разбор XML	8	8	0	0
События	7	6	1	0
Печатные формы	6	6	0	0
Полка документов	6	3	3	0
Документооборот	4	4	0	0
всего	114	78	29	7

Как это выглядит в чате

Вы: входящие документы

diadoc_search_methods("входящие документы")
  diadoc_get_document          GET  /V3/GetDocument      чтение
  diadoc_get_documents         GET  /V3/GetDocuments     чтение
  diadoc_get_document_actions  GET  /GetDocumentActions  чтение

diadoc_describe_method("diadoc_get_document")
  Возвращает данные документа по указанному идентификатору.
  GET diadoc-api.kontur.ru/V3/GetDocument
  параметры: нет
  класс доступа: чтение

diadoc_call_method("diadoc_get_document", {})

Три инструмента вместо 114 функций: агент ищет метод словами, читает его карточку и вызывает. Запись и необратимое спрашивают подтверждение.

Что обычно просят:

Показать входящие документы, по которым нужно действие.
Свести документооборот с контрагентом за период.
Найти контрагента по ИНН и КПП и проверить, подключён ли он к ЭДО.
Скачать печатную форму документа для бухгалтерии.

Безопасность

Сервер работает на машине пользователя, ключи наружу не уходят. У методов три класса доступа: чтение идёт сразу, запись и необратимые действия требуют подтверждения. Заголовок авторизации не покидает домены сервиса даже при вызове произвольного пути.

Проверить установку

uvx diadoc-mcp-ru doctor

Печатает, сколько методов загрузилось, найдены ли ключи и откуда. Секреты не показывает. С --live делает один дешёвый реальный вызов на чтение.

Родня

Ядро вынесено в schema-mcp-core. Соседние серверы: hh-mcp-ru, vk-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru. Маркетплейсы живут отдельно: marketplaces-mcp-ru.

MIT. Автор Илья Утов.