1C MCP

1C MCP — открытый проект для 1С:Предприятие, который превращает вашу базу в MCP-сервер и открывает её данные и функции для AI-ассистентов вроде Claude Desktop или Cursor. По сути это готовое расширение конфигурации плюс опциональный Python-прокси: ставите, публикуете HTTP-сервис, подключаете клиента — и модель сама запрашивает нужный контекст из 1С. Пригодится 1С-разработчикам и внедренцам, которым надо связать учётную систему с языковыми моделями без написания протокола с нуля.

Логика проста. Model Context Protocol — открытый стандарт, по которому модель обращается к «инструментам» (tools) на вашем сервере и добирает данные самостоятельно, вместо того чтобы вы вручную копировали выгрузки в чат. Расширение из репозитория берёт на себя всю техническую рутину протокола, а вам остаётся описать бизнес-логику конкретных инструментов. Работа с метаданными конфигурации доступна сразу из коробки.

Быстрый старт занимает три шага: подключить собранное расширение MCP_Сервер.cfe из каталога build, опубликовать на веб-сервере HTTP-сервис mcp_APIBackend, затем подключить AI-клиент по адресу вида .../ваша_база/hs/mcp/. Готовые конфиги для разных клиентов лежат в папке mcp_client_settings. Один нюанс, о котором предупреждают авторы: регистр имени базы в URL должен совпадать с именем публикации, иначе редиректы превратят POST-запросы в GET.

Подключиться можно тремя способами, и выбор влияет на безопасность:

• напрямую к 1С — AI-клиент общается с HTTP-сервисом, но базу придётся публиковать без аутентификации 1С, а клиенты на транспорте stdio не заработают;
• через Python-прокси (рекомендуемый вариант) — решает вопрос транспорта stdio и реализует OAuth2, передавая авторизацию в 1С через Basic Auth, так что аутентификацию отключать не нужно; прокси умеет работать от имени одного фиксированного пользователя или пробрасывать учётные данные каждого;
• прокси в Docker — копируете .env.docker.example, прописываете URL и реквизиты, поднимаете docker-compose; если 1С на том же хосте, вместо localhost указывайте host.docker.internal.

Свои инструменты добавляются двумя путями. Можно создать обработку внутри расширения-движка, включить её в подсистему mcp_КонтейнерыИнструментов и реализовать в модуле менеджера два экспортных метода — ДобавитьИнструменты для описания параметров и ВыполнитьИнструмент для самой логики. Либо завести отдельное расширение, скопировав туда подсистему mcp_MCPСервер с собственным префиксом: движок сам находит такие подсистемы по имени и подключает их как свои. Кроме инструментов поддерживаются Ресурсы для статического контекста вроде файлов и Промпты для заготовленных шаблонов сообщений.

Документация разнесена по проекту: отдельное описание настройки прокси, руководство по разработке в 1С (его, кстати, можно скармливать AI-агентам как контекст для генерации кода) и примеры клиентских настроек. Лицензия MIT, проект бесплатный и активно развивается, вопросы и предложения принимаются через Issues. К моменту написания у репозитория больше 500 звёзд и 128 форков, есть подробное видеообъяснение на VK Видео, YouTube и Rutube.