1С MCP

vladimir-kharin/1c_mcp· Проверено 12.11.2026· 573на GitHub

Показывает агенту метаданные и содержимое базы 1С:Предприятие: справочники, документы, регистры, запросы и журнал регистрации. Четыре проекта: конструктор, обработка .epf, бинарник и плагин для 1C:EDT.

4 реализации:

Конструктор: расширение .cfe берёт на себя протокол MCP, а свои инструменты вы пишете на языке 1С; из коробки только метаданные; лицензия MIT.

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

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

Платформа 1С 8.3.20 или новее

Расширение build/MCP_Сервер.cfe из репозитория, подключённое к конфигурации

База, опубликованная на веб-сервере с HTTP-сервисом mcp_APIBackend

Для клиентов, которым нужен stdio, и для входа через OAuth2 — Python-прокси из папки src/py_server

Authorization

логин и пароль пользователя 1С в заголовке Basic; если клиент не умеет передавать заголовки, нужен Python-прокси

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

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

claude mcp add --transport http 1c http://<веб-сервер>/<имя публикации>/hs/mcp/ \
  --header 'Authorization: Basic <логин и пароль пользователя 1С>'

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

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.1c]
url = "http://<веб-сервер>/<имя публикации>/hs/mcp/"
http_headers = { "Authorization" = "Basic <логин и пароль пользователя 1С>" }

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "1c": {
      "url": "http://<веб-сервер>/<имя публикации>/hs/mcp/",
      "headers": {
        "Authorization": "Basic <логин и пароль пользователя 1С>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "1c": {
      "type": "http",
      "url": "http://<веб-сервер>/<имя публикации>/hs/mcp/",
      "headers": {
        "Authorization": "Basic <логин и пароль пользователя 1С>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "1c": {
      "httpUrl": "http://<веб-сервер>/<имя публикации>/hs/mcp/",
      "headers": {
        "Authorization": "Basic <логин и пароль пользователя 1С>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "1c": {
      "httpUrl": "http://<веб-сервер>/<имя публикации>/hs/mcp/",
      "headers": {
        "Authorization": "Basic <логин и пароль пользователя 1С>"
      }
    }
  }
}

Проверка: 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": {
        "type": "remote",
        "url": "http://<веб-сервер>/<имя публикации>/hs/mcp/",
        "headers": {
          "Authorization": "Basic <логин и пароль пользователя 1С>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://<веб-сервер>/<имя публикации>/hs/mcp/
Request headers: Authorization: Basic <логин и пароль пользователя 1С>

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "1c": {
      "url": "http://<веб-сервер>/<имя публикации>/hs/mcp/",
      "headers": {
        "Authorization": "Basic <логин и пароль пользователя 1С>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

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

list_metadata_objectsперечисляет объекты метаданных

get_metadata_structureпоказывает структуру объекта

Внешняя обработка .epf со своим HTTP-сервером: конфигурацию менять и базу публиковать не нужно; умеет выполнять произвольный код 1С; лицензия GPL-3.0.

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

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

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

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

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

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

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

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

claude mcp add --transport http mcp-1c-mcp-toolkit http://127.0.0.1:6003/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-1c-mcp-toolkit]
url = "http://127.0.0.1:6003/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-1c-mcp-toolkit": {
      "url": "http://127.0.0.1:6003/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-1c-mcp-toolkit": {
      "type": "http",
      "url": "http://127.0.0.1:6003/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-1c-mcp-toolkit": {
      "httpUrl": "http://127.0.0.1:6003/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-1c-mcp-toolkit": {
      "httpUrl": "http://127.0.0.1:6003/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-1c-mcp-toolkit": {
        "type": "remote",
        "url": "http://127.0.0.1:6003/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://127.0.0.1:6003/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-1c-mcp-toolkit": {
      "url": "http://127.0.0.1:6003/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возвращает реальные значения вместо токенов

Один бинарник на Go без зависимостей, сам ставит расширение в базу; запросы только на чтение; открытая версия под MIT, расширенные функции платные.

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

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

Платформа 1С 8.3.10 или новее

Бинарник mcp-1c для вашей ОС со страницы Releases

Расширение в базе: команда mcp-1c --install "<путь к базе>"

HTTP-сервис 1С, опубликованный через Apache или IIS

MCP_1C_USER, MCP_1C_PASSWORD

пользователь и пароль HTTP-сервиса 1С; задавайте оба сразу

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

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

claude mcp add --env 'MCP_1C_USER=<пользователь 1С>' --env 'MCP_1C_PASSWORD=<пароль>' --transport stdio mcp-1c \
  -- /path/to/mcp-1c --base http://localhost:8080/hs/mcp-1c

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-1c]
command = "/path/to/mcp-1c"
args = ["--base", "http://localhost:8080/hs/mcp-1c"]

[mcp_servers.mcp-1c.env]
MCP_1C_USER = "<пользователь 1С>"
MCP_1C_PASSWORD = "<пароль>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-1c": {
      "command": "/path/to/mcp-1c",
      "args": ["--base", "http://localhost:8080/hs/mcp-1c"],
      "env": {
        "MCP_1C_USER": "<пользователь 1С>",
        "MCP_1C_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-1c": {
      "type": "stdio",
      "command": "/path/to/mcp-1c",
      "args": ["--base", "http://localhost:8080/hs/mcp-1c"],
      "env": {
        "MCP_1C_USER": "<пользователь 1С>",
        "MCP_1C_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-1c": {
      "command": "/path/to/mcp-1c",
      "args": ["--base", "http://localhost:8080/hs/mcp-1c"],
      "env": {
        "MCP_1C_USER": "<пользователь 1С>",
        "MCP_1C_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-1c": {
      "command": "/path/to/mcp-1c",
      "args": ["--base", "http://localhost:8080/hs/mcp-1c"],
      "env": {
        "MCP_1C_USER": "<пользователь 1С>",
        "MCP_1C_PASSWORD": "<пароль>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-1c": {
        "type": "local",
        "command": ["/path/to/mcp-1c", "--base", "http://localhost:8080/hs/mcp-1c"],
        "environment": {
          "MCP_1C_USER": "<пользователь 1С>",
          "MCP_1C_PASSWORD": "<пароль>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-1c": {
      "command": "/path/to/mcp-1c",
      "args": ["--base", "http://localhost:8080/hs/mcp-1c"],
      "env": {
        "MCP_1C_USER": "<пользователь 1С>",
        "MCP_1C_PASSWORD": "<пароль>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-1c": {
      "command": "/path/to/mcp-1c",
      "args": ["--base", "http://localhost:8080/hs/mcp-1c"],
      "env": {
        "MCP_1C_USER": "<пользователь 1С>",
        "MCP_1C_PASSWORD": "<пароль>"
      }
    }
  }
}

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

get_metadata_treeстроит дерево метаданных

get_object_structureпоказывает реквизиты и табличные части

get_form_structureразбирает структуру формы

get_configuration_infoпоказывает версию конфигурации

get_storage_structureсопоставляет таблицы СУБД с объектами

count_recordsсчитает записи справочника

execute_queryвыполняет запрос на чтение

validate_queryпроверяет синтаксис запроса

get_event_logчитает журнал регистрации

search_codeищет по коду модулей

bsl_syntax_helpподсказывает синтаксис BSL

analyze_subsystemsразбирает объекты по подсистемам

Показано 12 из 19.

Плагин для 1C:EDT на 108 инструментов: код BSL, метаданные, отладка, тесты YAXUnit и git; лицензия AGPL-3.0.

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

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

1C:EDT 2026.2.2

Плагин EDT MCP Server Feature: в EDT Help → Install New Software, адрес https://ditrixnew.github.io/EDT-MCP/, затем перезапуск EDT

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

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

claude mcp add --transport http edt-mcp http://localhost:8765/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.edt-mcp]
url = "http://localhost:8765/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "edt-mcp": {
      "url": "http://localhost:8765/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "edt-mcp": {
      "type": "http",
      "url": "http://localhost:8765/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "edt-mcp": {
      "httpUrl": "http://localhost:8765/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "edt-mcp": {
      "httpUrl": "http://localhost:8765/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "edt-mcp": {
        "type": "remote",
        "url": "http://localhost:8765/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://localhost:8765/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "edt-mcp": {
      "url": "http://localhost:8765/mcp"
    }
  }
}

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

list_projectsперечисляет проекты рабочей области

get_metadata_objectsперечисляет объекты метаданных

read_module_sourceчитает текст модуля

search_in_codeищет по коду BSL

write_module_sourceзаписывает код в модуль

go_to_definitionпереходит к определению

find_referencesищет места использования

validate_queryпроверяет текст запроса

get_project_errorsчитает ошибки проверки

create_metadataсоздаёт объект метаданных

rename_metadata_objectпереименовывает объект с правкой ссылок

update_databaseобновляет конфигурацию базы

launchзапускает приложение в отладке

set_breakpointставит точку останова

get_variablesпоказывает переменные в останове

run_yaxunit_testsзапускает тесты YAXUnit

get_form_screenshotделает снимок формы

start_profilingвключает замер производительности

Показано 18 из 108.

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

«Покажи структуру справочника <Номенклатура>: реквизиты и табличные части»Найдёт объект в дереве метаданных и выведет его структуру через get_metadata_tree и get_object_structure (в 1C MCP Toolkit — get_metadata)

«Сколько документов <РеализацияТоваровУслуг> проведено за <месяц>? Напиши запрос и выполни его»Составит текст на языке запросов 1С, проверит его через validate_query и выполнит через execute_query

«Найди в журнале регистрации ошибки пользователя <имя> за вчера»Запросит записи журнала с фильтром по пользователю и дате через get_event_log

«Где в конфигурации вызывается процедура <ИмяПроцедуры>?»Поищет по модулям через search_code, в плагине для EDT — через search_in_code и find_references

«Проверь ошибки проекта <имя> в EDT и запусти тесты»Соберёт список ошибок через get_project_errors и запустит тесты YAxUnit через run_yaxunit_tests

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

Показать агенту структуру конфигурации, чтобы он писал код BSL под реальные объекты

Выполнить запрос на языке запросов 1С и разобрать результат

Найти причину ошибки по журналу регистрации

Проверить запрос до запуска и найти места вызова в коде

Пройти код отладчиком и прогнать тесты YAXUnit в 1C:EDT

Написать свои инструменты для агента на языке 1С

Ограничения

Для 1c_mcp и mcp-1c базу нужно опубликовать на веб-сервере; на macOS HTTP-сервис 1С не поднимается, mcp-1c советует виртуальную машину с Windows

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

В EDT-MCP любой подключённый клиент вызывает любой инструмент, включая удаление метаданных и обновление базы; совместимость гарантирована только с последней версией EDT

У mcp-1c чтение исходников модулей, линтер и оптимизатор запросов есть только в платных редакциях за 1 990 и 4 990 ₽ в месяц

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

При установке расширения mcp-1c пишет «1C platform not found»

Укажите путь к платформе флагом --platform; если версия не определяется из пути, добавьте --platform-version, например 8.3.13.

Запрос к /hs/mcp-1c/ возвращает 404

Проверьте в Конфигураторе, что расширение MCP_HTTPService отмечено как активное, и обновите конфигурацию базы клавишей F7.

mcp-1c пишет «connection refused»

HTTP-сервис 1С недоступен: проверьте, что Apache или IIS запущен и публикация базы активна.

mcp-1c пишет «1C returned status 302» или другой код перенаправления

Веб-сервер переадресует на https или другой порт; укажите в --base конечный адрес.

В журнале mcp-1c строка «Extension is OLDER than this build requires», часть инструментов отвечает ошибкой

Расширение старше нужной версии 0.4.10: обновите его командой установки mcp-1c --install.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
1c_mcp	Владимир Харин	573	HTTP	токен	2	3 ноября 2026
1C MCP Toolkit	ROCTUP	359	HTTP	не нужен	13	1 ноября 2026
mcp-1c	feenlace	255	локально	токен	19	20 октября 2026
EDT MCP Server	DitriXNew	333	HTTP	не нужен	108	12 ноября 2026

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

Что выбрать: mcp-1c или 1C MCP Toolkit?

mcp-1c — бинарник на Go: ставит расширение командой --install, работает через опубликованный HTTP-сервис и выполняет только запросы ВЫБРАТЬ. 1C MCP Toolkit — обработка .epf со своим HTTP-сервером на порту 6003: конфигурацию не меняет, публикация не нужна, умеет выполнять код 1С. Лицензии MIT и GPL-3.0.

Чем 1c_mcp отличается от остальных?

Это платформа для своих серверов: расширение берёт на себя протокол, а инструменты вы дописываете обработками на 1С. Из коробки есть только list_metadata_objects и get_metadata_structure. Готовый мультитул на этой основе автор распространяет отдельно.

Когда нужен EDT-MCP?

Когда вы разрабатываете в 1C:EDT. Плагин даёт агенту 108 инструментов: чтение и запись кода BSL, правку метаданных, отладку, тесты YAXUnit, профилирование и git. Git по умолчанию выключен.

Можно ли скрыть персональную информацию от облачной модели?

В 1C MCP Toolkit есть анонимизация: значения заменяются токенами вида [ORG-00001] и [INN-00001], а сервер подставляет реальные обратно. В 1c_mcp есть подсистема обезличивания, при включении она скрывает инструменты, которые не умеют обезличивать.

Какая версия платформы нужна?

1C MCP Toolkit — 8.2.13+ или 8.3.25, mcp-1c — 8.3.10 и выше (для ручной установки .cfe — 8.3.14), 1c_mcp — 8.3.20 и новее. EDT-MCP рассчитан на 1C:EDT 2026.2.2.

Работает ли сервер из России?

Все четыре сервера работают у вас рядом с базой 1С, зарубежные аккаунты не нужны; с локальной моделью содержимое базы не покидает вашу сеть.

1С MCP

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ограничения

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

Какую реализацию выбрать

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

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