
1C MCP Toolkit от ROCTUP: обработка .epf для связи 1С с Claude и Cursor
Внешняя обработка .epf, которая подключает агента к базе 1С:Предприятие: запросы, код 1С, метаданные, журнал регистрации, права доступа. Конфигурацию менять и базу публиковать не нужно.
Встроенный HTTP-сервер прямо в обработке, без Python; для нескольких баз есть режим прокси на Python или в Docker; лицензия GPL-3.0.
Как подключить
Что сделать до подключения
1С:Предприятие 8.2.13+ или 8.3.25
Обработка build/MCP_Toolkit.epf из репозитория: откройте её в 1С, выберите режим «Встроенный сервер» и нажмите «Запустить сервер»
Для режима прокси — сервер из образа roctup/1c-mcp-toolkit-proxy или из исходников на Python, в обработке адрес http://localhost:6003 и кнопка «Подключиться»
На macOS встроенный сервер работает после сборки нативных компонент как universal (x86_64 + arm64)
Токен доступанеобязателен: впишите в поле «Токен доступа» на форме обработки или нажмите «Сгенерировать», затем добавьте в клиенте заголовок 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.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.1c_mcp_toolkit]
url = "http://127.0.0.1:6003/mcp"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"1c_mcp_toolkit": {
"url": "http://127.0.0.1:6003/mcp"
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"1c_mcp_toolkit": {
"type": "http",
"url": "http://127.0.0.1:6003/mcp"
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"1c_mcp_toolkit": {
"httpUrl": "http://127.0.0.1:6003/mcp"
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"1c_mcp_toolkit": {
"httpUrl": "http://127.0.0.1:6003/mcp"
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"1c_mcp_toolkit": {
"type": "remote",
"url": "http://127.0.0.1:6003/mcp"
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://127.0.0.1:6003/mcpПроверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"1c_mcp_toolkit": {
"url": "http://127.0.0.1:6003/mcp"
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
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ищет в справке BSLget_screenshotснимает окно 1С (Windows)restart_1c_sessionперезапускает сеанс 1Сclose_1c_sessionзакрывает сеанс 1Сsubmit_for_deanonymizationвозвращает реальные значения вместо токеновЧто попросить агента
Для каких задач
Ограничения
По умолчанию встроенный сервер работает без аутентификации, а execute_code выполняет произвольный код 1С; опасные операции режет чёрный список, автоподтверждение включайте только для безопасных инструментов
В execute_code нельзя объявлять процедуры и функции и писать Возврат: результат присваивается переменной Результат
get_screenshot работает только на Windows
Запуск на сервере 1С без открытого клиента и параллельное выполнение команд доступны только в клиент-серверной базе