mcp_dev — MCP-сервер внутри 1С

Что получает ИИ-агент

Готовый набор инструментов для задач 1С-разработчика. Работает с Claude, Cursor и любыми другими клиентами, поддерживающими MCP.

🗂️

Метаданные конфигурации

Список объектов и подробная структура: реквизиты, табличные части, движения документов, подсистемы.

list_metadata_objects · get_metadata_structure

🔍

Запросы к данным

Агент проверяет синтаксис запроса и выполняет его, получая реальные данные базы.

validate_query · execute_query

⚙️

Выполнение кода

Выполнение произвольного кода на встроенном языке — агент может сам проверять гипотезы.

execute_code

📋

Журнал регистрации

Отбор и чтение событий журнала — для расследования ошибок и анализа поведения базы.

eventlog_query · eventlog_filter_values

💾

Хранилища настроек

Чтение и запись хранилищ общих и пользовательских настроек.

storage_reader · set_storage_value

🗄️

Таблицы СУБД отключено по умолчанию

Соответствие объектов метаданных таблицам и полям СУБД — для анализа структуры хранения базы.

db_tables · db_table_fields

⚠️ О безопасности

Инструменты дают агенту реальный доступ к базе — используйте их осознанно:

Данные уходят в облако. Если агент работает с облачной моделью (Claude, ChatGPT и другими), результаты запросов и прочитанные данные отправляются на серверы вендора модели. Не подключайте к базам с данными, которые нельзя передавать наружу, — или используйте локальные модели.
Выполнение произвольного кода (execute_code) при неосторожности может изменить или повредить данные. Работайте на копии базы и ограничивайте права пользователя, под которым подключается агент.

Как подключить

Есть два пути: классический — опубликовать HTTP-сервис на веб-сервере, и новый — совсем без веб-сервера.

Классический: публикация HTTP-сервиса

HTTP-сервис расширения публикуется на веб-сервере — агент обращается к базе напрямую. Для транспорта stdio и аутентификации OAuth2 (без отключения аутентификации 1С) используется Python-прокси из проекта 1c_mcp.

Без веб-сервера: режим поллинга Новое Экспериментально

Публикация на веб-сервере не нужна. Запросы доставляет в 1С форма «Управление MCP-сервером», запущенная в обычном клиентском сеансе. Три способа обмена:

Локальная или сетевая папка — файловый обмен;
Папка на FTP-сервере;
Обратный HTTP (httppoll) — клиент 1С сам опрашивает прокси, достаточно проброса одного TCP-порта.

Все три варианта работают через прокси проекта 1c_mcp. Режим предназначен для разработки и тестирования.

Открытый проект 1c_mcp

mcp_dev — сборка с расширенным набором инструментов разработчика на движке открытого проекта 1c_mcp.

vladimir-kharin/1c_mcp

Расширение-движок и Python-прокси, лицензия MIT. Инструкции по установке и настройке, примеры конфигураций для разных ИИ-клиентов, руководство по разработке собственных инструментов — данные и функциональность вашей конфигурации можно отдавать агенту через свои обработки.

github.com/vladimir-kharin/1c_mcp →

`mcp_dev` — доступ ИИ-агента в вашу базу 1С