MCP-сервер для интеграции AI-ассистентов с 1С:Предприятие.
AI видит метаданные вашей конфигурации 1С и генерирует точный код на BSL. Работает с любым MCP-совместимым клиентом.
MCP-1C не привязан к конкретной нейросети. Работает с любым MCP-совместимым клиентом:
- Локальные модели (Ollama, LM Studio, llama.cpp) - данные не покидают вашу сеть
- Облачные сервисы (Claude, GPT, YandexGPT, GigaChat) - через соответствующие MCP-клиенты
- IDE с AI (Cursor, VS Code + Continue/Cline, JetBrains)
Ваш код и данные 1С остаются у вас. MCP-1C - это локальный процесс, который общается только с вашей базой.
Помимо бесплатной Открытой версии, доступны платные редакции с расширенными возможностями:
- Расширенная (1 990 ₽/мес) — 7 инструментов: оптимизатор запросов, линтер BSL, синтакс-помощник, мультибазовость, расширения .cfe и другие
- Профессиональная (4 990 ₽/мес) — всё из Расширенной плюс: семантический поиск, граф зависимостей, массовый анализ кода, аудит безопасности, метрики кодовой базы, помощник по обновлению типовых
При регистрации вы получаете 14 дней Профессиональной версии бесплатно.
→ Подробнее о тарифах → Документация
Tip
Бета-тест Профессиональной версии. Мы запустили Профессиональную редакцию с 6 инструментами для глубокого анализа кодовой базы: семантический поиск, граф зависимостей, массовый анализ, аудит безопасности, метрики качества и помощник по обновлению типовых.
Зарегистрируйтесь и получите 14 дней бесплатно. Активным бета-тестерам, которые делятся полезной обратной связью и хотят продолжить тестирование, продлеваем пробный период. Топ-5 бета-тестеров получат бесплатную подписку навсегда на Профессиональную версию.
→ Зарегистрироваться | Документация Pro | Сообщить о проблеме
| Открытая | Расширенная | Профессиональная | |
|---|---|---|---|
| Инструменты | 9 | 7 | 7 + bulk_analyze |
| Цена | Бесплатно | 1 990 ₽/мес | 4 990 ₽/мес |
| Пробный период | — | — | 14 дней |
| Лицензия | MIT | Подписка | Подписка |
Расширенная добавляет:
- Оптимизатор запросов (15 антипаттернов)
- Линтер BSL (30+ диагностик)
- Синтакс-помощник (10 000+ определений)
- Мультибазовость и расширения .cfe
- Песочница кода, генератор запросов и печатных форм
- Конвертер модальных вызовов в асинхронные
- Умный контекст и автообновление данных
Профессиональная добавляет:
- Семантический поиск по коду (LSA + Randomized SVD)
- Граф зависимостей модулей (10 типов связей, SQLite)
- Массовый анализ кода (антипаттерны, дубли, мёртвый код)
- Аудит безопасности BSL (11 правил SEC)
- Метрики кодовой базы (LOC, сложность, техдолг 0-100)
- Помощник по обновлению типовых (3-way diff)
- CI/CD интеграция (--ci, --json, quality gates)
- HTML/PDF отчёты
- Один бинарник, ноль зависимостей. Написан на Go — не нужен Python, Node.js, JVM или EDT. Скачал, запустил, работает.
- 9 инструментов для работы с живой базой. Метаданные, информация о конфигурации, формы, запросы к данным (с параметрами), поиск по коду, валидация, журнал регистрации, справка BSL.
- Полнотекстовый поиск по коду (
search_code). Три режима: smart (BM25-ранжирование), regex, exact. Встроенные BSL-синонимы — поиск поStrFindнаходитСтрНайтии наоборот. - Шардированная индексация. Параллельная сборка индекса по числу ядер. ~7 сек для 13 000+ модулей. Дисковый кеш — повторный запуск мгновенный.
- Неблокирующий старт. Индекс строится в фоне, MCP-сервер доступен сразу. Поиск заработает после завершения индексации.
- Работает с вашей базой. AI видит реальную конфигурацию и реальные данные — не абстрактную справку, а именно вашу базу.
- Не привязан к IDE и нейросети. Работает с Конфигуратором, EDT, или вообще без IDE. Работает с любой моделью, включая локальные (Ollama, LM Studio). Нужен только HTTP-сервис 1С.
- Автоустановка.
mcp-1c --install "C:\путь\к\базе"— сам найдёт платформу, поставит расширение, обновит конфигурацию БД. - Встроенная справка BSL. Синтаксис функций платформы доступен без внешних сервисов и без запущенной 1С.
Впервые слышите про MCP? Читайте пошаговую инструкцию — там всё с нуля, включая объяснение что такое MCP.
Бинарник для вашей ОС — в Releases. Или: go build -o mcp-1c ./cmd/mcp-1c/
# Windows
mcp-1c --install "C:\путь\к\базе"
# macOS / Linux
mcp-1c --install ~/Documents/InfoBase
# Клиент-серверная база (MS SQL, PostgreSQL)
mcp-1c --install "srv-1c\buh_prod" --server --db-user Admin --db-password passЕсли платформа установлена в нестандартную папку:
mcp-1c --install "путь" --platform "/custom/path/to/1cv8"Если версия платформы не определяется автоматически (нестандартный путь без номера версии), укажите её явно:
mcp-1c --install "путь" --platform "/custom/path/to/1cv8" --platform-version 8.3.13
Рекомендуемый способ — стандартная публикация через Apache или IIS (Конфигуратор → Администрирование → Публикация на веб-сервере). Работает на Windows и Linux. Подробности — в пошаговой инструкции.
Быстрый запуск для разработки (только Windows):
"C:\Program Files\1cv8\8.3.XX.XXXX\bin\1cv8.exe" ENTERPRISE /F "C:\путь\к\базе" /HTTPPort 8080Параметр
/HTTPPort— недокументированный, работает только на Windows и подходит для быстрой проверки. На Linux используйте Apache или ibsrv, на macOS HTTP-сервисы 1С не поддерживаются.
Конфигурация MCP-сервера одинакова для любого клиента и любой модели. Не важно, используете вы Claude, Ollama или LM Studio, настройка MCP-1C не меняется:
{
"mcpServers": {
"1c": {
"command": "/path/to/mcp-1c",
"args": ["--base", "http://localhost:8080/hs/mcp-1c"]
}
}
}На Windows пути с обратными слешами:
"command": "C:\\путь\\к\\mcp-1c.exe"
Перезапустите AI-клиент. В Claude Desktop рекомендуем: «+» → Connectors → Tool access → Always available.
Также поддерживаются: Claude Code, Cursor, Windsurf, VS Code + Copilot, VS Code + Continue, JetBrains IDE, а также любые клиенты для локальных моделей с поддержкой MCP. Настройка каждого — в пошаговой инструкции.
Спросите: «Покажи структуру конфигурации моей базы 1С»
| Инструмент | Описание |
|---|---|
get_metadata_tree |
Дерево метаданных: справочники, документы, регистры, общие модули и др. |
get_object_structure |
Реквизиты, табличные части, измерения и ресурсы конкретного объекта |
get_form_structure |
Структура основной формы: элементы, команды, обработчики событий |
get_configuration_info |
Имя конфигурации, версия, поставщик, версия платформы, режим работы |
search_code |
Полнотекстовый поиск по коду модулей: smart (BM25), regex, exact. BSL-синонимы (рус↔англ). Фильтрация по типу метаданных и модуля |
bsl_syntax_help |
Справка по 180 встроенным функциям, методам типов и паттернам BSL |
execute_query |
Выполнить запрос на языке запросов 1С с параметрами (только SELECT/ВЫБРАТЬ) |
validate_query |
Проверить синтаксис запроса без выполнения |
get_event_log |
Чтение журнала регистрации с фильтрацией по дате, уровню и пользователю |
| Флаг | Env var | По умолчанию | Описание |
|---|---|---|---|
--base |
MCP_1C_BASE_URL |
http://localhost:8080/hs/mcp-1c |
URL HTTP-сервиса 1С |
--user |
MCP_1C_USER |
— | Пользователь HTTP-сервиса |
--password |
MCP_1C_PASSWORD |
— | Пароль HTTP-сервиса |
--dump |
— | — | Путь к выгрузке конфигурации (DumpConfigToFiles), включает инструмент search_code |
--reindex |
— | — | Принудительная перестройка поискового индекса (игнорирует кеш) |
--install |
— | — | Установить расширение в базу 1С по указанному пути |
--server |
— | — | Режим клиент-серверной базы: --install принимает строку подключения сервер\база (например srv-1c\buh_prod) |
--platform |
— | — | Путь к бинарнику 1С (автоопределение, если не указан) |
--platform-version |
— | — | Версия платформы 1С (например 8.3.13). Определяется автоматически из пути к платформе. Укажите вручную, если платформа установлена в нестандартный путь без информации о версии. Минимальная поддерживаемая версия: 8.3.10 |
--db-user |
— | — | Пользователь базы 1С для DESIGNER (режим --install) |
--db-password |
— | — | Пароль базы 1С для DESIGNER (режим --install) |
go build -o mcp-1c ./cmd/mcp-1c # сборка
go test ./... -v -race # тесты
go run ./cmd/mock-1c -port 9191 # mock-сервер 1СИсходники расширения хранятся в extension/src/ в формате XML-выгрузки конфигурации. При --install они встроены в бинарник через go:embed и загружаются напрямую через DESIGNER /LoadConfigFromFiles. Готовый .cfe файл для сборки не требуется.
Для ручной установки без CLI можно собрать .cfe из исходников:
# macOS / Linux (требуется установленная платформа 1С)
./scripts/build-extension.sh ~/Documents/InfoBase
# Windows
scripts\build-extension.cmd C:\Users\User\Documents\InfoBase| AI-клиенты | |
|---|---|
| Локальные модели | Ollama, LM Studio, llama.cpp и любые MCP-совместимые клиенты |
| Облачные сервисы | Claude Desktop, Claude Code, GPT (через MCP-клиент), YandexGPT, GigaChat |
| IDE | Cursor, VS Code (Continue, Cline, Copilot), Windsurf, JetBrains IDEs |
MCP-1C не знает и не определяет, какая модель работает на стороне клиента. Конфигурация одна и та же.
| Платформа 1С | Статус |
|---|---|
| 8.3.10 и выше (коммерческая) | Поддерживается |
| 8.5.x (коммерческая) | Поддерживается |
| 8.3.10+ / 8.5.x (учебная) | Поддерживается |
Минимальная поддерживаемая версия платформы: 8.3.10
| ОС | MCP-сервер | Автоустановка | HTTP-сервис 1С |
|---|---|---|---|
| Windows | да | да | да (Apache/IIS — рекомендуется, /HTTPPort — для быстрого запуска) |
| macOS | да | да | нет (ограничение платформы 1С), используйте Windows-VM |
| Linux | да | да | да (Apache или ibsrv; /HTTPPort недоступен) |
MIT