MCP-сервер к API 1С:Напарник
1C AI MCP
Docker-сервер на FastMCP с 12 инструментами анализа BSL-кода и поиска по документации через API 1С:Напарник (code.1c.ai)
- 9 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Отправляет фрагменты 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, рекомендуемый способ.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Отправляет фрагменты BSL-кода и вопросы во внешний сервис code.1c.ai
- Хранит токен доступа в переменных окружения или Docker Secrets
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер оборачивает 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
Пример запроса к агенту
Проверь этот код обработки проведения на соответствие стандартам ИТС и предложи улучшения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 или ЗУП.
Ограничения
Нужен токен 1С:Напарник: по данным code.1c.ai, ключ бесплатен до 1 февраля 2027 года. Проект основан на идее закрытого сейчас репозитория comol/1c-code-checker с исправлениями API, заимствованными из SteelMorgan/spring-mcp-1c-copilot, то есть это независимая community-обертка, а не сервер вендора. Режим direct зависит от конкретных названий upstream-инструментов 1С:Напарник и может потребовать обновления при их изменении на стороне сервиса.
Как отключить. Остановите контейнер командой docker compose down или docker stop 1c-ai-mcp и удалите сервер из настроек MCP-клиента.
Частые вопросы
Чем direct-режим отличается от standard?
Standard формирует текстовые промпты и полагается на выбор модели, direct вызывает конкретные upstream-инструменты 1С:Напарник по имени и дает более точные результаты, с откатом на standard при сбое.
Можно передать токен без переменной окружения в открытом виде?
Да, через ONEC_AI_TOKEN_FILE и Docker Secrets для production-окружений.
Чем MCP-сервер к API 1С:Напарник отличается от самого 1С:Напарника?
Docker-сервер на FastMCP оборачивает API нейросети 1С:Напарник (code.1c.ai) в 12 MCP-инструментов: проверка BSL-кода по синтаксису, логике и производительности, code review по стандартам ИТС, переписывание кода, поиск по документации.
Чем direct-режим отличается от standard и как передать токен?
Токен передается переменной окружения ONEC_AI_TOKEN при запуске контейнера, как в команде из блока установки. Различия режимов direct и standard описаны в README проекта. Подключается к Cursor и Claude Code.
Обсуждение
Вопросов и отзывов пока нет.
MCP-прокси к 1С:Напарнику
1c-ai-mcp
MCP-сервер, который пробрасывает вопросы, проверку и объяснение BSL-кода в облачный AI-ассистент 1С:Напарник
MCP-мост к 1С:Напарник на Go
1c-copilot-mcp
Go-бинарник с 5 MCP-инструментами к нейросети 1С:Напарник, который читает код 1С прямо из файла по пути, а не через контекст модели
MCP-сервер для 1С:Напарник
Spring Boot MCP Server для 1С:Напарник
MCP-сервер на Spring Boot и Kotlin, который подключает агента к API 1С:Напарник для вопросов и проверки кода 1С
1C-ai-mcp: MCP-мост к 1С:Напарнику
1C-ai-mcp
MCP-сервер, который открывает облачного ассистента 1С:Напарник (1C.ai) и локальный BSL Language Server агентам в Cursor и других IDE
MCP стандартов разработки 1С
MCP-сервер стандартов разработки 1С:Предприятие 8
MCP-сервер с официальными стандартами и методиками разработки 1С:Предприятие 8 для поиска и проверки кода агентом
1C MCP Suite: набор серверов для конфигурации 1С
1C MCP Suite
Пять независимых MCP-серверов на Docker: граф метаданных и вызовов в Neo4j, анализ BSL, справка платформы, конструктор запросов и стандарты
Коротко о README
README описывает Docker-сервер на FastMCP с 12 инструментами, сгруппированными в анализ кода и поиск документации, дает два варианта запуска через готовый образ Docker Hub или сборку из исходников, конфигурацию через переменные окружения в таблице, Docker Secrets для токена, схему архитектуры от MCP-клиента до API code.1c.ai, объяснение режимов standard и direct с конкретными upstream-именами инструментов и структуру SSE-парсера с тремя поддерживаемыми форматами ответа. В конце указаны источники идеи и алгоритмов API. Лицензия MIT.