Установка

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

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

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

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

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

docker ps --filter name=1c_code_checker

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

docker logs 1c_code_checker

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

License key validated successfully.
Starting 1C Code Checker MCP server on http://0.0.0.0:8007/mcp using streamable-http

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

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

{
  "mcpServers": {
    "1c-code-checker-mcp": {
      "url": "http://localhost:8007/mcp",
      "connection_id": "1c_code_checker_001"
    }
  }
}

После добавления перезапустите 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