Платформы, лицензирование и FAQ
Поддерживаемые операционные системы и AI-клиенты, лицензирование платных версий и ответы на частые вопросы.
Поддерживаемые платформы
Операционные системы
| ОС | MCP-сервер | Автоустановка | HTTP-сервис 1С |
|---|---|---|---|
| Windows (x64) | Да | Да | Apache или IIS |
| macOS (x64, ARM) | Да | Да | Нет (ограничение платформы 1С) |
| Linux (x64, ARM64) | Да | Да | Apache или ibsrv |
Платформы 1С: 8.3.x и 8.5.x (коммерческая и учебная).
AI-клиенты
| AI-клиент | Статус | Примечания |
|---|---|---|
| Claude Desktop | Полная поддержка | Нативная поддержка MCP |
| Claude Code (CLI) | Полная поддержка | Терминальный клиент Anthropic |
| Cursor | Полная поддержка | Settings → MCP |
| Windsurf | Полная поддержка | MCP-совместимый |
| VS Code + Copilot | Полная поддержка | Через GitHub Copilot MCP |
| VS Code + Continue | Полная поддержка | Open Source расширение |
| JetBrains IDE | Полная поддержка | IntelliJ, GoLand и другие |
Лицензирование платных версий
Расширенная и Профессиональная версии требуют лицензионный ключ. Лицензия привязывается к конкретной машине при активации. Процесс одинаковый для mcp-1c-pro и mcp-1c-advanced.
Активация
mcp-1c-pro --activate "MCP-XXXX-XXXX-XXXX-XXXX" # или mcp-1c-advanced
Пример вывода
License activated successfully!
Edition: Pro
Expires: 2026-04-14
Ключ активируется один раз. Лицензия хранится локально и проверяется периодически.
Проверка статуса
mcp-1c-pro --license-status # или mcp-1c-advanced
Пример вывода
License: ACTIVE
Key: MCP-XXXX-XXXX-XXXX-XXXX
Expires: 2026-04-14
Edition: Pro
Деактивация
mcp-1c-pro --deactivate # или mcp-1c-advanced
Пример вывода
License deactivated.
Деактивация освобождает слот устройства. Используйте перед переносом лицензии на другую машину.
Обновление
Платные бинарники умеют обновляться сами. Флаг --update проверяет наличие новой версии и, если она есть, скачивает её и заменяет текущий бинарник на месте.
mcp-1c-pro --update # или mcp-1c-advanced
Пример вывода
Текущая версия: ...
Проверка обновлений...
Обновление до ... выполнено успешно.
- Загрузка идёт через лицензионный сервер: запрос авторизуется лицензионным ключом и идентификатором машины.
- Перед заменой бинарника проверяется криптографическая подпись (Ed25519) скачанного файла, что защищает от подмены.
- Если установлена последняя версия, выводится
Установлена последняя версия.и бинарник не меняется. - После обновления перезапустите MCP-сервер (и AI-клиент, если он держал процесс).
Обновление данных синтаксиса
# Автоматически найдет платформу
mcp-1c-pro --update-syntax # или mcp-1c-advanced
# Или укажите путь вручную
mcp-1c-pro --update-syntax --platform /opt/1cv8/8.3.25.1000
Разбирает файлы синтакс-помощника платформы (shcntx_ru.hbk) и сохраняет в локальный кэш. После обновления перезапустите MCP-сервер.
Что произойдёт
- Бинарник найдёт установленную платформу 1С на вашей машине
- Распарсит файлы справки (.hbk) вашей версии платформы
- Сохранит данные в кэш (~/.cache/mcp-1c/syntax/ или %LocalAppData%)
- При следующем запуске
code_search(action: "syntax_help")будет использовать справку той версии платформы, которая была указана при последнем запуске (при автоопределении самой новой установленной); для баз на разных версиях укажите нужную через--platform
Часто задаваемые вопросы
MCP-1C изменяет данные в моей базе 1С?
Открытая версия работает только на чтение: метаданные, код модулей, запросы (только SELECT). Расширенная версия добавляет возможность выполнения кода через sandbox (с подтверждением, аудит-логом и ограничениями безопасности). Ни одна версия не модифицирует конфигурацию.
Нужен ли доступ в интернет для работы MCP-1C?
MCP-сервер работает полностью локально и не требует интернета. Интернет нужен только AI-клиенту (Claude, Cursor и т.д.) для связи со своим облачным AI. Расширенная и Профессиональная версии периодически проверяют лицензию через интернет.
Могу ли я использовать MCP-1C с несколькими базами одновременно?
Открытая версия поддерживает одну базу. Расширенная версия поддерживает мультибазовый режим: подключите несколько баз через --base NAME=URL (повторяемый флаг). AI-ассистент сам выбирает нужную базу.
Как использовать MCP-1C на macOS, если HTTP-сервис 1С не поддерживается?
MCP-сервер запускается на macOS, но HTTP-сервис 1С необходимо запустить на Windows или Linux (через виртуальную машину или удаленный сервер). Укажите URL удаленного HTTP-сервиса в --base.
Что такое code_search и зачем нужна выгрузка конфигурации?
code_search(action: "text") -- действие полнотекстового поиска по всему коду модулей конфигурации. Для его работы необходима выгрузка конфигурации в файлы (Конфигуратор → Конфигурация → Выгрузить конфигурацию в файлы). Путь указывается через --dump. Старт неблокирующий: сервер доступен сразу, а поисковый индекс строится в фоне (~7 сек для 13 000+ модулей). Пока индекс не готов, поиск по коду возвращает сообщение «Идёт построение индекса базы, повторите запрос через несколько секунд», результаты становятся доступны по мере готовности. Индекс кэшируется на диске, поэтому повторные запуски используют готовый кэш.
В чем разница между Открытой, Расширенной и Профессиональной версиями?
Открытая -- бесплатная open source версия с 10 инструментами: метаданные, код модулей, выполнение запросов, поиск по коду, валидация, журнал регистрации, структура форм, информация о конфигурации, справка по синтаксису BSL, анализ подсистем.
Расширенная -- платная версия с 8 консолидированными инструментами. Возможности Открытой объединены в инструменты с параметром action (code_read, code_search, code_execute, system), к ним добавлены code_analyze (глубокий анализ кода, совместимость), code_generate (оптимизация запросов, генерация кода, печатные формы), memory (долговременная память по базе) и templates (библиотека шаблонов кода). Плюс расширенный синтакс-помощник (.hbk) с поддержкой русской морфологии, разрешение объектов по имени/GUID, выведенные XSD-схемы и проверка XML, мультибазовость, поддержка расширений .cfe, long polling и другое.
Профессиональная -- включает все инструменты Расширенной плюс: 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 --deactivate # или mcp-1c-advanced на старой машине, затем mcp-1c-pro --activate YOUR-KEY # или mcp-1c-advanced на новой. Деактивация освобождает слот устройства.
Почему антивирус (например, Windows Defender) срабатывает на бинарный файл?
Это ложное срабатывание. Бинарный файл обфусцируется для защиты от анализа и декомпиляции, а обфусцированные исполняемые файлы, особенно собранные на Go, часто распознаются эвристикой антивирусов как подозрительные. Вредоносного кода в сборке нет.
Это поведение воспроизводимо и не зависит от содержимого программы. Вопрос ранее разбирался в GitHub Issues. На Infostart показано, как получить такое же срабатывание в VirusTotal при самостоятельной сборке открытой версии с обфускацией.
Мы собрали Открытую редакцию с обфускацией и проверили её через VirusTotal. Вы можете повторить сборку и проверку самостоятельно и убедиться, что причина именно в обфускации, а не в содержимом.
На большой базе Claude Code обрывает подключение к MCP-серверу (ошибка -32000, Connection closed)
Начиная с версии 2.23.4 эта проблема устранена: на большой базе сервер выходит в готовность сразу. Сервер немедленно принимает подключение и строит поисковый индекс в фоне, поэтому соединение больше не обрывается при первом запуске. Пока индекс строится, поиск по коду и чтение модулей возвращают сообщение «Идёт построение индекса базы, повторите запрос через несколько секунд» и становятся доступны по мере готовности; повторный запуск использует готовый кэш и проходит практически мгновенно.
Если вы столкнулись с ошибкой -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 с хранилищем конфигурации при работе нескольких разработчиков?
mcp-1c работает с конфигурацией только на чтение: читает метаданные, модули и расширения, но не захватывает, не помещает и не блокирует объекты и не обращается к API хранилища. Поэтому совместной работе нескольких разработчиков через хранилище он не мешает: захваты, помещения и история версий остаются полностью за вами.
Расширение mcp-1c (.cfe) ставится как отдельное расширение конфигурации, в хранилище основной конфигурации не хранится и обычно устанавливается без монопольного режима. В редакциях Расширенная и Профессиональная инструмент выполнения кода по умолчанию работает только на чтение и может менять только данные, а не конфигурацию и не хранилище.