Skip to main content

diadoc-mcp-ru

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

PyPI CI 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_describe_method(...)    параметры, пагинация, класс доступа
diadoc_call_method(...)        вызов; запись спрашивает подтверждение

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

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

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

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

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

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. Автор Илья Утов.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

diadoc_mcp_ru-0.1.1.tar.gz (18.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

diadoc_mcp_ru-0.1.1-py3-none-any.whl (14.7 kB view details)

Uploaded Python 3

File details

Details for the file diadoc_mcp_ru-0.1.1.tar.gz.

File metadata

  • Download URL: diadoc_mcp_ru-0.1.1.tar.gz
  • Upload date:
  • Size: 18.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for diadoc_mcp_ru-0.1.1.tar.gz
Algorithm Hash digest
SHA256 c72ca565e22d0ec6bf163250ecb27b30924beb985c27a56aa38febdd56df912e
MD5 7f6d36f39304350387400036c17a89be
BLAKE2b-256 9f7a6ce946d80a35b96fa315bcb78945abbcd1f1733ff674302ac9a065bb52d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for diadoc_mcp_ru-0.1.1.tar.gz:

Publisher: publish-pypi.yml on ilyautov/diadoc-mcp-ru

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file diadoc_mcp_ru-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: diadoc_mcp_ru-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 14.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for diadoc_mcp_ru-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d673ce8a5295b88b4506107306e2ab4510e53a4ba98964e0dfe0c16505c3d20f
MD5 8aa182134cd8f669cd2915ff921f0777
BLAKE2b-256 1126b045e152630ac1cef06aa7b5fc1c915cf1693629cc05676c6a2c233be53a

See more details on using hashes here.

Provenance

The following attestation bundles were made for diadoc_mcp_ru-0.1.1-py3-none-any.whl:

Publisher: publish-pypi.yml on ilyautov/diadoc-mcp-ru

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.2.0

2 files

This release

0.1.1 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page