English Français العربية

Диадок MCP (RU) — ЭДО, документы, контрагенты

السجل الرسمي أخرى

API Диадока в ИИ-ассистенте: документы ЭДО, контрагенты, подписание, МЧД

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package diadoc-mcp-ru
Claude Code 
claude mcp add mcp-ru -e 'DIADOC_CLIENT_ID=<DIADOC_CLIENT_ID>' -e 'DIADOC_TOKEN=<your diadoc_token>' -- uvx diadoc-mcp-ru==0.3.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mcp-ru": {
            "command": "uvx",
            "args": [
                "diadoc-mcp-ru==0.3.0"
            ],
            "env": {
                "DIADOC_CLIENT_ID": "<DIADOC_CLIENT_ID>",
                "DIADOC_TOKEN": "<your diadoc_token>"
            }
        }
    }
}

متغيرات البيئة

  • DIADOC_CLIENT_ID Идентификатор приложения Диадок, выдаёт Контур.
  • DIADOC_TOKEN سري Токен пользователя Диадок, выдаёт метод Authenticate.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. diadoc-mcp-ru
  2. Установка
  3. Ключи
  4. Карта методов
  5. Как это выглядит в чате
  6. Безопасность
  7. Проверить установку
  8. Родня
  9. Privacy Policy

diadoc-mcp-ru

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

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

Установка

Два пути, выбирайте по тому, есть ли у вас терминал.

Без терминала: файл .mcpb

Скачайте diadoc-mcp-ru-vX.Y.Z.mcpb со страницы релизов и откройте двойным щелчком. Claude Desktop поставит сервер сам и спросит ключи в отдельном окне, в конфиг лезть не придётся. Нужен Python 3.10 или новее: зависимости сервер доставит себе при первом запуске.

В терминале
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, вне репозитория.

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

разделметодовчтениезаписьнеобратимое
Документы171052
Контрагенты14842
Сотрудники и пользователи14842
Сообщения11650
Организации и ящики11920
Машиночитаемая доверенность8431
Подписание8620
Генерация и разбор XML8800
События7610
Печатные формы6600
Полка документов6330
Документооборот4400
всего11478297

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

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

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. Соседние серверы: vk-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru. Маркетплейсы живут отдельно: marketplaces-mcp-ru.

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

Все проекты одним списком, разобранные по назначению: ilyautov.github.io.

Privacy Policy

diadoc-mcp-ru не собирает и не передаёт ваши данные: ключи лежат локально в ~/.ru-mcp/cabinets.json, запросы идут только в API Диадок (Контур), телеметрии нет. Полный текст: PRIVACY_POLICY.md.

الأسئلة الشائعة

ما هو Диадок MCP (RU) — ЭДО, документы, контрагенты؟

API Диадока в ИИ-ассистенте: документы ЭДО, контрагенты, подписание, МЧД

كيف أثبّت Диадок MCP (RU) — ЭДО, документы, контрагенты؟

يعمل على جهازك. في Claude Code: claude mcp add mcp-ru -e 'DIADOC_CLIENT_ID=<DIADOC_CLIENT_ID>' -e 'DIADOC_TOKEN=<your diadoc_token>' -- uvx diadoc-mcp-ru==0.3.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Диадок MCP (RU) — ЭДО, документы, контрагенты إلى مفتاح API؟

نعم. يتطلب DIADOC_TOKEN، وتضبطها في إعداداته.

هل Диадок MCP (RU) — ЭДО, документы, контрагенты مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Диадок MCP (RU) — ЭДО, документы, контрагенты؟

ينشره ilyautov. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.