MCP-сервер к API 1С:Напарник
1C AI MCP
Docker-сервер на FastMCP с 12 инструментами анализа BSL-кода и поиска по документации через API 1С:Напарник (code.1c.ai)
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Отправляет фрагменты BSL-кода и вопросы во внешний сервис code.1c.ai
- Хранит платный токен доступа в переменных окружения или Docker Secrets
Установка
Ручная установка
docker run -d --name 1c-ai-mcp -p 8007:8007 -e ONEC_AI_TOKEN="ваш-токен" desko77/1c-ai-mcp:latestГотовый образ из Docker Hub, рекомендуемый способ.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает API нейросети 1С:Напарник в набор MCP-инструментов: проверку кода по синтаксису, логике и производительности, code review по стандартам ИТС, переписывание и модификацию кода по инструкции, объяснение синтаксиса и произвольные вопросы с сохранением контекста диалога. Отдельная группа инструментов ищет по базе ИТС, документации платформы с учетом версии, сравнивает документацию между версиями и ищет по прикладным конфигурациям вроде ERP или ЗУП. Есть два режима вызова: standard формирует текстовые промпты, а direct обращается к конкретным upstream-инструментам 1С:Напарник напрямую с автоматическим откатом на standard при сбое.
Для кого. Для 1С-разработчиков с подпиской ИТС и токеном 1С:Напарник, которые хотят вызывать эту нейросеть прямо из Cursor или Claude Code как MCP-инструмент.
Подходит, если
- Нужна проверка или ревью BSL-кода стандартами ИТС прямо из IDE
- Нужен быстрый поиск по документации платформы или прикладной конфигурации с учетом версии
- Нужно сравнить поведение платформы между двумя версиями
Не подходит, если
- Нет подписки ИТС и токена 1С:Напарник: сервис платный и требует регистрации на code.1c.ai
- Код или вопросы содержат конфиденциальные данные, которые нельзя отправлять во внешний сервис
- Нужен официальный сервер от вендора: это независимая community-обертка над API
Пример запроса к агенту
Проверь этот код обработки проведения на соответствие стандартам ИТС и предложи улучшенияОграничения
Нужен платный токен 1С:Напарник, доступный по подписке ИТС. Проект основан на идее закрытого сейчас репозитория comol/1c-code-checker с исправлениями API, заимствованными из SteelMorgan/spring-mcp-1c-copilot, то есть это независимая community-обертка, а не сервер вендора. Режим direct зависит от конкретных названий upstream-инструментов 1С:Напарник и может потребовать обновления при их изменении на стороне сервиса.
Как отключить. Остановите контейнер командой docker compose down или docker stop 1c-ai-mcp и удалите сервер из настроек MCP-клиента.
MCP
- Транспорт
- http, sse
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| ONEC_AI_TOKEN обязательная, секрет | Токен API 1С:Напарник, требует подписки ИТС, обязателен если не задан ONEC_AI_TOKEN_FILE. |
| ONEC_AI_TOKEN_FILE секрет | Путь к файлу с токеном для передачи через Docker Secrets. |
| ONEC_CONFIG_NAME | Название прикладной конфигурации для инструмента config_help, например ERP или ЗУП. |
Проверка безопасности
- Отправляет фрагменты BSL-кода и вопросы во внешний сервис code.1c.ai
- Хранит платный токен доступа в переменных окружения или Docker Secrets
Коротко о README
README описывает Docker-сервер на FastMCP с 12 инструментами, сгруппированными в анализ кода и поиск документации, дает два варианта запуска через готовый образ Docker Hub или сборку из исходников, конфигурацию через переменные окружения в таблице, Docker Secrets для токена, схему архитектуры от MCP-клиента до API code.1c.ai, объяснение режимов standard и direct с конкретными upstream-именами инструментов и структуру SSE-парсера с тремя поддерживаемыми форматами ответа. В конце указаны источники идеи и алгоритмов API. Лицензия MIT.
Частые вопросы
Чем direct-режим отличается от standard?
Standard формирует текстовые промпты и полагается на выбор модели, direct вызывает конкретные upstream-инструменты 1С:Напарник по имени и дает более точные результаты, с откатом на standard при сбое.
Можно передать токен без переменной окружения в открытом виде?
Да, через ONEC_AI_TOKEN_FILE и Docker Secrets для production-окружений.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything