Платформы, лицензирование и FAQ

Открытая версия работает только на чтение: метаданные, код модулей, запросы (только SELECT). Расширенная версия добавляет выполнение кода BSL в базе: в режиме по умолчанию сервер отклоняет код с запрещёнными конструкциями, а в режиме full с подтверждением выполняет его без этой проверки, и такой код может менять данные. Подробнее в ответе о хранилище ниже. Конфигурацию в базе инструменты не меняют: в базу ставятся и обновляются только расширения самого MCP-1C. Инструмент form_edit Расширенной версии правит файлы обычных форм в каталоге выгрузки на диске, а загружать их в базу нужно самостоятельно.

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

Открытая версия поддерживает одну базу. Расширенная версия поддерживает мультибазовый режим: подключите несколько баз через --base NAME=URL (повторяемый флаг). AI-ассистент сам выбирает нужную базу.

MCP-сервер запускается на macOS, но HTTP-сервис 1С необходимо запустить на Windows или Linux (через виртуальную машину или удаленный сервер). Укажите URL удаленного HTTP-сервиса в --base.

code_search(action: "text") это действие полнотекстового поиска по всему коду модулей конфигурации. Для его работы необходима выгрузка конфигурации в файлы (Конфигуратор → Конфигурация → Выгрузить конфигурацию в файлы). Путь указывается через --dump. Старт неблокирующий: сервер доступен сразу, а поисковый индекс строится в фоне (~7 сек для 13 000+ модулей). Пока индекс строится, поиск по коду возвращает сообщение «Индекс базы ещё не готов. Он строится один раз после запуска сервера, время зависит от размера конфигурации. Повторите запрос позже», такой текст у сообщения с версии 2.41.0. Если сборка индекса прервалась, ответ другой: «Не удалось построить индекс базы» с причиной и просьбой перезапустить сервер. Индекс кэшируется на диске, поэтому повторные запуски используют готовый кэш.

Открытая - бесплатная open source версия с 11 инструментами: метаданные, структура объекта, выполнение запросов, валидация запросов, поиск по коду, структура форм, журнал регистрации, информация о конфигурации, справка по синтаксису BSL, анализ подсистем и перечитывание выгрузки. Два из них, search_code и reload_dump, работают по выгрузке конфигурации и регистрируются только при запуске с --dump; остальные девять доступны всегда.

Расширенная это платная версия: 10 консолидированных инструментов и два самостоятельных. Возможности Открытой объединены в инструменты с параметром action (code_read, code_search, code_execute, system), к ним добавлены code_analyze (глубокий анализ кода, совместимость), code_generate (оптимизация запросов, генерация кода, печатные формы), memory (долговременная память по базе), templates (библиотека шаблонов кода), form_edit (создание и изменение обычных форм) и tj_analyze (разбор технологического журнала 1С). Самостоятельными под своими именами из Открытой версии остались analyze_subsystems (анализ топологии подсистем) и reload_dump (перечитывание выгрузки). Без действующей подписки сервер регистрирует шесть инструментов уровня Открытой версии: code_read, code_search, code_execute, system, analyze_subsystems и reload_dump. Остальные шесть, code_analyze, code_generate, memory, templates, form_edit и tj_analyze, требуют действующей подписки уровня Расширенной: пока подписки нет или она истекла, в списке инструментов их нет. Если подписки нет уже на старте, сервер их вовсе не регистрирует, а если она перестала действовать на работающем сервере, он убирает их из списка. После восстановления подписки они появляются снова. Плюс расширенный синтакс-помощник (.hbk) с поддержкой русской морфологии, разрешение объектов по имени/GUID, выведенные XSD-схемы и проверка XML, мультибазовость, поддержка расширений .cfe, long polling и другое.

Профессиональная - включает все инструменты Расширенной плюс: document (поиск и чтение документов, создание и изменение непроведённых черновиков с подтверждением), print_export (штатные печатные формы и отчёты в PDF/XLSX, списки документов в Excel), bulk_analyze (массовый анализ всей кодовой базы), граф зависимостей, иерархия вызовов методов (call_hierarchy), досье объекта (dossier), сверка основной конфигурации с расширением (code_review.base_vs_ext), семантический поиск (включая семантику memory и templates), аудит безопасности, метрики качества, CI/CD интеграция, помощник по обновлению типовых, HTML/PDF отчеты, архитектурная визуализация (Mermaid-диаграммы), автогенерация документации (YandexGPT/GigaChat), генерация YAxUnit и Vanessa тестов, генерация Designer-compatible .epf обработок и навигация по типовым конфигурациям (БП, ЗУП, УТ, Розница, КА, ERP). При регистрации вы получаете 14-дневный пробный период Профессиональной версии.

Сравнение тарифов →

Выполните mcp-1c-pro --activate YOUR-KEY на новой машине, в Расширенной версии ту же команду через mcp-1c-advanced. Прежнюю машину эта команда освобождает сама, поэтому переносить ключ можно и тогда, когда старая машина уже недоступна. Если старая машина ещё работает, остановите на ней сервер, иначе он может забрать ключ обратно. Подробнее в разделах Перенос на другую машину и Если активация не прошла.

Это ложное срабатывание. Бинарный файл обфусцируется для защиты от анализа и декомпиляции, а обфусцированные исполняемые файлы, особенно собранные на Go, часто распознаются эвристикой антивирусов как подозрительные. Вредоносного кода в сборке нет.

Это поведение воспроизводимо и не зависит от содержимого программы. Вопрос ранее разбирался в GitHub Issues. На Infostart показано, как получить такое же срабатывание в VirusTotal при самостоятельной сборке открытой версии с обфускацией.

Пример проверки Открытой редакции с обфускацией доступен в VirusTotal. Вы можете повторить сборку и проверку самостоятельно.

Начиная с версии 2.23.4 эта проблема устранена: на большой базе сервер выходит в готовность сразу. Сервер немедленно принимает подключение и строит поисковый индекс по выгрузке (--dump) в фоне, поэтому соединение больше не обрывается при первом запуске. Пока индекс строится, поиск по коду возвращает сообщение «Индекс базы ещё не готов. Он строится один раз после запуска сервера, время зависит от размера конфигурации. Повторите запрос позже», такой текст у сообщения с версии 2.41.0. Модуль объекта или менеджера на базе, подключённой к 1С, в это время запрашивается у самой 1С и приходит, если она его отдаёт, а чтение модуля, который сервер берёт только из выгрузки, например общего, отвечает отказом с тем же сообщением в тексте ошибки. Если сборка индекса прервалась, ответ другой: «Не удалось построить индекс базы» с причиной и просьбой перезапустить сервер. Повторный запуск использует готовый кэш и проходит практически мгновенно.

Если вы столкнулись с ошибкой -32000 / Connection closed. Скорее всего, используется более старая версия, где первая сборка индекса на большой базе блокировала запуск. Обновитесь до версии 2.23.4 или новее - этого достаточно, отдельно увеличивать таймаут больше не нужно.

Про MCP_TIMEOUT. Это общая настройка Claude Code: сколько ждать запуска MCP-сервера (значение в миллисекундах, по умолчанию 30000, то есть 30 секунд). Для первой сборки индекса на большой базе она больше не нужна, но остаётся полезной для других случаев медленного старта MCP-сервера. Задать её можно при запуске (MCP_TIMEOUT=120000 claude) или постоянно - в секции env файла настроек Claude Code (~/.claude/settings.json или .claude/settings.json в проекте): "env": { "MCP_TIMEOUT": "120000" }.

Не путать с другими таймаутами. MCP_TIMEOUT управляет временем запуска MCP-сервера в Claude Code. Это не то же самое, что --request-timeout (MCP_1C_REQUEST_TIMEOUT) - таймаут HTTP-запроса от сервера к 1С. За длительность отдельного вызова инструмента отвечает MCP_TOOL_TIMEOUT или поле timeout в записи сервера в .mcp.json.

С конфигурацией в базе и в хранилище mcp-1c работает только на чтение: читает метаданные, модули и расширения, но не захватывает, не помещает и не блокирует объекты и не обращается к API хранилища. Инструмент form_edit Расширенной версии правит файлы обычных форм в каталоге выгрузки, но в базу и в хранилище их не загружает. Поэтому совместной работе нескольких разработчиков через хранилище он не мешает: захваты, помещения и история версий остаются полностью за вами.

Расширение mcp-1c (.cfe) ставится как отдельное расширение конфигурации, в хранилище основной конфигурации не хранится и обычно устанавливается без монопольного режима. В редакциях Расширенная и Профессиональная инструмент выполнения кода в режиме по умолчанию read_only отклоняет код, в котором найдены запрещённые конструкции, например запись, проведение и удаление объектов, транзакции, удаление, копирование и перемещение файлов, запуск программ, соединения HTTP и FTP. Это проверка текста кода на стороне сервера MCP, а не режим только для чтения в 1С: расширение выполняет код одинаково в обоих режимах. В режиме full с подтверждением confirm=true этой проверки нет, и код может менять данные. Инструмент Профессиональной редакции document отдельно создаёт и изменяет непроведённые черновики после подтверждения в MCP-клиенте; штатные проверки и обработчики 1С при этом выполняются. Чтобы закрыть выполнение кода и запись через document, подключите базу с флагом --read-only: для такой базы код закрыт при любом режиме, а create/update — до подготовки формы согласия.