MCP сервер для 1С: метаданные конфигурации для агента

Если попросить нейросеть написать код на BSL для вашей конфигурации, она не знает, какие у вас справочники, документы и реквизиты, и сочиняет несуществующие. MCP сервер для 1С решает именно это: агент сам запрашивает структуру конфигурации, справку по синтаксису и поиск по коду, а не угадывает. Ниже разбираем, что умеет такой сервер, как установить один из них (mcp-1c), подключить его к Claude Code и Cursor, на какой модели запускать и о чём помнить из соображений безопасности.

MCP сервер для 1С: что он даёт агенту

MCP (Model Context Protocol) — открытый протокол, по которому агент получает описания внешних инструментов и вызывает их. Для 1С полезны три группы возможностей:

• Метаданные конфигурации. Дерево объектов, реквизиты, табличные части, измерения и ресурсы, структура форм. Агент пишет запросы и обработчики по реальным именам.
• Справка. Синтаксис встроенных функций и методов платформы, чтобы не путать русские и английские имена и параметры.
• Поиск по коду. Просмотр модулей конфигурации по тексту, чтобы найти, где уже реализована нужная логика.

Серверов для 1С несколько. По описаниям репозиториев на GitHub на 18 октября 2026, есть, например, mcp-1c (метаданные и генерация BSL), 1c-mcp-toolkit (метаданные и данные, плюс REST API), mcp-bsl-platform-context (справка по синтаксису и объектной модели платформы), EDT-MCP (для 1C:EDT), а также каталог «1c-mcp» со ссылками на многие из них. Мы подробно разбираем mcp-1c, потому что у него понятная документация; остальные не тестировали. Перед выбором прочитайте README конкретного проекта: возможности и условия (часть проектов имеет платные редакции) у них разные.

Что умеет mcp-1c

По README проекта, открытая версия содержит 11 инструментов:

Программа написана на Go и поставляется одним исполняемым файлом. Она общается с агентом по stdio, а с базой через HTTP-сервис, который ставится расширением конфигурации и не меняет саму конфигурацию. Минимальная поддерживаемая версия платформы 8.3.10.

Установка

По документации проекта порядок такой.

1. Скачайте mcp-1c для вашей ОС со страницы Releases репозитория feenlace/mcp-1c. На macOS и Linux дайте файлу права на запуск (chmod +x).
2. Закройте все сеансы базы и поставьте расширение: mcp-1c --install "C:\путь\к\базе". Для клиент-серверной базы добавьте --server и строку подключения вида сервер\база. Утилита найдёт платформу, загрузит расширение и обновит конфигурацию базы.
3. Опубликуйте HTTP-сервис: в Конфигураторе от администратора откройте Администрирование, Публикация на веб-сервере, на вкладке HTTP-сервисы включите публикацию HTTP-сервисов расширений по умолчанию и нажмите Опубликовать. Проверка: curl http://localhost/base/hs/mcp-1c/version должен вернуть номер версии расширения.
4. Выдайте доступ: расширение ставит роль MCP_ОсновнаяРоль, и пользователю без ролей конфигурации сервис ответит отказом. Как выдать её правильно, зависит от того, есть ли подсистема «Управление доступом»; этот случай подробно разобран в документации проекта.
5. Для поиска по коду выгрузите конфигурацию в файлы и запускайте сервер с параметром --dump путь_к_выгрузке.

Ограничение платформы: по документации проекта, HTTP-сервисы 1С не поддерживаются на macOS, поэтому базу публикуют на Windows или Linux.

Подключение к Claude Code

Сначала подключите сам Claude Code к шлюзу. Ключ fetch_... создаётся в кабинете↗; подробнее в документации по Claude Code↗.

export ANTHROPIC_BASE_URL=https://api.zukko.pro
export ANTHROPIC_AUTH_TOKEN=fetch_ваш_ключ
export ANTHROPIC_MODEL=claude-sonnet-5-5

Адрес без /v1: Claude Code добавит путь сам. Затем добавьте MCP-сервер командой из документации проекта:

claude mcp add 1c --transport stdio -- /путь/к/mcp-1c --base http://localhost:8080/hs/mcp-1c --dump /путь/к/выгрузке

Для Windows в документации проекта используется обёртка cmd /c. Флаг --scope user делает сервер доступным во всех проектах. Проверка: claude mcp list. Запустите claude и спросите: «Покажи структуру конфигурации моей базы 1С». Если инструменты не видны, смотрите claude mcp get 1c и запустите mcp-1c с флагом --verbose для вывода диагностики. Общий порядок работы с MCP в Claude Code описан в статье MCP-серверы в Claude Code↗.

Подключение к Cursor

Создайте файл .cursor/mcp.json в проекте (или ~/.cursor/mcp.json для всех проектов):

{
  "mcpServers": {
    "1c": {
      "command": "/путь/к/mcp-1c",
      "args": ["--base", "http://localhost:8080/hs/mcp-1c", "--dump", "/путь/к/выгрузке"]
    }
  }
}

На Windows в пути к mcp-1c.exe обратные слеши удваиваются. Сам Cursor подключается к шлюзу по инструкции для Cursor↗ с адресом https://api.zukko.pro/v1. По документации mcp-1c, Cursor лучше всего работает, когда суммарно по всем серверам подключено не больше примерно 40 MCP-инструментов. У mcp-1c их 11, но если у вас много других серверов, отключите лишние.

На какой модели это работает

MCP требует вызова инструментов, поэтому модель должна их поддерживать; проверьте на своей конфигурации одним сложным вопросом. По умолчанию подойдёт claude-sonnet-5-5, для объёмных рефакторингов можно взять claude-opus-5-5, для недорогих проверок gpt-6.1-sol. Силу моделей сравнивайте по индексу из таблицы и по своим задачам: мы не утверждаем, что какая-то модель лучше знает BSL.

Контекст имеет значение: дерево метаданных крупной конфигурации большое. У Claude и GPT из таблицы моделей контекст 1M токенов, у GLM 128K.

Расчёт на 18 октября 2026, claude-sonnet-5-5 (вход 0.4, выход 2, чтение кэша 0.05, запись кэша 0.5 за 1M) в Claude Code, то есть в Anthropic-формате. Сессия из 25 запросов, в каждом 44 000 токенов из кэша, 5 000 записываются в кэш, 1 000 свежих и 1 000 токенов ответа:

• 1 000 × 0.4 + 44 000 × 0.05 + 5 000 × 0.5 + 1 000 × 2 = 400 + 2 200 + 2 500 + 2 000 = 7 100 микродолларов на запрос;
• 7 100 × 25 = 177 500 микродолларов, около $0.18 за сессию.

Через Cursor (OpenAI-формат) тот же объём входа 50 000 токенов считался бы по цене входа без скидки за кэш: 50 000 × 0.4 + 1 000 × 2 = 22 000, 22 000 × 25 = 550 000, то есть $0.55. Реальные цифры смотрите в «Использовании» кабинета. Пополнение: СБП (комиссия платёжной страницы 8,5% сверху), криптовалюта или карты MasterCard.

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

• Данные уходят в запрос к модели. Всё, что вернул инструмент (структура, строки результата запроса, журнал регистрации), становится частью запроса к модели. Не давайте агенту доступ к персональным и коммерческим данным без необходимости.
• Работайте на копии базы. Для первых экспериментов поднимите тестовую копию.
• Ограничьте права пользователя HTTP-сервиса минимально нужными. execute_query по описанию выполняет только выборку, но видимость данных определяется правами.
• Не передавайте пароль в адресе. Проект советует флаги --user и --password или переменные окружения MCP_1C_USER и MCP_1C_PASSWORD.
• Ограничьте ключ в Zukko: задайте дневной и месячный лимит в долларах и список разрешённых моделей.

Общая тема интеграции 1С с нейросетью разобрана в статье Интеграция нейросети в 1С:Предприятие↗.

Частые вопросы

Работает ли mcp-1c с локальными моделями?

По README проекта да: он не привязан к модели и работает с любым MCP-клиентом, включая клиенты для локальных моделей. Для сложных запросов агенту нужен вызов инструментов.

Он бесплатный?

У проекта есть бесплатная открытая версия с лицензией MIT и платные редакции с расширенными возможностями. Актуальные условия смотрите в README проекта.

Почему агент не видит инструменты?

Проверьте, что HTTP-сервис опубликован (запрос /version отвечает), путь в --base совпадает с публикацией, у пользователя есть роль, а клиент перезапущен. В Claude Desktop проект советует режим Always available.

Нужен ли шлюз для самого MCP-сервера?

Нет. MCP-сервер работает локально и общается с вашей базой. Шлюз нужен только модели, которую использует агент.