MCP-мост к 1С:Напарник на Go
1c-copilot-mcp
Go-бинарник с 5 MCP-инструментами к нейросети 1С:Напарник, который читает код 1С прямо из файла по пути, а не через контекст модели
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает файлы проекта напрямую с диска в пределах ALLOWED_CODE_PATHS и отправляет их содержимое во внешний сервис code.1c.ai
- Хранит платный токен доступа в переменных окружения конфигурации клиента
Установка
Ручная установка
git clone https://github.com/EugeneVl/1c-copilot-mcp.git
cd 1c-copilot-mcp
go buildСборка из исходников, нужен установленный Go.
Проверка безопасности
Как мы проверяемСредний рискСредний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
- Читает файлы проекта напрямую с диска в пределах ALLOWED_CODE_PATHS и отправляет их содержимое во внешний сервис code.1c.ai
- Хранит платный токен доступа в переменных окружения конфигурации клиента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает пять инструментов к API 1С:Напарник: комплексную проверку кода, поиск по ИТС и типовым конфигурациям, консультации, объяснение синтаксиса и исследование кодовой базы. Ключевая особенность: инструменты, работающие с кодом, принимают file_path и диапазон строк вместо самого текста кода, сервер сам читает нужный фрагмент из файла проекта, что экономит контекст модели и исключает искажения при копировании через LLM. Доступ к файлам ограничивается переменной ALLOWED_CODE_PATHS. Версия платформы автоматически добавляется в каждый запрос, сессии переиспользуются с TTL, а ответы нормализуются по NFKC и маркерам кода. Отдельный файл 1c-copilot.md написан от первого лица для ИИ-модели и должен подключаться в контекст, чтобы агент знал правила выбора инструмента и параметра file_path.
Для кого. Для 1С-разработчиков с токеном 1С:Напарник, у которых большие BSL-модули не помещаются в контекст модели при обычной передаче кода.
Подходит, если
- Модуль слишком большой, чтобы копировать его в промпт целиком
- Важно, чтобы код передавался в 1С:Напарник без искажений от копирования через модель
- Нужен доступ к 1С:Напарник из VS Code, Cursor, Claude Desktop или Windsurf с единым конфигом
Не подходит, если
- Нет токена 1С:Напарник с code.1c.ai
- Код нужно передавать напрямую текстом, а не через file_path: тогда параметр ALLOWED_CODE_PATHS и чтение файлов не нужны
- Нужен готовый бинарник без ручной сборки, а релиз v0.1.0 на момент README единственный опубликованный
Пример запроса к агенту
Проверь модуль по пути src/CommonModules/ОбщегоНазначения/Module.bsl со строки 100 по 250MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
ONEC_AI_TOKENобязательная, секрет- Обязательный токен API code.1c.ai.
ALLOWED_CODE_PATHS- Разрешенные пути для чтения файлов по file_path, по умолчанию только текущая папка.
ONEC_AI_LOG_FIELDS- Список полей для логирования (prompt, reasoning, answer), логирование выключено если переменная не задана.
Ограничения
Сборка из исходников требует установленный Go, альтернативный путь это готовый бинарник из релиза v0.1.0 на GitHub. Чтение по file_path поддерживает только инструмент check_1c_code, остальные принимают текст. Логирование в 1c-copilot.log пишется рядом с бинарником и включается только при заданной ONEC_AI_LOG_FIELDS, важно не хранить в логе секреты. Нужен платный токен 1С:Напарник с подпиской ИТС, это независимая community-обертка, а не сервер вендора.
Как отключить. Удалите блок 1c-copilot из mcpServers конфигурации клиента и папку с бинарником 1c-copilot-mcp.exe.
Частые вопросы
Зачем передавать file_path, а не сам код?
Сервер сам читает фрагмент из файла, это экономит контекст модели на больших модулях и исключает искажения текста при копировании через LLM.
Обязательно ли подключать 1c-copilot.md?
Да, README прямо говорит, что без этого файла модель не знает ключевых правил, например что использовать file_path вместо code.
Похожие
MCP-серверыНабор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything
Коротко о README
README описывает Go MCP-сервер с 5 инструментами к 1С:Напарник, таблицу переменных окружения, механизм чтения кода по file_path с обоснованием экономии контекста и контроля доступа через ALLOWED_CODE_PATHS, настройку логирования через ONEC_AI_LOG_FIELDS. Отдельный крупный раздел написан как пошаговая инструкция для ИИ-модели: как спросить пользователя про способ установки, собрать из исходников или скачать бинарник, получить токен и определить формат конфигурации конкретного MCP-клиента перед тем как его менять.