INFATON MCP Server для 1С:Предприятие

Model Context Protocol (MCP) — сервер на стороне 1С:Предприятие, предоставляющий 91 инструмент для взаимодействия AI-ассистентов с базой данных 1С.

Протокол: JSON-RPC 2.0 (спецификация MCP)

> Часть платформы INFATON — цифровые двойники и AI-агенты над 1С:ERP.

> Компания: **infaton.ru · Продукт: chatmcp.ru** (ChatMCP — чат-двойник над вашей 1С:ERP).

🏗 Кто использует

INFATON MCP Server — движок доступа AI к 1С в продуктах платформы INFATON:

• **eventcode.ru** — платформа заказной разработки: AI-агенты ведут проекты и работают с 1С:ERP заказчика через этот MCP-сервер.
• **chatmcp.ru** — ChatMCP, цифровой двойник над 1С:ERP: чат-интерфейс и рабочие места (АРМ) поверх этого MCP-сервера.

Сервер открыт (MIT) — используйте в своём продукте, см. Быстрый старт.

📋 Состав репозитория

🆕 Что нового в v6.0.2

59 → 91 инструмент (+32): отчёты СКД под типовые конфигурации 1С:ERP (`run_report`, `get_report_options`…), аудит прав (`get_rights_for_user`, `export_role_matrix`), пользовательские настройки (`set_constant`, `set_functional_option`, `set_user_setting`…), снимки и сравнение (`snapshot_document_state`, `compare_snapshots`, `document_chain`), бизнес-данные ЕРП (`get_stock_by_warehouse`, `get_unfulfilled_order_lines`, `get_reservation_status`). Плюс запись ссылочных полей и перечислений (резолв `_guid` для шапки И строк табличных частей). Полный перечень — в CHANGELOG.md.

🆕 Что нового в v2.1.0

Исправления (9 патчей)

Новые инструменты (10 штук, группа З)

🛠 Каталог инструментов

> Ниже — базовый каталог (51 инструмент, группы А–З). В v6.0.2 добавлены ещё 32 (отчёты/СКД, права, пользовательские настройки, снимки, бизнес-данные 1С:ERP) — полный список из 91 в `Module.bsl` и CHANGELOG.md.

Группа А — Метаданные (8)

Группа Б — Чтение данных (7)

Группа В — CRUD (7)

Группа Г — Код и отчёты (4)

Группа Д — Администрирование (6)

Группа Е — Интеграция (3)

Группа Ж — Расширенные операции v2.0 (6)

Группа З — Бухгалтерия, аудит, формы v2.1 (10) 🆕

🚀 Быстрый старт

Вариант 1: Через Claude Desktop / Cursor (stdio)

Способ А — через npx (без клонирования)

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

Способ Б — из клонированного репозитория

{
  "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"
      }
    }
  }
}

Вариант 2: Прямой HTTP-вызов

1. Установите расширение

1. Откройте Конфигуратор базы 1С

2. Конфигурация → Расширения конфигурации → Добавить

3. Выберите файл `INFATON_MCP.cfe` (или соберите по инструкции из `Module.bsl`)

4. Обновите конфигурацию БД (F7)

2. Проверьте подключение

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

Ожидаемый ответ:

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

3. Вызовите инструмент

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/

📐 Архитектура

┌─────────────────────────┐
│   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            │  51 инструмент (4 263 строки)
│   (MCP Server)          │
└────────┬────────────────┘
         │ Встроенный язык 1С
         ▼
┌─────────────────────────┐
│   База 1С:Предприятие   │  ERP / УПП / Бухгалтерия / УТ / КА
│   Данные, метаданные    │
└─────────────────────────┘

📝 Совместимость

📊 История версий

🔒 Безопасность

Обязательно для продакшена

Опасные инструменты

Следующие инструменты требуют явного разрешения и должны использоваться осознанно:

Конфигурация только для чтения

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"

Подробнее — см. EXAMPLES.md.

📄 Лицензия

MIT © 2024-2026 INFATON — Привалов С.Ю.

Платформа: **infaton.ru · Продукт: chatmcp.ru** (ChatMCP).

*Подробная инструкция по сборке `.cfe` — см. HOW_TO_BUILD_CFE.md*

*Примеры агентских сценариев — см. EXAMPLES.md*

*История изменений — см. CHANGELOG.md*

📰 Публикация на Инфостарт

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