diadoc-mcp-ru
API do Diadoc (Contour) no assistente de IA: fluxo de documentos juridicamente significativo, assinatura, contrapartes, MChD. 114 métodos, a gravação solicita confirmação.
Documentação
diadoc-mcp-ru
API do Diadoc para assistentes de IA: documentos recebidos e enviados, status do fluxo de documentos, contrapartes e convites para EDI, assinatura, MChD, formulários impressos.
O catálogo foi montado a partir da fonte original (documentação developer.kontur.ru/doc/diadoc-api) e está no repositório como
diadoc_mcp/endpoints.yaml: 114 métodos, sendo 78 de leitura,
29 de escrita e 7 irreversíveis. O servidor executa exatamente esse arquivo,
portanto a tabela abaixo não pode divergir do código.
Instalação
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": "..." }
}
}
}
Chaves
O identificador do aplicativo é solicitado à Kontur por carta; para produção é necessária uma licença; para testes existe um ambiente de teste. O token do usuário é emitido pelo método Authenticate com login e senha ou com certificado.
| variável | segredo | o que é |
|---|---|---|
DIADOC_CLIENT_ID | não | Identificador do aplicativo Diadoc, emitido pela Kontur. |
DIADOC_TOKEN | sim | Token do usuário Diadoc, emitido pelo método Authenticate. |
As chaves não precisam ficar no ambiente: o servidor suporta cofres e as armazena em
~/.ru-mcp/cabinets.json com permissões 600, fora do repositório.
Mapa de métodos
| seção | métodos | leitura | escrita | irreversível |
|---|---|---|---|---|
| Documentos | 17 | 10 | 5 | 2 |
| Contrapartes | 14 | 8 | 4 | 2 |
| Funcionários e usuários | 14 | 8 | 4 | 2 |
| Mensagens | 11 | 6 | 5 | 0 |
| Organizações e caixas | 11 | 9 | 2 | 0 |
| Procuração legível por máquina | 8 | 4 | 3 | 1 |
| Assinatura | 8 | 6 | 2 | 0 |
| Geração e análise de XML | 8 | 8 | 0 | 0 |
| Eventos | 7 | 6 | 1 | 0 |
| Formulários impressos | 6 | 6 | 0 | 0 |
| Prateleira de documentos | 6 | 3 | 3 | 0 |
| Fluxo de documentos | 4 | 4 | 0 | 0 |
| total | 114 | 78 | 29 | 7 |
Como fica no chat
Você: documentos recebidos
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", {})
Três ferramentas em vez de 114 funções: o agente busca o método por palavras, lê o cartão dele e o chama. Escrita e ações irreversíveis pedem confirmação.
O que costumam pedir:
- Mostrar documentos recebidos que exigem ação.
- Conciliar o fluxo de documentos com uma contraparte em um período.
- Encontrar uma contraparte por INN e KPP e verificar se ela está conectada ao EDI.
- Baixar o formulário impresso do documento para a contabilidade.
Segurança
O servidor roda na máquina do usuário; as chaves não saem para fora. Os métodos têm três classes de acesso: leitura é imediata; escrita e ações irreversíveis exigem confirmação. O cabeçalho de autorização não sai dos domínios do serviço, mesmo ao chamar um caminho arbitrário.
Verificar a instalação
uvx diadoc-mcp-ru doctor
Mostra quantos métodos foram carregados, se as chaves foram encontradas e de onde. Segredos não são
exibidos. Com --live faz uma chamada real barata de leitura.
Relacionados
O núcleo foi extraído para schema-mcp-core. Servidores vizinhos: hh-mcp-ru, vk-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru. Os marketplaces ficam separados: marketplaces-mcp-ru.
MIT. Autor Ilya Utov.
Todos os projetos em uma lista, organizados por finalidade: ilyautov.github.io.