1C MCP Toolkit от ROCTUP: обработка .epf для связи 1С с Claude и Cursor

ROCTUP/1c-mcp-toolkit· Проверено 12.11.2026· 359на GitHub

Внешняя обработка .epf, которая подключает агента к базе 1С:Предприятие: запросы, код 1С, метаданные, журнал регистрации, права доступа. Конфигурацию менять и базу публиковать не нужно.

Встроенный HTTP-сервер прямо в обработке, без Python; для нескольких баз есть режим прокси на Python или в Docker; лицензия GPL-3.0.

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

Что сделать до подключения

1

1С:Предприятие 8.2.13+ или 8.3.25

2

Обработка build/MCP_Toolkit.epf из репозитория: откройте её в 1С, выберите режим «Встроенный сервер» и нажмите «Запустить сервер»

3

Для режима прокси — сервер из образа roctup/1c-mcp-toolkit-proxy или из исходников на Python, в обработке адрес http://localhost:6003 и кнопка «Подключиться»

4

На macOS встроенный сервер работает после сборки нативных компонент как universal (x86_64 + arm64)

5
Токен доступа

необязателен: впишите в поле «Токен доступа» на форме обработки или нажмите «Сгенерировать», затем добавьте в клиенте заголовок Authorization: Bearer <токен>; работает только во встроенном сервере

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http 1c_mcp_toolkit http://127.0.0.1:6003/mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

execute_queryвыполняет запрос 1С
execute_codeвыполняет произвольный код 1С
get_metadataпоказывает структуру метаданных
get_event_logчитает журнал регистрации
get_object_by_linkоткрывает объект по навигационной ссылке
get_link_of_objectсоздаёт навигационную ссылку
find_references_to_objectищет ссылки на объект
get_access_rightsпоказывает права ролей на объект
get_bsl_syntax_helpищет в справке BSL
get_screenshotснимает окно 1С (Windows)
restart_1c_sessionперезапускает сеанс 1С
close_1c_sessionзакрывает сеанс 1С
submit_for_deanonymizationвозвращает реальные значения вместо токенов

Что попросить агента

«Сколько элементов в справочнике <Номенклатура>?»Агент составит запрос с КОЛИЧЕСТВО(*) и выполнит его через execute_query
«Покажи реквизиты и табличные части документа <РеализацияТоваровУслуг>»Агент вызовет get_metadata с filter по полному имени объекта
«Найди ошибки в журнале регистрации за <дата> у пользователя <имя>»Агент вызовет get_event_log с фильтрами по периоду, уровню Error и пользователю
«Где используется контрагент <наименование>?»Агент найдёт объект через execute_query и передаст его в find_references_to_object с областями поиска по документам и регистрам
«Какие права у пользователя <Иванов> на справочник <Номенклатура>?»Агент вызовет get_access_rights с metadata_object и user_name

Для каких задач

Составить и выполнить запрос на языке запросов 1С и разобрать результат
Выполнить фрагмент кода 1С на сервере или на клиенте
Найти ошибки в журнале регистрации с фильтром по пользователю, периоду и типу события
Найти все документы и записи регистров, которые ссылаются на объект
Проверить, какие роли и пользователи имеют права на объект метаданных
Скрыть персональные данные от облачной модели токенами вида [ORG-00001]

Ограничения

!

По умолчанию встроенный сервер работает без аутентификации, а execute_code выполняет произвольный код 1С; опасные операции режет чёрный список, автоподтверждение включайте только для безопасных инструментов

!

В execute_code нельзя объявлять процедуры и функции и писать Возврат: результат присваивается переменной Результат

!

get_screenshot работает только на Windows

!

Запуск на сервере 1С без открытого клиента и параллельное выполнение команд доступны только в клиент-серверной базе

Если не работает

Инструменты отвечают «1C client not connected»
Обработка не подключена к серверу: откройте MCP_Toolkit.epf и запустите встроенный сервер или нажмите «Подключиться» в режиме прокси.
Ответ «Timeout waiting for 1C response»
1С не ответила за время ожидания; в режиме прокси его задаёт переменная TIMEOUT, по умолчанию 180 секунд.
Ответ «Operation not allowed: <ключевое слово>»
Код попал под чёрный список опасных операций. Включите ALLOW_DANGEROUS_WITH_APPROVAL=true, чтобы подтверждать такие операции в диалоге 1С, или поправьте DANGEROUS_KEYWORDS.
Запросы к /mcp получают 401 Unauthorized
На форме обработки задан токен доступа: передайте его в клиенте заголовком Authorization: Bearer <токен>.
Claude Desktop не подключается по адресу с url
Его конфиг понимает только command и args. Подключите сервер через npx mcp-remote с флагами --allow-http и --transport http-only; Custom Connector с localhost не работает.

Частые вопросы

Чем встроенный сервер отличается от прокси?
Во встроенном сервере HTTP-сервер поднимается в самой обработке через компоненту MCPHttpTransport, Python не нужен, доступ закрывается токеном. В прокси обработка забирает команды у Python-сервера по long polling, базы разделяются ID каналов, анонимизация настраивается переменными окружения.
Можно ли держать сервер без открытого клиента 1С?
Да, обработку можно запустить фоновым заданием на сервере 1С вручную или по расписанию. Нужна клиент-серверная база и конфигурация с БСП, где включены «Дополнительные отчёты и обработки», и обработка зарегистрирована в этом механизме.
Какие операции считаются опасными?
Код и запросы с ключевыми словами из списка DANGEROUS_KEYWORDS: Удалить, Записать, УстановитьПривилегированныйРежим, COMОбъект, УдалитьФайлы и другие. По умолчанию они блокируются; с ALLOW_DANGEROUS_WITH_APPROVAL=true в 1С появляется диалог подтверждения.
Как подключить к одному прокси несколько баз?
Укажите в адресе параметр канала, например http://localhost:6003/mcp?channel=dev-environment, и тот же ID канала в настройках обработки нужной базы. Команды разных каналов не смешиваются.
Можно ли сократить ответы для модели?
Прокси по умолчанию отдаёт результаты в формате TOON, он экономит 30–60% токенов. Для совместимости переменная RESPONSE_FORMAT=json включает обычный JSON.
Где скачать 1C MCP Toolkit?
Готовая обработка лежит в репозитории ROCTUP/1c-mcp-toolkit, файл build/MCP_Toolkit.epf. Для режима прокси есть образ roctup/1c-mcp-toolkit-proxy на Docker Hub.
Как подключить 1C MCP Toolkit к Claude Desktop?
Файл claude_desktop_config.json принимает только stdio, поэтому адрес подключается через мост mcp-remote: npx -y mcp-remote http://127.0.0.1:6003/mcp --allow-http --transport http-only. Нужен Node.js, адрес лучше писать через 127.0.0.1.
Есть ли у 1C MCP Toolkit REST API?
Да, те же инструменты доступны по адресу http://localhost:6003/api/ для агентов без поддержки MCP. В папке skills/ лежат навыки calling-1c-rest-api-via-curl и composing-1c-queries.
Работает ли сервер из России?
Обработка работает внутри вашей 1С и слушает порт на компьютере с базой, зарубежные аккаунты не нужны.

Похожие серверы