{
  "markdown": "# diadoc-mcp-ru\n\n<!-- mcp-name: io.github.ilyautov/diadoc-mcp-ru -->\n\nAPI Диадока для ИИ-ассистентов: входящие и исходящие документы, статусы документооборота, контрагенты и приглашения к ЭДО, подписание, МЧД, печатные формы.\n\n[![PyPI](https://img.shields.io/pypi/v/diadoc-mcp-ru?label=pypi&color=B5491F)](https://pypi.org/project/diadoc-mcp-ru/)\n[![CI](https://github.com/ilyautov/diadoc-mcp-ru/actions/workflows/ci.yml/badge.svg)](https://github.com/ilyautov/diadoc-mcp-ru/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Методов](https://img.shields.io/badge/%D0%BC%D0%B5%D1%82%D0%BE%D0%B4%D0%BE%D0%B2-114-2D7D4F)](#карта-методов)\n[![Сайт](https://img.shields.io/badge/%D1%81%D0%B0%D0%B9%D1%82-business--mcp--ru-9A3E1A)](https://business-mcp-ru.aifrontier.tech/diadoc-api.html)\n[![Звёзды](https://img.shields.io/github/stars/ilyautov/diadoc-mcp-ru?style=flat&label=%D0%B7%D0%B2%D1%91%D0%B7%D0%B4%D1%8B&color=B5491F&logo=github&logoColor=white)](https://github.com/ilyautov/diadoc-mcp-ru/stargazers)\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-%D0%BF%D0%BE%D1%81%D1%82%D0%B0%D0%B2%D0%B8%D1%82%D1%8C-0098FF?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=diadoc&config=%7B%22command%22%3A%20%22uvx%22%2C%20%22args%22%3A%20%5B%22diadoc-mcp-ru%22%5D%2C%20%22env%22%3A%20%7B%22DIADOC_CLIENT_ID%22%3A%20%22%24%7Binput%3Adiadoc_client_id%7D%22%2C%20%22DIADOC_TOKEN%22%3A%20%22%24%7Binput%3Adiadoc_token%7D%22%7D%7D&inputs=%5B%7B%22id%22%3A%20%22diadoc_client_id%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22%D0%98%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%20%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F%20%D0%94%D0%B8%D0%B0%D0%B4%D0%BE%D0%BA%2C%20%D0%B2%D1%8B%D0%B4%D0%B0%D1%91%D1%82%20%D0%9A%D0%BE%D0%BD%D1%82%D1%83%D1%80.%22%7D%2C%20%7B%22id%22%3A%20%22diadoc_token%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22%D0%A2%D0%BE%D0%BA%D0%B5%D0%BD%20%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8F%20%D0%94%D0%B8%D0%B0%D0%B4%D0%BE%D0%BA%2C%20%D0%B2%D1%8B%D0%B4%D0%B0%D1%91%D1%82%20%D0%BC%D0%B5%D1%82%D0%BE%D0%B4%20Authenticate.%22%2C%20%22password%22%3A%20true%7D%5D)\n[![Install in Cursor](https://img.shields.io/badge/Cursor-%D0%BF%D0%BE%D1%81%D1%82%D0%B0%D0%B2%D0%B8%D1%82%D1%8C-000000?logo=cursor&logoColor=white)](https://cursor.com/en/install-mcp?name=diadoc&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJkaWFkb2MtbWNwLXJ1Il0sICJlbnYiOiB7IkRJQURPQ19DTElFTlRfSUQiOiAiIiwgIkRJQURPQ19UT0tFTiI6ICIifX0=)\n\n<p align=\"center\">\n  <a href=\"https://business-mcp-ru.aifrontier.tech/\">\n    <img src=\"assets/social-preview.png\" alt=\"diadoc-mcp-ru: API Диадока (Контур) в ИИ-ассистенте. 114 методов, поиск метода словами, гейт безопасности перед записью\" width=\"760\">\n  </a>\n</p>\n\nКаталог собран из первоисточника (документация `developer.kontur.ru/doc/diadoc-api`) и лежит в репозитории как\n`diadoc_mcp/endpoints.yaml`: **114 методов**, из них 78 на чтение,\n29 на запись и 7 необратимых. Сервер исполняет ровно этот файл,\nпоэтому таблица ниже не может разойтись с кодом.\n\n## Установка\n\n```bash\nuvx diadoc-mcp-ru\n```\n\nClaude Desktop, `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"diadoc-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"diadoc-mcp-ru\"],\n      \"env\": { \"DIADOC_CLIENT_ID\": \"...\", \"DIADOC_TOKEN\": \"...\" }\n    }\n  }\n}\n```\n\n## Ключи\n\nИдентификатор приложения запрашивается у Контура письмом, для продуктива нужна лицензия, для проб есть тестовый контур. Токен пользователя выдаёт метод Authenticate по логину и паролю или по сертификату.\n\n| переменная | секрет | что это |\n|---|---|---|\n| `DIADOC_CLIENT_ID` | нет | Идентификатор приложения Диадок, выдаёт Контур. |\n| `DIADOC_TOKEN` | да | Токен пользователя Диадок, выдаёт метод Authenticate. |\n\nКлючи можно не держать в окружении: сервер умеет кабинеты и кладёт их в\n`~/.ru-mcp/cabinets.json` с правами 600, вне репозитория.\n\n## Карта методов\n\n| раздел | методов | чтение | запись | необратимое |\n|---|---|---|---|---|\n| Документы | 17 | 10 | 5 | 2 |\n| Контрагенты | 14 | 8 | 4 | 2 |\n| Сотрудники и пользователи | 14 | 8 | 4 | 2 |\n| Сообщения | 11 | 6 | 5 | 0 |\n| Организации и ящики | 11 | 9 | 2 | 0 |\n| Машиночитаемая доверенность | 8 | 4 | 3 | 1 |\n| Подписание | 8 | 6 | 2 | 0 |\n| Генерация и разбор XML | 8 | 8 | 0 | 0 |\n| События | 7 | 6 | 1 | 0 |\n| Печатные формы | 6 | 6 | 0 | 0 |\n| Полка документов | 6 | 3 | 3 | 0 |\n| Документооборот | 4 | 4 | 0 | 0 |\n| **всего** | **114** | **78** | **29** | **7** |\n\n## Как это выглядит в чате\n\nВы: входящие документы\n\n```\ndiadoc_search_methods(\"входящие документы\")\n  diadoc_get_document          GET  /V3/GetDocument      чтение\n  diadoc_get_documents         GET  /V3/GetDocuments     чтение\n  diadoc_get_document_actions  GET  /GetDocumentActions  чтение\n\ndiadoc_describe_method(\"diadoc_get_document\")\n  Возвращает данные документа по указанному идентификатору.\n  GET diadoc-api.kontur.ru/V3/GetDocument\n  параметры: нет\n  класс доступа: чтение\n\ndiadoc_call_method(\"diadoc_get_document\", {})\n```\n\nТри инструмента вместо 114 функций: агент ищет метод словами,\nчитает его карточку и вызывает. Запись и необратимое спрашивают подтверждение.\n\nЧто обычно просят:\n\n- Показать входящие документы, по которым нужно действие.\n- Свести документооборот с контрагентом за период.\n- Найти контрагента по ИНН и КПП и проверить, подключён ли он к ЭДО.\n- Скачать печатную форму документа для бухгалтерии.\n\n## Безопасность\n\nСервер работает на машине пользователя, ключи наружу не уходят. У методов три\nкласса доступа: чтение идёт сразу, запись и необратимые действия требуют\nподтверждения. Заголовок авторизации не покидает домены сервиса даже при вызове\nпроизвольного пути.\n\n## Проверить установку\n\n```bash\nuvx diadoc-mcp-ru doctor\n```\n\nПечатает, сколько методов загрузилось, найдены ли ключи и откуда. Секреты не\nпоказывает. С `--live` делает один дешёвый реальный вызов на чтение.\n\n## Родня\n\nЯдро вынесено в [schema-mcp-core](https://github.com/ilyautov/schema-mcp-core).\nСоседние серверы: [hh-mcp-ru](https://github.com/ilyautov/hh-mcp-ru), [vk-mcp-ru](https://github.com/ilyautov/vk-mcp-ru), [sbis-mcp-ru](https://github.com/ilyautov/sbis-mcp-ru), [chestny-znak-mcp-ru](https://github.com/ilyautov/chestny-znak-mcp-ru).\nМаркетплейсы живут отдельно: [marketplaces-mcp-ru](https://github.com/ilyautov/marketplaces-mcp-ru).\n\nMIT. Автор [Илья Утов](https://github.com/ilyautov).\n\nВсе проекты одним списком, разобранные по назначению:\n[ilyautov.github.io](https://ilyautov.github.io/).\n",
  "bytes": 6623,
  "sha": "3a7fba668f73cd61088a36afb5a6956705793e10e1f7e54fea2dfec5b39d77c7",
  "repo_slug": "ilyautov/diadoc-mcp-ru",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ilyautov_diadoc_mcp_ru_385ed42f/readme"
}