AI Коннектор для 1С:Предприятие (MCP Server)

Расширение конфигурации "AI Коннектор" реализует протокол MCP (Model Context Protocol) для платформы 1С:Предприятие. Это позволяет интегрировать 1С с современными AI-ассистентами (Claude Desktop, Cursor, и другими поддерживающими MCP), предоставляя им доступ к данным информационной базы через инструменты (Tools).

Возможности

• Сервер MCP (Model Context Protocol): Реализация JSON-RPC 2.0 сервера, работающего через HTTP-сервисы 1С.
• Публикация инструментов: Возможность гибкой настройки доступных для AI инструментов через справочник "Инструмент AI".
• Варианты отчетов как функции: Использование существующих вариантов отчетов конфигурации (на базе СКД) в качестве источников данных.
• Передача параметров: Поддержка передачи параметров (например, период startDate, endDate) из AI в отчет.
• Безопасность: Работает через стандартные механизмы публикации HTTP-сервисов 1С.

Требования

• Платформа 1С:Предприятие 8.3.24+ (режим совместимости 8.3.24).
• Конфигурация с внедренной БСП (Библиотека Стандартных Подсистем), так как используются:
  • Справочник ВариантыОтчетов
  • Общий модуль ОбщегоНазначения
  • Общий модуль ВариантыОтчетов
  • Общий модуль ОбщегоНазначенияБТС (для обработки дат)

Настройка

В 1С:Предприятие

1. Перейдите в справочник Инструмент AI (гстAI_Инструмент).
2. Создайте новый элемент:
   • Наименование: Уникальный идентификатор латиницей (например, get_sales_report).
   • Вариант отчета: Выберите вариант отчета, который будет формироваться.
   • Описание: Подробное описание того, что делает инструмент (важно для AI, чтобы понять, когда его вызывать).
   • Схема параметров: JSON Schema описание параметров. 

Настройка MCP Клиента (например, Claude Desktop)

Добавьте конфигурацию сервера в настройки вашего MCP клиента.

URL сервиса: https://<ваш-сервер>/<база>/hs/gstai_mcp

Пример конфигурации для claude_desktop_config.json:

{
  "mcpServers": {
    "1c-server": {
      "command": "node",
      "args": [
        "path/to/mcp-proxy.js", 
        "https://<ваш-сервер>/<база>/hs/gstai_mcp", 
        "user", 
        "password"
      ]
    }
  }
}

Примечание: Поскольку 1С работает по HTTP, для подключения локальных клиентов (типа Claude Desktop), которые ожидают stdio, может потребоваться простой прокси-скрипт или использование SSE (в текущей версии реализован JSON-RPC over HTTP). Если ваш клиент поддерживает HTTP MCP транспорт (SSE), укажите URL напрямую (потребуется доработка транспорта в расширении для полной поддержки SSE, сейчас реализован Request-Response JSON-RPC).

Для прямых HTTP вызовов (например, из Cursor в режиме "Codebase" или через кастомные скрипты): * Endpoint: POST http://localhost/base/hs/gstai_mcp * Headers: Content-Type: application/json

API

Сервис реализует следующие методы JSON-RPC:

• initialize: Инициализация сессии, обмен возможностями.
• tools/list: Получение списка доступных инструментов.
• tools/call: Вызов инструмента.

Пример тела запроса tools/call:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_sales_report",
    "arguments": {
      "startDate": "2024-01-01",
      "endDate": "2024-01-31"
    }
  }
}