用途
diadoc-mcp-ru 是一个 MCP（Model Context Protocol）服务器，将 Kontur Diadoc 的 EDI API 暴露给 AI 助手使用，使 AI 能够处理电子文档交换中的常见任务：查看收发文档、跟踪文档流转状态、管理交易对手及其 EDI 连接邀请、执行签名、处理机器可读授权书（МЧД）以及获取打印表单。
主要能力
根据官方文档 developer.kontur.ru/doc/diadoc-api 整理的接口目录存放在仓库的 diadoc_mcp/endpoints.yaml 中，共 114 个方法，其中 78 个为读取、29 个为写入、7 个为不可逆操作。服务器严格按此文件执行，因此方法列表与代码保持一致。
典型使用场景包括：
- 显示需要处理的收件文档；
- 汇总某段时间内与某交易对手的文档流转；
- 按 ИНН 和 КПП 查找交易对手，并检查其是否已接入 EDI；
- 下载文档的打印表单供财务使用。
使用方式
提供两种安装路径，按是否使用终端选择：
- 无终端：从发布页面下载 diadoc-mcp-ru-vX.Y.Z.mcpb 文件并双击打开，Claude Desktop 会自动安装服务器并在单独窗口询问密钥，无需手动编辑配置文件。需要 Python 3.10 或更新版本，首次启动时服务器会自行安装依赖。
- 手动：在 Claude Desktop 的 claude_desktop_config.json 中配置；具体配置内容请参考仓库说明。
应用标识需向 Kontur 发送邮件申请；生产环境需要许可证，测试可使用测试环境。用户令牌通过 Authenticate 方法用登录名和密码或证书获取。密钥可以不放在环境变量中，服务器支持“柜”（cabinets）机制，将其存入 ~/.ru-mcp/cabinets.json，权限 600，位于仓库之外。
服务器提供三个工具而不是 114 个函数：AI 代理用自然语言搜索方法、阅读方法卡片并调用。读取操作直接执行，写入和不可逆操作会要求确认。授权头不会离开服务域，即使调用任意路径也是如此。
检查安装：运行相关命令可打印加载的方法数量、是否找到密钥及来源，不会显示秘密内容；加 --live 会执行一次低成本的真实读取调用。
隐私与许可
服务器在用户机器上运行，密钥保存在本地 ~/.ru-mcp/cabinets.json，请求仅发往 Diadoc（Kontur）API，没有遥测，不收集或传输用户数据。完整隐私说明见 PRIVACY_POLICY.md。
项目采用 MIT 许可证，作者为 Ilya Utov。核心已抽取为 schema-mcp-core；相关服务器包括 vk-mcp-ru、sbis-mcp-ru、chestny-znak-mcp-ru；电商平台类项目为 marketplaces-mcp-ru。所有项目可在 ilyautov.github.io 按用途查看。
