MCP-прокси к 1С:Напарнику
1c-ai-mcp
MCP-сервер, который пробрасывает вопросы, проверку и объяснение BSL-кода в облачный AI-ассистент 1С:Напарник
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Отправляет исходный код и вопросы во внешний облачный сервис code.1c.ai
- Токен доступа передается в конфигурации агента как аргумент командной строки
Установка
Ручная установка
{
"mcpServers": {
"1c-ai-mcp": {
"command": "node",
"args": ["/путь/к/1c-ai-mcp.js", "--mcp", "--token=<ваш-токен>"],
"env": { "AI_PROJECT_ROOT": "/путь/к/проекту" }
}
}
}Фрагмент .mcp.json из README.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер работает прокси к облачному сервису code.1c.ai, известному как 1С:Напарник, и отдает агенту пять инструментов: задать вопрос по разработке 1С, проверить код на ошибки и проблемы производительности, исправить найденные ошибки, объяснить назначение и логику кода и получить продолжение ответа, если вызов не уложился в 30 секунд. Прокси запускается как обычный MCP-сервер по stdio командой node с параметром --mcp и токеном доступа к code.1c.ai, доступным файлам модели можно ограничить корень проекта переменной AI_PROJECT_ROOT.
Для кого. Для 1С-разработчиков с доступом к code.1c.ai, которые хотят вызывать 1С:Напарника из любого MCP-совместимого агента, а не только из фирменного клиента.
Подходит, если
- Нужно задать вопрос по разработке 1С прямо из Claude Code, opencode или другого MCP-клиента
- Нужна проверка BSL-кода на ошибки и проблемы производительности перед ревью
- Нужно объяснение чужого или старого BSL-кода
Не подходит, если
- Нет токена доступа к code.1c.ai
- Нужна работа с живой базой 1С: инструменты не читают и не меняют информационную базу, только код и вопросы
Пример запроса к агенту
Проверь этот модуль на ошибки и объясни, что делает функция РассчитатьСкидкуОграничения
Нужен собственный платный или пробный токен code.1c.ai, сам проект его не выдает. Требует Node.js 22+. Вызов инструмента ограничен 30 секундами, для более долгих ответов нужен отдельный вызов GetResult. Проект одного автора без описанной политики поддержки.
Как отключить. Удалите запись 1c-ai-mcp из .mcp.json или конфигурации MCP вашего агента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| AI_TOKEN обязательная, секрет | Токен доступа к code.1c.ai, альтернатива параметру --token. |
| AI_PROJECT_ROOT | Корень проекта, определяет какие файлы доступны модели. |
| AI_FULL_LOG | Включает трассировку запросов и ответов. |
| AI_SESSION_FILE | Путь к файлу кэша сессии. |
| AI_TRACE_LOG | Путь к файлу трассировки при включенном AI_FULL_LOG. |
Проверка безопасности
- Отправляет исходный код и вопросы во внешний облачный сервис code.1c.ai
- Токен доступа передается в конфигурации агента как аргумент командной строки
Коротко о README
README перечисляет пять инструментов прокси, требования (Node.js 22+, токен code.1c.ai), два способа установки: скачать zip из релизов или собрать из исходников. Даны параметры командной строки и переменные окружения с таблицей обязательности и значений по умолчанию, а также готовые фрагменты конфигурации для opencode и Claude Code. Лицензия MIT.
Частые вопросы
Где взять токен?
Токен выдает сервис code.1c.ai (1С:Напарник), проект 1c-ai-mcp только пробрасывает к нему запросы и токенов не выдает.
Что делать, если ответ не уложился в 30 секунд?
Вызвать инструмент GetResult, он возвращает продолжение того же ответа.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything