1c Naparnik

1С:Напарник - MCP Tools Reference

MCP-сервер 1c-naparnik - интеграция с API 1С:Напарник (code.1c.ai). 12 инструментов: 6 для анализа/модификации BSL-кода, 6 для поиска по документации и базе знаний ИТС.

When to Use

Используй инструменты 1c-naparnik когда:

• Нужно проверить качество BSL-кода (стиль, архитектура, стандарты)
• Нужно проверить код на синтаксические ошибки, логические проблемы, антипаттерны производительности
• Нужно получить code review по стандартам ИТС
• Нужно переписать или модифицировать BSL-код с улучшениями
• Нужно объяснение конкретной конструкции языка BSL
• Нужно найти методологическую статью или стандарт на ИТС
• Нужно прочитать конкретный документ ИТС по ID
• Нужно найти информацию в документации платформы (встроенные функции, типы, события)
• Нужно сравнить изменения между версиями платформы
• Нужно найти информацию по конкретной конфигурации (ERP, ЗУП, Бухгалтерия)

Prerequisites Check

Сервер работает через Docker-контейнер на порту 8007. Если инструменты не отвечают - сообщи пользователю:

MCP-сервер 1c-naparnik недоступен. Запустите Docker-контейнер:

cd <путь к 1c-code-checker> && docker compose up -d

Tools by Category

Анализ и модификация кода (6 инструментов)

ask_1c_ai - Свободный вопрос к ИИ

Основной инструмент для любых вопросов по 1С. Поддерживает контекст диалога (сессии).

Когда использовать:

• ОБЯЗАТЕЛЬНО после каждого написания/изменения BSL-кода - быстрая проверка качества
• Общие вопросы по архитектуре, паттернам, подходам 1С
• Вопросы, не подходящие под специализированные инструменты
• Когда нужен контекст предыдущего диалога (серия связанных вопросов)

check_1c_code - Техническая проверка кода

Проверка синтаксиса, логических ошибок, антипаттернов производительности (запросы в цикле, N+1, обращение через точку).

Когда использовать:

• Проверка: скомпилируется ли код, есть ли баги
• Поиск антипаттернов производительности
• Альтернатива syntaxcheck (1c-syntax-checker-mcp) с расширенным анализом логики

review_1c_code - Code review стиля и стандартов

Ревью по стандартам ИТС: именование, структура, читаемость, соответствие стандартам. НЕ проверяет синтаксис.

Когда использовать:

• Проверка соответствия стандартам ИТС (именование переменных, структура модуля)
• Оценка читаемости и поддерживаемости кода
• Перед коммитом - финальное ревью стиля

rewrite_1c_code - Улучшение кода (ИИ решает что улучшить)

ИИ анализирует код и предлагает свою улучшенную версию. В отличие от modify_1c_code, здесь ИИ сам решает, что и как улучшить.

Когда использовать:

• Рефакторинг: хочешь увидеть, как ИИ переписал бы код
• Нужна альтернативная реализация для сравнения
• Оптимизация кода без конкретной инструкции

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

Изменение кода по точной инструкции пользователя. В отличие от rewrite_1c_code, здесь ИИ следует конкретному указанию.

Когда использовать:

• Точечное исправление бага ("исправить обработку NULL")
• Добавление конкретной функциональности
• Рефакторинг с конкретным направлением ("вынести в отдельную функцию")

explain_1c_syntax - Объяснение синтаксиса

Объяснение конкретного ключевого слова, оператора, конструкции или встроенной функции BSL.

Когда использовать:

• Незнакомая конструкция BSL
• Нужно точное объяснение конкретного ключевого слова/оператора
• Для широких вопросов лучше ask_1c_ai

Документация и база знаний (6 инструментов)

its_help - Поиск по ИТС

Поиск методологических рекомендаций, стандартов разработки, статей на ИТС (its.1c.ru). Возвращает список документов с ID.

Когда использовать:

• Поиск стандартов разработки ИТС
• Методологические рекомендации (как правильно реализовать обмен, печатные формы, отчеты)
• Статьи по конфигурированию и администрированию
• Результат - список документов с ID. Для чтения используй fetch_its

fetch_its - Чтение документа ИТС

Получение содержимого документа ИТС по ID. Используется после its_help.

Когда использовать:

• Чтение конкретного документа ИТС после поиска через its_help
• Навигация по структуре ИТС (id="root" - корень)
• Поддерживает: root, superior, v8std, документы и каталоги

Типичный workflow: its_help("стандарты именования") -> получить ID -> fetch_its(id="its-...-hdoc")

search_1c_documentation - Документация платформы (по версии)

Поиск в документации платформы 1С:Предприятие конкретной версии. Встроенные функции, типы, события, свойства, объекты платформы.

Когда использовать:

• Нужна документация для конкретной версии платформы
• Проверка: есть ли метод/тип в определенной версии
• Если версия не важна - используй onec_help

onec_help - Документация платформы (последняя версия)

Поиск в документации платформы последней версии. Упрощенный вариант search_1c_documentation без указания версии.

Когда использовать:

• Быстрый поиск по документации платформы без привязки к версии
• Проверка существования метода/типа/свойства
• Если нужна конкретная версия - используй search_1c_documentation

diff_1c_documentation_versions - Сравнение версий

Сравнение документации платформы между двумя версиями. Что изменилось, добавлено, удалено.

Когда использовать:

• Миграция между версиями платформы - что изменилось
• Проверка: когда появился конкретный метод/тип
• Оценка breaking changes между версиями

config_help - Документация конфигураций

Поиск по документации прикладных конфигураций: ERP, ЗУП, Бухгалтерия, УТ и др. Объекты, модули, регистры, документы, бизнес-логика конфигурации.

Когда использовать:

• Как работает конкретный механизм в ERP/ЗУП/Бухгалтерии
• Назначение объекта, регистра, документа конфигурации
• Бизнес-логика конкретной конфигурации
• НЕ для API платформы (используй onec_help/search_1c_documentation)

Typical Workflows

Проверка качества BSL-кода (после написания/изменения)

1. ask_1c_ai(question="<код>") - быстрая проверка качества (ОБЯЗАТЕЛЬНО)
2. check_1c_code(code="<код>") - синтаксис + логика + производительность (при необходимости)
3. review_1c_code(code="<код>") - стиль и стандарты ИТС (перед коммитом)

Рефакторинг кода

1. review_1c_code(code="<код>") - получить замечания
2. ПРОВЕРИТЬ каждое замечание по факту: существование метода и сигнатуру - через bsl-platform-help или
 исходники БСП, поведение - через код проекта. Неподтвержденное замечание НЕ исправлять
3. rewrite_1c_code(code="<код>", goal="производительность") - вариант ИИ
 ИЛИ
 modify_1c_code(instruction="вынести запрос в отдельную функцию", code="<код>") - точечное изменение
4. Результат генерации ИИ тоже проверить: вызванные методы должны существовать
5. ask_1c_ai(question="<новый код>") - проверка результата

Напарник дает false positives и ссылается на несуществующие API. Правка кода по непроверенному замечанию или прием сгенерированного варианта без сверки методов - источник багов. Обязательный порядок - rules/mcp-tool-priority.md, раздел "Обязательные проверки".

Поиск стандарта ИТС

1. its_help(query="обработка исключений") - найти документы
2. fetch_its(id="its-...-hdoc") - прочитать нужный документ

Проверка API платформы

Вариант A (с версией):
 search_1c_documentation(query="HTTPСоединение", version="8.3.25")

Вариант B (последняя версия):
 onec_help(query="HTTPСоединение")

Миграция между версиями

1. diff_1c_documentation_versions(version_a="8.3.24", version_b="8.3.25")
2. diff_1c_documentation_versions(version_a="8.3.24", version_b="8.3.25", query="HTTP")

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

config_help(query="расчет себестоимости", config_name="ERP")

Разграничение с другими MCP-серверами

Когда что искать