Установка

Предварительные требования

  1. Docker Desktop запущен

  2. Токен 1С:Напарник (см. Получение токена)

  3. Доступ в интернет к code.1c.ai

Команда запуска

Минимальная (обязательные переменные)

docker run -d -p 8007:8007 `
  --name 1c_code_checker `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e ONEC_AI_TOKEN=YOUR_NAPARNIR_TOKEN `
  comol/1c-code-checker:latest

Расширенная (с дополнительными настройками)

docker run -d -p 8007:8007 `
  --name 1c_code_checker `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e ONEC_AI_TOKEN=YOUR_NAPARNIR_TOKEN `
  -e ONEC_CONFIG_NAME="Бухгалтерия предприятия" `
  comol/1c-code-checker:latest

Полный список переменных окружения — в разделе Конфигурация.

Проверка работы

Статус контейнера

Просмотр логов

При успешном запуске в логах будет:

Конфигурация Cursor

Добавьте в .cursor/mcp.json вашего проекта:

После добавления перезапустите Cursor или обновите MCP-подключения через настройки.

Использование

Доступные инструменты

Сервер предоставляет 11 инструментов MCP. Основные:

Инструмент
Что делает

check_1c_code

Проверка кода на ошибки (синтаксис, логика, производительность)

review_1c_code

Code review (стиль, стандарты ИТС)

rewrite_1c_code

Переписывание кода ИИ с улучшениями

modify_1c_code

Модификация кода по инструкции

onec_help

Поиск по документации платформы

its_help

Поиск по базе знаний ИТС

ask_1c_ai

Свободный вопрос к 1С:Напарник

Полный список — в разделе Инструменты.

Пример в Cursor

Пользователь: "Проверь этот код на ошибки"

ИИ автоматически вызывает check_1c_code и возвращает результат анализа, включая проверку синтаксиса (через upstream syntax-checker в direct-режиме) и анализ логики/производительности.

Устранение проблем

Ошибка авторизации

Проверьте токен 1С:Напарник:

  • Токен действителен и не истёк

  • Токен правильно указан в переменной ONEC_AI_TOKEN

Нет связи с code.1c.ai

Проверьте:

  • Доступ в интернет из контейнера

  • Firewall не блокирует code.1c.ai (порт 443)

Ошибка лицензии

При сообщении "Invalid license key" или "License key not provided":

  • Проверьте, что LICENSE_KEY указан и корректен

Ошибки direct mode

Если в ответах появляется [DIRECT_TOOL_ERROR]:

  • Установите MCP_TOOL_CALL_MODE=standard для переключения на промпт-режим

  • Или перезапустите контейнер — возможна временная недоступность upstream API

Last updated