Что такое 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С: меньше ручного копирования контекста, меньше выдуманных имён в сгенерированном коде.
Как подключить
Принцип одинаковый для всех клиентов: в конфиге описывается команда запуска бинарника и аргументы. Различается только имя верхнего ключа и путь к файлу конфигурации.
- Скачайте бинарник нужной редакции и положите его в постоянное место (например,
/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-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.
Открытая редакция бесплатна, ставится одним файлом и сразу даёт модели доступ к метаданным и коду, поэтому с неё удобно начинать знакомство. Скачать и почитать о возможностях можно на главной.