Инструменты для 1С:Предприятие в Claude Code и OpenAI Codex

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

MCP-сервер для 1С — это адаптер между AI-агентом и вашей информационной базой. Он отдаёт агенту метаданные конфигурации, исходники модулей, справку платформы и результаты запросов через Model Context Protocol — открытый протокол, которым Claude Code и OpenAI Codex подключают внешние инструменты и источники данных.

Проблема, которую он решает, простая. Языковая модель обучена преимущественно на англоязычном коде: BSL в её выборке занимает доли процента, а вашей конфигурации в ней нет вообще. Без внешнего контекста агент выдаёт код, который выглядит как 1С, но не работает: выдуманные методы, несуществующие реквизиты, синтаксис на стыке 1С и Python. Русскоязычное сообщество формулирует это одинаково: без MCP модель пишет уверенно и неправильно.

MCP-сервер закрывает четыре типа контекста:

• Метаданные конфигурации — какие справочники, документы, регистры и реквизиты есть именно у вас, а не «вообще в 1С».
• Исходный код — поиск по модулям BSL: точный, по регулярному выражению или семантический.
• Справка платформы — синтакс-помощник и документация, чтобы агент не выдумывал сигнатуры методов.
• Обратная связь — выполнение запросов, чтение журнала регистрации, проверка синтаксиса. Агент видит результат, а не гадает.

02Быстрый старт: минимальная связка за один день

Рабочий минимум — два инструмента, и оба ставятся за час. Всё остальное из этого обзора — расширение, а не замена: если эти два не стоят, добавлять поверх нечего.

Шаг 1. BSL Language Server — статический анализ и навигация

BSL Language Server — эталонная LSP-реализация для BSL и OneScript: автодополнение, go to definition, find references, hover, 186 диагностик, форматирование. Агент получает те же подсказки, что и человек в IDE, и видит свои ошибки сразу — а не после выгрузки в конфигуратор.

В Claude Code ставится официальным плагином от команды 1c-syntax — claude-code-bsl-lsp:

/plugin marketplace add 1c-syntax/claude-code-bsl-lsp
/plugin install bsl-language-server@bsl-language-server

Плагин сам скачивает BSL LS при первом запуске и включает диагностику для файлов .bsl и .os. Нужна версия Claude Code с поддержкой LSP: сам инструмент появился в 2.0.74, на более ранних сборках плагину не за что зацепиться. В Codex и VS Code ту же роль играет расширение Language 1C (BSL) или MCP-обёртка bsl-mcp.

Шаг 2. mcp-1c — доступ к живой базе

feenlace/mcp-1c — самый простой вход в тему: один Go-бинарник без зависимостей, лицензия MIT. Open-версия даёт десять инструментов для работы с живой базой: метаданные, поиск по BSL-коду (смысловой, по регулярке и точный), выполнение запросов, журнал регистрации и встроенную справку BSL. Расширение в базу ставится одной командой:

mcp-1c --install "C:\путь\к\базе"

Дальше сервер подключается к любому агенту — Claude Code, Codex, Cursor, Windsurf. Минимальная версия платформы — 8.3.10. Open-версия бесплатна и покрывает базовые сценарии; платные тарифы — 1 990 ₽ и 4 990 ₽ в месяц — снимают ограничения. Проект релизится по несколько раз в неделю, так что за номером версии гнаться бессмысленно: ставьте последний.

03Claude Code: скиллы и плагины для 1С

В Claude Code для 1С есть два типа расширений — скиллы и плагины. Скилл (Agent Skill) — это папка с markdown-инструкцией, которую агент подгружает, когда задача ей соответствует. Плагин упаковывает LSP-серверы, MCP-подключения и команды, устанавливается через /plugin.

Наборы скиллов

Скилл для 1С — это, по сути, записанная процедура: как собрать обработку, как описать форму через JSON DSL, как опубликовать базу. Готовых наборов несколько, и они заметно пересекаются — брать имеет смысл один.

cp -r skills/* ~/.claude/skills/

codex plugin marketplace add Nikolay-Shirokov/cc-1c-skills

Зависимости у наборов разные, но сходятся на одном: на Windows обязателен PowerShell 5.1+, опционально нужны Python 3.8+, v8unpack и, разумеется, сама платформа 1С:Предприятие 8.3.

Плагины

• [1c-syntax/claude-code-bsl-lsp](https://github.com/1c-syntax/claude-code-bsl-lsp) — официальный плагин от команды 1c-syntax: подключает BSL Language Server как LSP для .bsl и .os. Диагностика, go to definition, find references, hover, форматирование, code actions. Требует свежую версию Claude Code с поддержкой LSP.
• [Piebald-AI/claude-code-lsps](https://github.com/Piebald-AI/claude-code-lsps) — community-маркетплейс LSP-плагинов, где BSL идёт наряду с двумя десятками других языков. Вариант, если LSP нужен не только для 1С.
• Официальные плагины Anthropic (/plugin marketplace add anthropics/claude-plugins-official) — mcp-server-dev, code-review, pr-review-toolkit, security-guidance. К 1С отношения не имеют, но полезны как обвязка вокруг проекта.

04OpenAI Codex: плагин Unica и подключение MCP

Специализированных инструментов под Codex меньше — но это не изоляция. MCP-серверы работают в нём ровно так же, как в Claude Code, а SKILL.md кроссплатформенный. Codex-специфичного здесь по сути два пункта: плагин Unica и способ подключения MCP.

Плагин Unica

IngvarConsulting/unica — специализированный плагин Codex под 1С. Внутри: прикладные навыки (формы, метаданные, EPF/ERF, базы, роли, СКД, веб-публикация), файл .mcp.json с MCP-подключениями и безопасные запускатели инструментов. Ставится одной командой:

curl -fsSL https://github.com/IngvarConsulting/unica/releases/latest/download/install-unica.sh | sh

Инсталлятор сам выбирает архив под платформу (darwin-arm64, linux-x64, win-x64), регистрирует marketplace unica-local и включает unica@unica-local. Проверить установку: codex debug prompt-input 'test' — в выводе должны появиться плагин Unica и навыки вида unica:meta-compile, unica:v8-runner, unica:epf-bsp-init. Для реальных операций, само собой, нужна платформа 1С.

Как подключить MCP-сервер 1С к Codex

Codex CLI хранит конфигурацию MCP в TOML — файл ~/.codex/config.toml, блок [mcp_servers]. Обратите внимание на подчёркивание: `mcp_servers`, а не `mcp-servers`. При дефисе Codex молча игнорирует запись — без ошибки и без предупреждения.

[mcp_servers.1c]
command = "/path/to/mcp-1c"
args = ["--base", "http://localhost:8080/hs/mcp-1c"]

Правила и субагенты

comol/ai_rules_1c — переносимый набор правил, субагентов и on-demand инструкций для BSL. Есть адаптеры под разные инструменты, включая Codex (.codex/rules/, .codex/agents/, .codex/skills/, .codex/config.toml; slash-команды в ~/.codex/prompts/), а также под Cursor, Claude Code, OpenCode и KiloCode. Использует AGENTS.md как always-on контекст и включает SKILL-пакеты, каталог MCP-серверов и OpenSpec-воркспейс.

05Каталог MCP-серверов для 1С

Единая точка входа — репозиторий [Untru/1c-mcp](https://github.com/Untru/1c-mcp) («Awesome 1C MCP Servers», в README заявлена лицензия CC0). На момент публикации он каталогизирует 33 проекта — 28 open source и 5 коммерческих — по категориям: IDE-интеграции, фреймворки, метаданные и анализ кода, справка платформы, тестирование, интеграция с 1С:Напарник, учётные системы, графовый анализ, DevOps, наборы скиллов и коммерческие продукты. Ниже — выжимка по тому, что берут чаще всего. Все эти серверы работают и в Claude Code, и в Codex.

Живая база и метаданные

Интеграции с IDE

Справка платформы и синтаксис BSL

Эта категория напрямую бьёт по галлюцинациям: агент перестаёт выдумывать сигнатуры методов, потому что может их посмотреть.

Тестирование и проверка кода

Учётные системы, 1С-Битрикс и DevOps

06Фундамент: BSL Language Server и OneScript

Два инструмента здесь старше всей AI-темы и к ней прямого отношения не имеют — но на них стоит половина остального. Стоит понимать, что вы ставите, когда ставите плагин или обёртку.

BSL Language Server

1c-syntax/bsl-language-server — эталонная LSP-реализация для BSL и OneScript (Java, лицензия LGPL 3). Автодополнение, go to definition, find references, hover, 186 диагностик, форматирование, расчёт когнитивной и цикломатической сложности. Запускается как java -jar bsl-language-server.jar, умеет режимы LSP, websocket, analyze и format. Летом 2026 проект наконец вышел из нулевых версий: актуальная линейка — 1.x.

Именно её оборачивают и плагин claude-code-bsl-lsp, и серверы bsl-mcp и mcp-bsl-lsp-bridge. То есть, ставя любой из них, вы ставите BSL LS — просто с разным способом доставки в агента.

OneScript

EvilBeaver/OneScript (oscript.io) — кроссплатформенная реализация виртуальной машины языка 1С без самой платформы. Вокруг него выросла вся DevOps-экосистема 1С: vanessa-runner, vanessa-automation, gitsync, precommit1c и больше сотни библиотек. Для агента полезен как исполнитель скриптов: сценарий на знакомом синтаксисе запускается там, где платформы нет — например, в CI.

Рядом стоит 1c-syntax/vsc-language-1c-bsl — расширение VS Code с подсветкой BSL и языка запросов, навигацией и автодополнением для OneScript. Пакет yellow-hammer/vscode-1c-platform-extension-pack собирает вместе 1C Platform Tools, MCP и Language 1C (BSL).

071С:Напарник — официальный AI от фирмы «1С»

1С:Напарник (code.1c.ai) — официальный ИИ-ассистент фирмы «1С», встроенный в 1C:EDT. Автодополнение, генерация кода по описанию, объяснение и ревью кода, документирующие комментарии, автономный агент в чате. Обучен на стандартах разработки «1С» — там, где сторонние модели угадывают канон, он его знает.

По официальной странице Портала ИТС, до 1 октября 2026 «1С:Напарник для разработки» предоставляется без дополнительной оплаты любому пользователю с активной учётной записью на портале 1С:ИТС; на одну учётную запись выдаётся не более 100 ключей активации. Требуется 1C:EDT версии 2023.3.6 или новее; плагин ставится из репозитория https://code.1c.ai/plugin/ через Справка → Установить новое ПО → раздел «AI». На странице подключения отдельно предупреждают о баге в свежих сборках Zulu OpenJDK и советуют взять предыдущую стабильную — zulu17.48.15-ca-fx-jdk17.0.10.

Два ограничения определяют его место в стеке. Напарник работает только в 1C:EDT — в Конфигураторе его нет. И он не позволяет менять системный промпт, то есть не превращается в универсального агента под ваш регламент. Практический вывод: это сильный ассистент внутри EDT, но он не заменяет Claude Code или Codex с MCP там, где нужна автоматизация по вашим правилам и за пределами IDE.

Между мирами есть мосты: ROCTUP/1c-buddy и SteelMorgan/spring-mcp-1c-copilot — MCP-обёртки над API Напарника (нужен токен code.1c.ai).

08Коммерческие продукты

Платные решения закрывают то же, что и open source, но с поддержкой, командной работой и готовыми контейнерами. Имеет смысл, если некому обслуживать связку самостоятельно.

09Как собрать стек под свой проект

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

1. День 1 — фундамент. BSL Language Server (в Claude Code — плагином 1c-syntax/claude-code-bsl-lsp; в Codex и VS Code — расширением Language 1C (BSL) или bsl-mcp) плюс mcp-1c для доступа к метаданным живой базы. Это минимальный must-have: статический анализ и реальный контекст конфигурации.
2. Неделя 1 — прикладные скиллы. В Claude Code — Desko77/claude-code-skills-1c или Nikolay-Shirokov/cc-1c-skills: генерация форм, обработок, отчётов, ролей и СКД из JSON DSL. В Codex — плагин Unica и/или comol/ai_rules_1c через AGENTS.md.
3. Дальше — по потребности. Справочные MCP против галлюцинаций, тест-раннер под YaXUnit, EDT-MCP при работе в EDT, RAG или граф на большой конфигурации.

10Ограничения, о которых стоит знать заранее

Экосистема молодая, и это видно. Четыре вещи, которые честно стоит учесть до того, как ставить это на поток.

• Много beta и экспериментов. В каталоге Untru/1c-mcp статусы проставлены явно: часть серверов помечена как beta, часть — как экспериментальные. Проверяйте статус до продакшена, а не после.
• Экосистема Codex моложе. Codex-плагины появились только в 2026 году, self-serve публикация в официальный каталог OpenAI пока не открыта — распространение идёт через Git-backed и локальные marketplace. Специализированных 1С-плагинов немного: по сути Unica и адаптации существующих наборов. Но MCP и SKILL.md переносимы, так что тупика здесь нет.
• Качество упирается в контекст, а не в модель. MCP снижает долю галлюцинаций, но не устраняет их. Ревью опытного разработчика остаётся обязательным этапом — особенно там, где агент трогает проведение документов, движения по регистрам и закрытие периода.
• Цифры в описаниях плывут. Количество скиллов в наборах и инструментов в серверах меняется от релиза к релизу, а обзоры (включая этот) отстают. Ориентируйтесь на README на момент установки.
• Доступ. Часть инструментов завязана на российские сервисы — code.1c.ai, Портал ИТС, Инфостарт — со всеми вытекающими ограничениями доступа из-за рубежа.

11Как сделать свой скилл или MCP-сервер

Порог входа ниже, чем кажется. Скилл — это папка с файлом SKILL.md: markdown с YAML-фронтматтером, где описано, когда навык применять и что делать. Формат открытый и кроссплатформенный, поэтому один и тот же скилл обычно работает и в Claude Code, и в Codex, и в Cursor.

Для MCP-сервера писать протокол с нуля не нужно — возьмите фреймворк. vladimir-kharin/1c_mcp даёт расширение конфигурации, в котором вы реализуете только ДобавитьИнструменты() и ВыполнитьИнструмент(): транспорт, протокол и авторизация уже внутри. Альтернатива — http1c и MCP-DB-Client от DitriX. В Claude Code для генерации серверов есть официальный плагин mcp-server-dev.

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

Короткие ответы на то, что спрашивают чаще всего.