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.

Настройка клиентов

cursor
{
    "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.

claude_desktop_config.json
{
  "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С, без доступа к базе.

Риск: medium Лицензия: MIT ★ 209

Apify MCP Server

Извлечение данных с любых сайтов с помощью тысяч скраперов и автоматизаций из Apify Store.

Риск: high Лицензия: MIT ★ 15 755

Источники