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 или новее:
зависимости сервер доставит себе при первом запуске.
В терминале
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 функций: агент ищет метод словами,
читает его карточку и вызывает. Запись и необратимое спрашивают подтверждение.
Что обычно просят:
- Показать входящие документы, по которым нужно действие.
- Свести документооборот с контрагентом за период.
- Найти контрагента по ИНН и КПП и проверить, подключён ли он к ЭДО.
- Скачать печатную форму документа для бухгалтерии.
Безопасность
Сервер работает на машине пользователя, ключи наружу не уходят. У методов три
класса доступа: чтение идёт сразу, запись и необратимые действия требуют
подтверждения. Заголовок авторизации не покидает домены сервиса даже при вызове
произвольного пути.
Проверить установку
Печатает, сколько методов загрузилось, найдены ли ключи и откуда. Секреты не
показывает. С --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.