> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/mcp-servery-1c/servery/code-checker.md).

# 1CCodeChecker

Проверка, анализ и работа с кодом и документацией 1С через сервис 1С:Напарник.

## Назначение

1CCodeChecker — MCP-сервер, построенный на базе [FastMCP](https://github.com/jlowin/fastmcp), который интегрируется с сервисом **1С:Напарник** (code.1c.ai). Предоставляет ИИ-ассистенту набор из **11 инструментов** для полноценной работы с экосистемой 1С:Предприятие:

* Проверка и анализ кода (синтаксис, логика, производительность, стиль)
* Переписывание и модификация кода с автоматической валидацией
* Поиск по документации платформы с поддержкой версий
* Работа с базой знаний ИТС (поиск, чтение документов, стандарты)
* Сравнение документации между версиями платформы
* Поиск по документации прикладных конфигураций (ERP, БП, УТ и др.)
* Свободные вопросы к ИИ-ассистенту 1С:Напарник

## Возможности

ИИ получает инструменты для:

* **Проверки кода** — синтаксические ошибки, логические проблемы, производительность
* **Ревью кода** — стиль, стандарты ИТС, именование, структура, комментирование
* **Переписывания кода** — ИИ предлагает улучшенную версию с объяснениями
* **Модификации кода** — точное выполнение инструкций пользователя
* **Поиска по документации платформы** — с указанием версии (v8.3.x, v8.5.x)
* **Поиска по базе знаний ИТС** — стандарты, методики, статьи
* **Чтения документов ИТС** — получение полного содержимого по ID
* **Сравнения версий документации** — что изменилось между версиями платформы
* **Поиска по конфигурациям** — документация прикладных решений
* **Свободных вопросов** — любые вопросы по разработке на 1С

## Примеры использования

* "Проверь этот код на ошибки" → `check_1c_code`
* "Проведи code review этого модуля" → `review_1c_code`
* "Перепиши этот код, улучши производительность" → `rewrite_1c_code`
* "Добавь обработку ошибок в эту процедуру" → `modify_1c_code`
* "Что такое РегистрНакопления в 1С?" → `onec_help`
* "Найди в документации v8.3.25 описание HTTP-соединений" → `search_1c_documentation`
* "Какие стандарты именования переменных в ИТС?" → `its_help`
* "Что изменилось между v8.3.25 и v8.5.1?" → `diff_1c_documentation_versions`
* "Как работает проведение документов в ERP?" → `config_help`
* "Объясни разницу между ОбщийМодуль и МодульОбъекта" → `ask_1c_ai`

## Требования

* Docker Desktop с WSL2
* Лицензионный ключ MCP (`LICENSE_KEY`)
* **Токен 1С:Напарник** (`ONEC_AI_TOKEN`, только для подписчиков ИТС)
* Доступ в интернет к code.1c.ai

{% hint style="info" %}
Токен 1С:Напарник доступен **подписчикам ИТС**. Оформить подписку можно на [developer.1c.ru](https://developer.1c.ru/). Если у вас нет подписки, используйте [SyntaxCheckServer](/mcp-servery-1c/servery/syntax-check-server.md) как альтернативу для проверки синтаксиса.
{% endhint %}

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

ИИ получает **11 инструментов**:

### Анализ и работа с кодом

| Инструмент        | Описание                                                           |
| ----------------- | ------------------------------------------------------------------ |
| `ask_1c_ai`       | Свободный вопрос к ИИ 1С:Напарник (с поддержкой контекста диалога) |
| `check_1c_code`   | Проверка кода: синтаксис, логика, производительность               |
| `review_1c_code`  | Code review: стиль, стандарты ИТС, именование, структура           |
| `rewrite_1c_code` | Переписывание кода ИИ с улучшениями и объяснениями                 |
| `modify_1c_code`  | Модификация кода по явной инструкции пользователя                  |

### Документация и база знаний

| Инструмент                       | Описание                                                            |
| -------------------------------- | ------------------------------------------------------------------- |
| `search_1c_documentation`        | Поиск в документации платформы (с указанием версии)                 |
| `onec_help`                      | Поиск в документации платформы (последняя версия)                   |
| `its_help`                       | Поиск по базе знаний ИТС (стандарты, методики, статьи)              |
| `fetch_its`                      | Чтение содержимого документа ИТС по ID                              |
| `diff_1c_documentation_versions` | Сравнение документации между версиями платформы                     |
| `config_help`                    | Поиск документации по прикладным конфигурациям (ERP, БП, ЗУП и др.) |

Подробное описание каждого инструмента — в разделе [Инструменты](/mcp-servery-1c/servery/code-checker/instrumenty.md).

## Порт

**8007**

## Образ Docker

```
comol/1c-code-checker:latest
```

## Быстрый старт

```powershell
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
```

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

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

## Режимы вызова инструментов

Сервер поддерживает два режима работы (переменная `MCP_TOOL_CALL_MODE`):

* **`direct`** (по умолчанию) — инструменты вызывают upstream-инструменты 1С.ai напрямую для более точных результатов
* **`standard`** — все инструменты работают через промпты (текстовые запросы)

Подробнее — в разделе [Конфигурация](/mcp-servery-1c/servery/code-checker/konfiguraciya.md).

## Оригинальная идея

[github.com/artesk/1copilot\_MCP](https://github.com/artesk/1copilot_MCP)

## Структура раздела

* [Установка](/mcp-servery-1c/servery/code-checker/ustanovka.md) — команды запуска и проверка работы
* [Получение токена](/mcp-servery-1c/servery/code-checker/poluchenie-tokena.md) — как получить токен 1С:Напарник
* [Инструменты](/mcp-servery-1c/servery/code-checker/instrumenty.md) — подробное описание всех 11 инструментов
* [Конфигурация](/mcp-servery-1c/servery/code-checker/konfiguraciya.md) — переменные окружения и режимы работы