1C MCP Toolkit
1C MCP Toolkit — сервер сообщества для подключения ИИ-ассистента к базе 1С:Предприятия через внешнюю обработку, без изменения конфигурации. Он выполняет запросы, показывает метаданные и журнал регистрации, а также умеет выполнять произвольный код 1С.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- ROCTUP
- Лицензия
- GPL-3.0
- Транспорт
- streamable_http
- Авторизация
- token_env
- ОС
- windows, macos, linux
- Языки
- 1c, python
Уровень риска: high
execute_code выполняет произвольный код 1С и может изменить или удалить данные. Данные запросов уходят в подключённую модель. Встроенный сервер по умолчанию без авторизации на порту 6003. Используйте копию базы, пользователя с минимальными правами, токен доступа и подтверждение каждого execute_code.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"onec-mcp-toolkit\": {\n \"url\": \"http://127.0.0.1:6003/mcp\"\n }\n }\n}",
"file": ".cursor/mcp.json",
"lang": "json",
"notes": "Собрано по формату Cursor",
"verified": "docs"
}
Что умеет
1C MCP Toolkit — проект сообщества, который подключает ИИ-ассистента к базе 1С:Предприятия через MCP и REST API. Он работает как внешняя обработка, поэтому конфигурацию базы менять не нужно.
- Выполняет запросы на языке запросов 1С и показывает структуру метаданных базы.
- Находит объект по навигационной ссылке и все ссылки на объект, показывает права доступа к объектам.
- Читает журнал регистрации.
- Даёт справку по встроенному языку: функции, методы, типы и конструкции.
- Умеет выполнять произвольный код 1С. Это самый мощный и самый опасный инструмент, его стоит включать только осознанно.
- Делает снимок активного окна 1С (только Windows).
Кому подойдёт
- Программисту и консультанту 1С, которому нужно, чтобы ассистент видел данные и структуру конкретной базы.
- Тем, кто не может менять конфигурацию: обработка подключается без изменения конфигурации, без публикации сервера 1С и без COM-соединения.
- Тем, у кого старые релизы: по README поддерживаются платформы 8.2.13+ и 8.3.25.
Не подойдёт, если нужен сервер, который в принципе не может изменить данные: здесь есть выполнение произвольного кода.
Установка
Самый простой вариант — встроенный сервер, Python для него не нужен. Скачайте обработку MCP_Toolkit.epf со страницы релизов, откройте её в 1С, выберите режим «Встроенный сервер» и нажмите «Запустить сервер». Сервер будет доступен по адресу http://IP-компьютера-с-1С:6003/mcp.
Второй вариант — прокси-режим в Docker: прокси работает отдельно, а обработка в 1С подключается к нему.
docker run -d -p 6003:6003 -e ALLOW_DANGEROUS_WITH_APPROVAL=true --restart unless-stopped --name 1c-mcp-toolkit-proxy roctup/1c-mcp-toolkit-proxyПосле запуска прокси откройте обработку в 1С, укажите адрес http://localhost:6003 и нажмите «Подключиться».
Подключение к клиентам
Конфиг для Claude Desktop взят из README проекта: этот клиент поддерживает только stdio, поэтому подключение идёт через мост mcp-remote (нужен Node.js). Конфиги для Cursor и Claude Code собраны по формату их документации. Общий порядок — в инструкции как подключить MCP.
{
"mcpServers": {
"onec-mcp-toolkit-proxy": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"http://127.0.0.1:6003/mcp",
"--allow-http",
"--transport",
"http-only"
]
}
}
}Используйте 127.0.0.1, а не localhost. Если включён токен, добавьте в args параметр --header с заголовком авторизации.
Проверка
Запустите сервер в обработке и перезапустите клиент. Попросите ассистента показать список документов в базе: он должен вызвать get_metadata. В Claude Code статус покажет claude mcp list.
Частые ошибки: обработка не запущена или порт 6003 занят, в Claude Desktop указан адрес с url вместо моста mcp-remote, включён токен, но клиент его не передаёт.
Инструменты
| Инструмент | Что делает | Доступ |
|---|---|---|
execute_query |
Запрос на языке запросов 1С | чтение |
execute_code |
Произвольный код 1С | запись |
get_metadata |
Структура метаданных базы | чтение |
get_event_log |
Журнал регистрации | чтение |
get_object_by_link |
Объект по навигационной ссылке | чтение |
find_references_to_object |
Все ссылки на объект | чтение |
get_access_rights |
Права доступа к объектам | чтение |
get_bsl_syntax_help |
Справка по встроенному языку | чтение |
get_screenshot |
Снимок окна 1С, только Windows | чтение |
Примеры задач
Покажи, какие реквизиты есть у справочника Номенклатура.Найди все документы, которые ссылаются на этого контрагента: <навигационная ссылка>Какие права есть у роли Менеджер на документ ЗаказКлиента?Риски
Инструмент execute_code выполняет произвольный код 1С с правами пользователя сеанса: код может изменить или удалить данные. Запросы и журнал регистрации отдают данные базы модели, к которой подключён клиент. Встроенный сервер по умолчанию открыт без авторизации на порту 6003.
Как снизить риски: подключайте к копии базы или под пользователем с минимальными правами, включите токен доступа, не открывайте порт в сеть, подтверждайте каждый вызов execute_code. Переменная ALLOW_DANGEROUS_WITH_APPROVAL в прокси-режиме связана с подтверждением опасных операций — проверьте её значение по полной документации проекта. Лицензия проекта — GPL-3.0.
Частые вопросы
Нужно ли менять конфигурацию базы?
Нет. Toolkit работает как внешняя обработка, без изменения конфигурации и без публикации сервера 1С.
Нужен ли Python?
Для встроенного сервера нет. Python или Docker нужен только для прокси-режима.
Почему Claude Desktop не подключается по адресу сервера?
Claude Desktop в конфиге поддерживает только stdio. Для HTTP-сервера используйте мост mcp-remote, как в конфиге выше.
Сравнение серверов для 1С — на странице MCP для 1С, категория — бизнес и 1С. Основы протокола — на странице что такое MCP-сервер.
Инструменты
- execute_query
- execute_code
- get_metadata
- get_event_log
- get_object_by_link
- find_references_to_object
- get_access_rights
- get_bsl_syntax_help
- get_screenshot
Похожие MCP-серверы
MCP BSL Platform Context
MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.
Spree Commerce: открытая платформа электронной коммерции для B2B и маркетплейсов
Открытая платформа электронной коммерции Spree для B2B и маркетплейсов.
Spree Commerce: документация для ИИ-агентов
Документация Spree Commerce для агентов-программистов.
Apify MCP Server
Извлечение данных с любых сайтов с помощью тысяч скраперов и автоматизаций из Apify Store.