Что такое MCP-сервер для 1С и зачем он разработчику

·
  • mcp
  • 1c
  • ai
  • bsl

MCP-сервер для 1С даёт AI-ассистенту доступ к метаданным и коду BSL по открытому протоколу. Что это такое, какие редакции есть и как подключить к Claude, Cursor и VS Code.

MCP-сервер для 1С нужен затем, чтобы AI-ассистент перестал угадывать имена реквизитов и сочинять несуществующие методы. Вместо того чтобы вставлять кусок кода в окно чата и объяснять словами, какие в базе есть документы и регистры, вы даёте модели прямой канал к самой конфигурации: она видит метаданные, читает BSL, прогоняет запросы.

Что такое MCP

MCP (Model Context Protocol) это открытый стандарт для подключения AI-приложений к внешним системам: источникам данных, инструментам и рабочим процессам. Стандарт представлен компанией Anthropic. В спецификации его сравнивают с портом USB-C: как USB-C задаёт единый способ соединять устройства, так MCP задаёт единый способ соединять AI-приложения с внешними системами. Один протокол вместо отдельного коннектора под каждую интеграцию.

Архитектура MCP это три роли:

Роль Что делает
Hosts LLM-приложения, которые инициируют соединения (например, чат с моделью)
Clients Коннекторы внутри хоста, по одному на соединение с сервером
Servers Сервисы, которые предоставляют контекст и возможности

Протокол использует сообщения JSON-RPC 2.0, соединения с сохранением состояния и согласование возможностей между клиентом и сервером. Сервер может предоставлять клиенту три типа возможностей:

  • Resources: контекст и данные;
  • Prompts: шаблонные сообщения и сценарии;
  • Tools: функции, которые выполняет AI-модель.

Текущая версия спецификации это ревизия 2025-11-25. Протокол поддерживает широкий круг клиентов: AI-ассистенты Claude и ChatGPT, инструменты разработки Visual Studio Code, Cursor, MCPJam и другие. Один сервер работает с любым из них без переделки.

Что такое MCP-сервер для 1С

MCP-1C это MCP-сервер для платформы 1С:Предприятие. Он даёт AI-ассистентам доступ к метаданным базы 1С, коду BSL, запросам и документации по протоколу MCP. Написан на Go, поставляется одним бинарником без внешних зависимостей: положили файл, прописали в конфиг клиента, работает.

Связь с AI-клиентом идёт по транспорту stdio: клиент запускает бинарник и общается с ним через stdin и stdout. Отдельные порты или HTTP-серверы для подключения к клиенту настраивать не нужно. AI видит метаданные вашей конфигурации и отвечает на её основе, а не на основе абстрактного знания о 1С.

Совместимость: платформа 1С 8.3.x и 8.5.x, коммерческая и учебная. Сборки есть под Windows, macOS и Linux, архитектуры amd64 и arm64.

Зачем это разработчику

Обычный сценарий без MCP такой: вы открываете конфигуратор, ищете объект, копируете структуру реквизитов в чат, формулируете задачу, получаете код, правите имена, которые модель не угадала. С MCP-сервером модель сама запрашивает то, что ей нужно:

  • посмотреть дерево метаданных и структуру конкретного объекта;
  • найти по полнотекстовому поиску, где в коде используется метод или процедура;
  • проверить и выполнить запрос на языке запросов 1С (в Открытой редакции только SELECT);
  • получить структуру формы и записи журнала регистрации;
  • свериться со справочником по встроенным функциям BSL.

То есть ответ строится на фактической конфигурации, а не на догадках. Это и есть основная причина ставить MCP для 1С: меньше ручного копирования контекста, меньше выдуманных имён в сгенерированном коде.

Как подключить

Принцип одинаковый для всех клиентов: в конфиге описывается команда запуска бинарника и аргументы. Различается только имя верхнего ключа и путь к файлу конфигурации.

  1. Скачайте бинарник нужной редакции и положите его в постоянное место (например, /usr/local/bin/).
  2. Откройте файл конфигурации MCP вашего клиента.
  3. Добавьте описание сервера с путём к бинарнику и параметром --base для подключения к базе.
  4. Перезапустите клиента и убедитесь, что инструменты появились.
// Пример для Claude Desktop (claude_desktop_config.json).
// Запуск бинарника mcp-1c-advanced по stdio, подключение к базе 1С
// через HTTP-сервис публикации (--base). Перезапустить клиент после правки.
{
  "mcpServers": {
    "1c": {
      "command": "/usr/local/bin/mcp-1c-advanced",
      "args": ["--base", "http://localhost:8080/hs/mcp-1c"]
    }
  }
}

// Тот же сервер для Cursor (~/.cursor/mcp.json или .cursor/mcp.json):
// верхний ключ тоже "mcpServers".
// Для VS Code (.vscode/mcp.json) верхний ключ ДРУГОЙ: "servers"
// (а не "mcpServers"), поля command/args те же.

Файл конфигурации Claude Desktop лежит по пути ~/Library/Application Support/Claude/ на macOS, %APPDATA%\Claude\ на Windows и ~/.config/Claude/ на Linux. Claude Desktop поддерживает протокол MCP из коробки: достаточно прописать мост в конфиге, и инструменты появятся в чате. Подробный разбор настройки Cursor вынесен в отдельную статью: подключение к Cursor.

Редакции

MCP-1C поставляется в нескольких редакциях.

Редакция Что входит
Открытая Бесплатная, Open Source под лицензией MIT. 9 инструментов: дерево метаданных, структура объекта, выполнение запроса (только SELECT), валидация запроса, полнотекстовый поиск по BSL с BM25, структура формы, журнал регистрации, сведения о конфигурации, справочник по 180 встроенным функциям BSL.
Расширенная Платная подписка. 8 консолидированных инструментов, вся функциональность Открытой плюс оптимизатор запросов (15 анти-паттернов), линтер BSL (30 диагностик), полный справочник синтаксиса платформы, поддержка расширений .cfe, мультибазовость, long polling, песочница кода.
Профессиональная Надмножество Расширенной: массовый анализ всей кодовой базы с аудитом безопасности и CVSS-оценками, семантический поиск по коду, сравнение и ревью расширений .cfe, архитектурные диаграммы Mermaid, автогенерация документации, генерация тестов YAxUnit и Vanessa, генерация .epf, навигация по типовым конфигурациям.
Корпоративная В разработке.

Полное сравнение и цены собраны на странице тарифов, список инструментов с примерами в документации.

Границы и безопасность

Открытая редакция работает полностью офлайн: MCP-сервер запускается локально и читает файлы конфигурации напрямую. Интернет нужен только самому AI-клиенту, чтобы связаться со своим облачным AI. Расширенная и Профессиональная редакции дополнительно периодически проверяют лицензию через интернет.

Сам протокол закладывает контроль на стороне пользователя. По спецификации MCP хост обязан получить явное согласие пользователя перед вызовом любого инструмента, а описания поведения инструментов следует считать недоверенными, если они получены не от доверенного сервера. На практике это значит, что модель не выполнит запрос к базе молча: вызов инструмента виден и подтверждается вами.

У возможностей есть честные границы. Полнотекстовый поиск по коду в Открытой редакции находит вхождения, но не строит граф вызовов. Выполнение запросов в ней ограничено выборкой данных. А встроенный HTTP-приёмник, который сервер поднимает по флагу --listen, это транспорт long polling для связи с 1С, а не многопользовательский MCP-сервер: для AI-клиента канал остаётся stdio.

Открытая редакция бесплатна, ставится одним файлом и сразу даёт модели доступ к метаданным и коду, поэтому с неё удобно начинать знакомство. Скачать и почитать о возможностях можно на главной.