diadoc-mcp-ru
API de Diadoc (Contour) en el asistente de IA: flujo de documentos con validez legal, firma, contrapartes, MChD. 114 métodos, la escritura solicita confirmación.
Documentación
diadoc-mcp-ru
API Диадока para asistentes de IA: documentos entrantes y salientes, estados del flujo de documentos, contrapartes e invitaciones a EDI, firma, MChD, formularios impresos.
El catálogo se compiló a partir de la fuente original (documentación de developer.kontur.ru/doc/diadoc-api) y se encuentra en el repositorio como
diadoc_mcp/endpoints.yaml: 114 métodos, de los cuales 78 son de lectura,
29 de escritura y 7 irreversibles. El servidor ejecuta exactamente este archivo,
por lo que la tabla siguiente no puede diferir del código.
Instalación
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": "..." }
}
}
}
Claves
El identificador de la aplicación se solicita a Kontur por carta; para producción se necesita una licencia; para pruebas existe un entorno de prueba. El token de usuario lo emite el método Authenticate mediante nombre de usuario y contraseña o mediante certificado.
| variable | secreto | qué es |
|---|---|---|
DIADOC_CLIENT_ID | no | Identificador de la aplicación Diadoc, lo emite Kontur. |
DIADOC_TOKEN | sí | Token de usuario de Diadoc, lo emite el método Authenticate. |
Las claves no tienen que estar en el entorno: el servidor admite perfiles y las guarda en
~/.ru-mcp/cabinets.json con permisos 600, fuera del repositorio.
Mapa de métodos
| sección | métodos | lectura | escritura | irreversible |
|---|---|---|---|---|
| Documentos | 17 | 10 | 5 | 2 |
| Contrapartes | 14 | 8 | 4 | 2 |
| Empleados y usuarios | 14 | 8 | 4 | 2 |
| Mensajes | 11 | 6 | 5 | 0 |
| Organizaciones y buzones | 11 | 9 | 2 | 0 |
| Poder notarial legible por máquina | 8 | 4 | 3 | 1 |
| Firma | 8 | 6 | 2 | 0 |
| Generación y análisis de XML | 8 | 8 | 0 | 0 |
| Eventos | 7 | 6 | 1 | 0 |
| Formularios impresos | 6 | 6 | 0 | 0 |
| Estante de documentos | 6 | 3 | 3 | 0 |
| Flujo de documentos | 4 | 4 | 0 | 0 |
| total | 114 | 78 | 29 | 7 |
Cómo se ve en el chat
Usted: documentos entrantes
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", {})
Tres herramientas en lugar de 114 funciones: el agente busca el método por palabras, lee su ficha y lo invoca. Las operaciones de escritura e irreversibles piden confirmación.
Lo que suele pedirse:
- Mostrar documentos entrantes que requieren acción.
- Conciliar el flujo de documentos con una contraparte por período.
- Buscar una contraparte por INN y KPP y comprobar si está conectada a EDI.
- Descargar el formulario impreso de un documento para contabilidad.
Seguridad
El servidor se ejecuta en la máquina del usuario; las claves no salen al exterior. Los métodos tienen tres clases de acceso: la lectura se realiza de inmediato; la escritura y las acciones irreversibles requieren confirmación. El encabezado de autorización no abandona los dominios del servicio ni siquiera al invocar una ruta arbitraria.
Verificar la instalación
uvx diadoc-mcp-ru doctor
Muestra cuántos métodos se cargaron, si se encontraron las claves y de dónde. No muestra
secretos. Con --live realiza una llamada real de lectura de bajo costo.
Familia
El núcleo está extraído en schema-mcp-core. Servidores vecinos: hh-mcp-ru, vk-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru. Los marketplaces viven por separado: marketplaces-mcp-ru.
MIT. Autor Ilya Utov.
Todos los proyectos en una sola lista, clasificados por propósito: ilyautov.github.io.