Что такое MCP-сервер для 1С и зачем он разработчику
Как MCP-сервер связывает ИИ-ассистента с кодом, метаданными и данными 1С. Устройство протокола, задачи редакций, подключение клиента и границы доступа.
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 от Feenlace — MCP-сервер для платформы 1С:Предприятие. Он даёт AI-ассистентам доступ к метаданным базы 1С, коду BSL, запросам и документации по протоколу MCP. Написан на Go и поставляется одним бинарником. Для работы нужны совместимый MCP-клиент, подготовленные источники и права доступа.
Связь с 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С: меньше ручного копирования контекста, меньше выдуманных имён в сгенерированном коде.
Как подключить
Для клиентов с поддержкой stdio в конфиге описывается команда запуска бинарника и аргументы. Подготовка подключения к 1С описана в быстром старте: настройка AI-клиента не заменяет настройку базы и прав.
- Скачайте бинарник нужной редакции и положите его в постоянное место (например,
/usr/local/bin/). - Откройте файл конфигурации MCP вашего клиента.
- Добавьте описание сервера с путём к бинарнику и параметром
--baseдля подключения к базе. - Перезапустите клиента и убедитесь, что инструменты появились.
// Пример для 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-сервер, для управления командным доступом — корпоративный шлюз. Редакции различаются задачами и условиями выполнения операций, а не только количеством инструментов.
| Редакция | Что входит |
|---|---|
| Открытая | Бесплатная, Open Source под лицензией MIT. Чтение метаданных, параметризованные запросы SELECT/ВЫБРАТЬ к подключённой базе, поиск по BSL и справка. Поиск по BSL и перечитывание выгрузки доступны при запуске с --dump; выгрузка не заменяет живые данные базы. Контракт инструментов. |
| Расширенная | Проверка BSL и запросов, генерация кода и ограниченные правки форм и метаданных; работа с несколькими базами, long polling и песочница кода. Доступные действия зависят от подписки, входных данных и прав. Контракт инструментов. |
| Профессиональная | Возможности Расширенной плюс массовый анализ предоставленной выгрузки в пределах поддерживаемого покрытия, семантический поиск и зависимости; поддерживаемые сверки, отчёты и печатные формы. Для операций с данными нужны настроенное подключение и права; поддержка проверяется по контракту конкретного инструмента. Контракт инструментов. |
| Корпоративная | Шлюз для командного доступа к 1С: подключения, роли, настраиваемое маскирование и аудит. Универсальные уникальные места; роли определяют права, бюджет баз не применяется. Возможности и настройка. |
Полное сравнение и цены собраны на странице тарифов, список инструментов с примерами в документации.
Границы и безопасность
Локальный запуск MCP-сервера не означает автономность всей цепочки. Сервер читает файлы выгрузки локально, а доступ к живым данным требует подключения к 1С. Сетевые обращения зависят от выбранного AI-клиента, модели и включённых функций. Границы внешних обращений и лицензирования описаны отдельно в материале об on-premise.
Сам протокол закладывает контроль на стороне пользователя. По спецификации MCP хост обязан получить явное согласие пользователя перед вызовом любого инструмента, а описания поведения инструментов следует считать недоверенными, если они получены не от доверенного сервера. На практике это значит, что модель не выполнит запрос к базе молча: вызов инструмента виден и подтверждается вами.
У возможностей есть честные границы. Полнотекстовый поиск по коду в Открытой редакции находит вхождения, но не строит граф вызовов. Выполнение запросов в ней ограничено выборкой данных. А встроенный HTTP-приёмник, который сервер поднимает по флагу --listen, это транспорт long polling для связи с 1С, а не многопользовательский MCP-сервер: для AI-клиента канал остаётся stdio.
Открытая редакция бесплатна; для доступа к метаданным и коду подготовьте подключение или выгрузку для выбранной задачи. С неё можно начать знакомство с MCP-1C. Скачать и почитать о возможностях можно на главной.