infaton-1c-mcp

Servidor MCP INFATON para 1C:Enterprise

Model Context Protocol (MCP) — servidor no lado do 1C:Enterprise, fornecendo 93 ferramentas para interação de assistentes de IA com o banco de dados 1C.

Protocolo: JSON-RPC 2.0 (especificação MCP)

Parte da plataforma INFATON — gêmeos digitais e agentes de IA sobre 1C:ERP. Empresa: infaton.ru · Produto: chatmcp.ru (ChatMCP — chat gêmeo sobre seu 1C:ERP).

---

🏗 Quem usa

INFATON MCP Server — motor de acesso de IA ao 1C nos produtos da plataforma INFATON:

• eventcode.ru — plataforma de desenvolvimento sob encomenda: agentes de IA conduzem projetos e trabalham com o 1C:ERP do cliente através deste servidor MCP.
• chatmcp.ru — ChatMCP, gêmeo digital sobre 1C:ERP: interface de chat e estações de trabalho (APM) sobre este servidor MCP.

O servidor é aberto (MIT) — use em seu produto, veja Início Rápido.

---

📋 Composição do repositório

Arquivo	Descrição
Module.bsl	Módulo do serviço HTTP MCP — código principal, 93 ferramentas (7.350 linhas)
index.mjs	Wrapper Node.js stdio para clientes MCP (Claude Desktop, Cursor e outros)
package.json	Manifesto npm para publicação e execução via npx
glama.json	Manifesto para o catálogo Glama.ai
build .cfe	Monte a extensão a partir de Module.bsl (v6.2.1) — veja HOW_TO_BUILD_CFE.md
HOW_TO_BUILD_CFE.md	Instruções de build e instalação .cfe
EXAMPLES.md	Exemplos de cenários de agentes (7 casos)
CHANGELOG.md	Histórico de versões

---

🆕 Novidades na v6.2.1

• Gravação segura de referências compostas por GUID (6.2.1): o objeto é verificado em cada tipo permitido, GUID inexistente é rejeitado.
• fill_counterparty_by_inn (6.2.0): dados do contraparte por INN via 1C:Contraparte padrão (leitura, sem gravação).
• get_config_fingerprint (6.1.0): impressão digital barata da composição da configuração.

🆕 Novidades na v6.0.2

59 → 91 ferramentas (+32): relatórios SKD para configurações típicas 1C:ERP (run_report, get_report_options…), auditoria de direitos (get_rights_for_user, export_role_matrix), configurações de usuário (set_constant, set_functional_option, set_user_setting…), snapshots e comparação (snapshot_document_state, compare_snapshots, document_chain), dados de negócios ERP (get_stock_by_warehouse, get_unfulfilled_order_lines, get_reservation_status). Além disso, gravação de campos de referência e enumerações (resolução _guid para cabeçalho e linhas de partes tabulares). Lista completa — em CHANGELOG.md.

---

🆕 Novidades na v2.1.0

Correções (9 patches)

#	Ferramenta	Bug	Correção
P1	get_list	Ausência de ПЕРВЫЕ N — retornava TODOS os registros	Adicionado ПЕРВЫЕ com parâmetro limit (padrão 100)
P2	get_document_list	Filtro por data — Дата >= sem parâmetro	Adicionado Запрос.УстановитьПараметр para datas
P3	get_object_by_ref	Referência vazia → erro confuso da plataforma	Adicionada verificação Если НЕ ЗначениеЗаполнено(Ссылка)
P4	get_active_users / get_locks	Iteração direta da coleção de sessões → erro no servidor	Migração para МассивСеансов = ПолучитьСеансыИнформационнойБазы()
P5	get_event_log	Data passada como string + campo "Metadados" em vez de representação	ПреобразоватьДату() + .МетаданныеПредставление
P6	ПреобразоватьДату	Não processava 2026-05-14, 14.05.2026, 20260514	Reescrita completa: ISO 8601 + 3 formatos
P7	fill_on_basis	Объект.Заполнить() → método correto ЗаполнитьНаОсновании()	Chamada de método corrigida
P8	execute_batch	execute_batch aninhado → recursão infinita	Adicionado flag de proteção _batch_depth
P9	—	Versão permanecia 2.0.0	Atualizada para 2.1.0

Novas ferramentas (10 itens, grupo З)

#	Ferramenta	Finalidade
42	get_balance	Saldos e movimentações do registro contábil (qualquer plano de contas)
43	get_register_totals	Totais de registros de acumulação (saldos/movimentações)
44	get_accounting_entries	Lançamentos contábeis do documento (Débito, Crédito, valor)
45	get_related_documents	Cadeia de documentos relacionados (entrada com base)
46	validate_document	Verificação de preenchimento do documento sem lançamento
47	get_form_structure	Estrutura do formulário gerenciado (atributos, comandos)
48	get_rights	Direitos de acesso do usuário atual ao objeto
49	find_duplicates	Busca de duplicatas em diretórios por atributos
50	get_print_form	Formulários de impressão via subsistema GerenciamentoDeImpressão
51	get_configuration_extensions	Lista de extensões de configuração (CFE)

---

🛠 Catálogo de ferramentas

Abaixo — catálogo base (51 ferramentas, grupos A–З). Na v6.0.2 foram adicionadas mais 32 (relatórios/SKD, direitos, configurações de usuário, snapshots, dados de negócios 1C:ERP) — lista completa de 93 em Module.bsl e CHANGELOG.md.

Grupo A — Metadados (8)

#	Ferramenta	Descrição
1	get_metadata_tree	Árvore de objetos de metadados da configuração
2	get_object_metadata	Estrutura completa do objeto (atributos, partes tabulares, módulos)
3	get_object_attributes	Lista de atributos do objeto
4	get_object_tabular_sections	Partes tabulares do objeto
5	get_enum_values	Valores de enumeração
6	get_register_dimensions	Dimensões, recursos e atributos do registro
7	get_document_movements	Movimentações do documento por registros
8	search_metadata	Busca em metadados (por nome/sinônimo)

Grupo B — Leitura de dados (7)

#	Ferramenta	Descrição
9	execute_query	Execução de consulta 1C arbitrária
10	get_object_by_ref	Obtenção de objeto por referência/GUID
11	get_list	Lista de itens de diretório/documento com filtros
12	find_by_code	Busca de item por código
13	find_by_name	Busca de item por nome
14	get_register_records	Registros do registro com filtros
15	get_document_list	Lista de documentos com filtros por data/número

Grupo C — CRUD (7)

#	Ferramenta	Descrição
16	create_object	Criação de novo objeto (diretório/documento)
17	update_object	Alteração de atributos do objeto
18	delete_object	Marcação para exclusão
19	post_document	Lançamento do documento
20	unpost_document	Cancelamento do lançamento
21	copy_object	Cópia do objeto
22	set_attribute	Alteração de atributo individual

Grupo D — Código e relatórios (4)

#	Ferramenta	Descrição
23	execute_code	Execução de código arbitrário na linguagem embutida
24	evaluate_expression	Cálculo de expressão e retorno do resultado
25	get_module_text	Obtenção do texto do módulo do objeto
26	generate_report	Geração de relatório (SKD)

Grupo E — Administração (6)

#	Ferramenta	Descrição
27	get_active_users	Lista de usuários ativos e sessões
28	get_event_log	Log de registro com filtros
29	get_locks	Bloqueios de dados atuais
30	get_server_info	Informações sobre plataforma, configuração, servidor
31	check_references	Verificação de integridade referencial
32	run_scheduled_job	Execução de tarefa agendada

Grupo F — Integração (3)

#	Ferramenta	Descrição
33	exchange_execute	Execução de troca de dados
34	get_exchange_log	Log de troca
35	import_data	Importação de dados de JSON

Grupo G — Operações avançadas v2.0 (6)

#	Ferramenta	Descrição
36	fill_on_basis	Preenchimento de documento com base em outro
37	write_register_records	Gravação de conjunto de registros do registro
38	update_tabular_section	Atualização de parte tabular do objeto
39	subscribe_events	Assinatura de eventos do log
40	execute_batch	Execução em lote de ferramentas
41	get_changes_since	Obtenção de alterações com carimbo de tempo (CDC)

Grupo З — Contabilidade, auditoria, formulários v2.1 (10) 🆕

#	Ferramenta	Descrição
42	get_balance	Saldos/movimentações do registro contábil
43	get_register_totals	Totais de registros de acumulação
44	get_accounting_entries	Lançamentos do documento (Débito/Crédito/Valor)
45	get_related_documents	Documentos relacionados (cadeia de bases)
46	validate_document	Verificação de preenchimento sem lançamento
47	get_form_structure	Estrutura do formulário gerenciado
48	get_rights	Direitos de acesso do usuário atual
49	find_duplicates	Busca de duplicatas por atributos
50	get_print_form	Formulários de impressão via GerenciamentoDeImpressão
51	get_configuration_extensions	Lista de extensões de configuração (CFE)

---

🚀 Início Rápido

Opção 1: Via Claude Desktop / Cursor (stdio)

Método A — via npx (sem clonagem)

{
  "mcpServers": {
    "1c-erp": {
      "command": "npx",
      "args": ["infaton-mcp"],
      "env": {
        "ONEC_URL": "https://your-server/base/hs/mcp/",
        "ONEC_USER": "Username",
        "ONEC_PASSWORD": "Password"
      }
    }
  }
}

Método B — do repositório clonado

{
  "mcpServers": {
    "1c-erp": {
      "command": "node",
      "args": ["/path/to/MCP35/index.mjs"],
      "env": {
        "ONEC_URL": "https://your-server/base/hs/mcp/",
        "ONEC_USER": "Username",
        "ONEC_PASSWORD": "Password"
      }
    }
  }
}

Opção 2: Chamada HTTP direta

1. Instale a extensão

1. Abra o Configurador do banco 1C
2. Configuração → Extensões de configuração → Adicionar
3. Selecione o arquivo INFATON_MCP.cfe (ou monte conforme instruções a partir de Module.bsl)
4. Atualize a configuração do banco (F7)

2. Verifique a conexão

curl -u 'Логин:Пароль' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1}' \
  https://ваш-сервер/база/hs/mcp/

Resposta esperada:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": { "tools": {} },
    "serverInfo": { "name": "infaton-1c-mcp", "version": "6.2.1" }
  }
}

3. Chame a ferramenta

curl -u 'Логин:Пароль' -X POST \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":2,"params":{"name":"get_balance","arguments":{"account_code":"41.01","period_from":"2026-01-01T00:00:00","period_to":"2026-03-31T23:59:59"}}}' \
  https://ваш-сервер/база/hs/mcp/

---

📐 Arquitetura

┌─────────────────────────┐
│   AI Assistant          │  Claude / GPT / Qwen / Gemini / ...
│   (MCP Client)          │
└────────┬────────────────┘
         │ stdio (JSON-RPC 2.0)
         ▼
┌─────────────────────────┐
│   index.mjs             │  Node.js stdio → HTTP proxy
│   (MCP Transport)       │
└────────┬────────────────┘
         │ HTTP POST (Basic Auth)
         ▼
┌─────────────────────────┐
│   HTTP-сервис /hs/mcp/  │  Расширение INFATON_MCP.cfe
│   Module.bsl            │  93 инструмента (7 350 строк)
│   (MCP Server)          │
└────────┬────────────────┘
         │ Встроенный язык 1С
         ▼
┌─────────────────────────┐
│   База 1С:Предприятие   │  ERP / УПП / Бухгалтерия / УТ / КА
│   Данные, метаданные    │
└─────────────────────────┘

---

📝 Compatibilidade

Parâmetro	Valor
Plataforma 1C	8.3.20+ (testado em 8.3.27.1989)
Configurações	ERP 2.5, UPP 1.3, Contabilidade 3.0, UT 11, KA 2
Protocolo MCP	2024-11-05
Transporte	HTTP (Basic Auth), stdio (via index.mjs)
Node.js	18+ (para wrapper stdio)

---

📊 Histórico de versões

Versão	Data	Ferramentas	Alterações
v2.1.0	2026-05-14	51	+10 ferramentas (contabilidade, auditoria, formulários), 9 correções de bugs
v2.0.0	2026-05-08	41	+6 ferramentas (batch, CDC, fill_on_basis e outras)
v1.0.0	2026-04-28	35	Primeiro lançamento público

---

🔒 Segurança

Obrigatório para produção

Requisito	Por que é importante
HTTPS	Basic Auth envia login/senha em base64. Via HTTP, ficam visíveis para qualquer pessoa na rede
Usuário 1C separado	Crie um usuário mcp_agent com direitos mínimos — apenas os objetos necessários
ONEC_ALLOWED_TOOLS	Limite a lista de ferramentas para o cenário específico

Ferramentas perigosas

As seguintes ferramentas exigem permissão explícita e devem ser usadas com consciência:

Ferramenta	Risco	Recomendação
execute_code	Executa código BSL arbitrário em modo privilegiado	Proibir via ONEC_ALLOWED_TOOLS se não for necessário
delete_object	Marca objetos para exclusão	Proibir em cenários analíticos
run_scheduled_job	Executa tarefas agendadas	Proibir se não for necessário
import_data	Criação/alteração em massa de objetos	Proibir em cenários somente leitura
post_document / unpost_document	Altera lançamento de documentos e movimentações em registros	Apenas para cenários operacionais

Configuração somente leitura

ONEC_ALLOWED_TOOLS="get_metadata_tree,execute_query,get_object_by_ref,get_list,find_by_code,find_by_name,get_register_records,get_document_list,get_server_info,get_event_log,get_balance,get_register_totals,get_accounting_entries,get_related_documents,get_form_structure,get_rights,find_duplicates"

Mais detalhes — veja EXAMPLES.md.

---

📄 Licença

MIT © 2024-2026 INFATON — Privalov S.Yu.

Plataforma: infaton.ru · Produto: chatmcp.ru (ChatMCP).

---

Instruções detalhadas de build .cfe — veja HOW_TO_BUILD_CFE.md

Exemplos de cenários de agentes — veja EXAMPLES.md

Histórico de alterações — veja CHANGELOG.md

---

📰 Publicação no Infostart

Статья на портале Инфостарт: INFATON MCP Server v2.1 — 51 инструмент для AI-интеграции с 1С:Предприятие