Перейти к содержимому

Идёт открытая бета — все возможности бесплатныПодробнее

one-s-mcp

Справочник

MCP для 1С: что это такое и как подключить

MCP (Model Context Protocol) — открытый протокол, по которому ИИ-помощник подключает внешние источники знания. Для аналитика, разработчика и архитектора 1С это способ дать нейросети точное знание о вашей конфигурации вместо усреднённых представлений из интернета. Здесь собран справочник по MCP для 1С: что это за протокол, что он даёт на конкретных задачах и как подключить MCP-сервер к вашей среде.

Содержание

Что такое MCP простыми словами

Нейросеть умеет рассуждать, но ничего не знает про вашу базу. Ваша конфигурация — наоборот: знает про себя всё, но сама рассуждать не умеет. MCP — это разъём между ними, одинаковый у всех. Раньше каждый ИИ-помощник дружил с внешними системами по-своему, и под каждый приходилось делать отдельную обвязку; протокол задал единый формат, и теперь один и тот же сервер знания подходит сразу всем клиентам, которые его поддерживают.

Участников трое:

  • MCP-клиент — среда, в которой вы работаете. Она умеет подключать серверы и показывать модели, какие инструменты доступны.
  • MCP-сервер — поставщик знания. Он объявляет набор инструментов («найди по смыслу», «покажи карточку объекта», «пройди по графу вызовов») и отвечает на обращения к ним.
  • Модель — нейросеть, которая решает, какой инструмент позвать, и складывает ответ из полученных фактов.

Ключевое отличие от привычной работы с чатом: знание не заучивается заранее и не вставляется в переписку руками — оно добывается по запросу. Модель сама решает, чего ей не хватает, зовёт инструмент и получает точный кусок. Поэтому размер конфигурации перестаёт быть препятствием: в окно запроса попадает не вся база, а ровно то, что нужно для конкретной задачи.

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

Зачем MCP нужен именно в 1С

Разница видна не в общих словах, а на рабочих вопросах, которые разработчик задаёт каждый день.

ИИ-помощник общего назначения знает 1С усреднённо — по тому, что встречалось в открытых источниках. Он не видел вашу конфигурацию, не знает ваших расширений, путается в библиотеке стандартных подсистем и не помнит точных сигнатур платформенных методов. Отсюда уверенные ответы про объекты, которых у вас нет, и вызовы методов, которых не существует.

Дообучить модель под конкретную базу нельзя: конфигурация меняется каждый день, а переучивать модель под каждую доработку никто не будет. Вставлять модули в переписку вручную тоже не выход — в типовой их десятки тысяч. MCP снимает эту развилку: индекс живёт отдельно от модели, обновляется вместе с конфигурацией, а модель обращается к нему по мере надобности.

«Где в конфигурации считается эта цифра?»

Вопрос словами вместо перебора модулей глазами. Поиск по смыслу находит нужное место, даже если в коде оно называется иначе, а граф вызовов показывает, кто его дёргает.

«Что сломается, если я изменю этот документ?»

Обход связей в обе стороны: какие регистры двигает, кто на него ссылается, какие процедуры вызывают, что перехвачено расширениями. Ответ за секунды вместо получаса поисков.

«Как это сделано в типовой?»

Агент смотрит вашу конкретную сборку — с вашими доработками и расширениями, а не абстрактную типовую из интернета.

«Напиши обработку под такую задачу»

Модель пишет код, опираясь на реальные имена объектов и точные сигнатуры, а разметку формы собирает механизм, а не нейросеть. Написанное тут же прогоняется через локальную проверку.

«Что изменилось между типовой и нашей базой?»

Дельта двух конфигураций до реквизита и модуля — что добавлено, удалено, изменено и переименовано.

«Сколько было продано за квартал и почему столько?»

Вопрос к живой базе обычными словами, с разбором цифры до первичных документов. Мост к базе только читает. Сейчас «Аналитика данных» активно дорабатываем.

Что входит в набор серверов

one-s-mcp — не один сервер, а набор справочных модулей. Каждый отвечает за свою область и объявляет агенту свои инструменты.

Код и метаданные конфигурации

Поиск по смыслу запроса и по точным словам одновременно. Находит процедуры и объекты, даже когда формулировка задачи не совпадает с текстом кода.

Граф конфигурации

Кто кого вызывает — с точностью до процедуры конкретного модуля, и какие объекты с какими связаны: ссылки, движения, подчинённость.

Анализ влияния изменений

Обход связей в обе стороны, чтобы ответить на вопрос «что сломается, если тронуть этот документ» — вместе с перехватами расширений.

Справка платформы 1С

Точные сигнатуры платформенных методов и разделы синтакс-помощника — вместо того, что модель припомнила из интернета.

Справочник БСП

Готовые процедуры библиотеки стандартных подсистем: что уже написано до вас и как этим правильно пользоваться.

Проверка кода 1С

Разбор написанного в контуре вашей конфигурации, вместе с расширениями: синтаксис, частые ошибки, стандарты разработки и автоформат. Считается на вашей машине.

Формы, обработки и расширения

Разметку управляемой формы собирает точный механизм, а не догадка нейросети: от описания задачи до готового файла обработки или расширения.

Аналитик данных

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

Модули запускает и контролирует настольное приложение — вручную поднимать их не нужно. Отдельно от них есть встроенный ИИ-агент: он получает задачу, сам обходит модули, собирает разведку по конфигурации и готовит ответ, не выходя из приложения.

Как подключить к ИИ-помощнику

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

В настройках приложения есть матрица «помощник × область»: шесть помощников и две колонки — глобально, один раз для всех проектов, и в конкретном проекте. Ставите галочки на нужных пересечениях, и приложение пишет подключение каждому в его родном формате, не трогая чужие записи в этих файлах. Пока приложение открыто, адреса поддерживаются живыми: при перезапуске модулей и смене адресов настройки пере-утверждаются автоматически.

  1. Шаг 1. Установить приложение

    Один установщик для Windows — без Docker, отдельного сервера баз данных и ручной настройки окружения. Встроенные хранилища приложение поднимает само.

  2. Шаг 2. Указать конфигурацию и дождаться индексации

    На вход идёт обычная XML-выгрузка из Конфигуратора. Прогресс индексации виден в окне; повторная индексация после доработки проходит по изменившимся частям, а не заново.

  3. Шаг 3. Отметить своих помощников

    В матрице подключений отмечаете тех, кем пользуетесь, и область — глобально или в проекте. Приложение записывает настройки за вас.

  4. Шаг 4. Перезапустить помощника

    После перезапуска инструменты разведки конфигурации появляются у агента, и он начинает ими пользоваться сам — специальных команд запоминать не нужно.

Шесть помощников, которых приложение настраивает само

Claude Code
Codex
Cursor
VS Code
OpenCode
Hermes Agent

Честно про зрелость: живьём отлажен Claude Code — сквозная проверка «помощник видит модули и зовёт инструменты» пройдена именно на нём. Для остальных запись настроек покрыта тестами и работает, но живая приёмка каждым помощником — отдельный шаг, он ещё выполняется. У Hermes Agent проектной настройки нет вовсе, только общая; у Codex своё ограничение — проектные настройки он применяет только для «доверенных» проектов.

Список шестью помощниками не ограничен. Это набор обычных MCP-серверов, поэтому он работает с любым клиентом, поддерживающим протокол: там подключение прописывается вручную, схема у всех однотипна. Общая схема ручного подключения — в руководстве.

Локально против облака

Для 1С это не вопрос вкуса: бизнес-логика конфигурации — коммерческая тайна компании.

Чтобы ИИ-помощник перестал выдумывать, ему нужно дать прочитать устройство базы: метаданные, связи объектов, тексты модулей. Первый вопрос, который задаёт любой ИТ-руководитель, — куда при этом уходит код. Для многих компаний ответ «в чужое облако» — стоп-фактор при выборе любого инструмента, и отдельно это касается госсектора, банков и всех, у кого есть требования к локализации данных или персональные данные внутри конфигурации.

В one-s-mcp — MCP-сервер для 1С отдавать нечего: разбор выгрузки, построение указателей, поиск и граф связей выполняются на вашей машине. Смысловые отпечатки кода считает ваша видеокарта, а не платный внешний сервис — значит, нет ни ещё одной подписки, ни ещё одного канала наружу.

Остаётся у вас

  • Выгрузка конфигурации и тексты всех модулей.
  • Метаданные, связи объектов, граф вызовов, расширения.
  • Поисковые указатели — и словесный, и смысловой.
  • Расчёт смысловых отпечатков: он идёт на вашем железе.
  • Данные рабочей базы: их читает сама платформа 1С под правами вашего пользователя.

Уходит наружу — только по вашему решению

  • Запросы встроенного ИИ-агента — к той нейросети, которую подключили вы, по вашему ключу. Можно подключить частную или развёрнутую внутри компании модель.
  • Обезличенная телеметрия: счётчики и факты вроде «индексация завершилась», привязанные к случайному номеру установки. Код, данные 1С и даже имена самописных конфигураций туда не попадают.

Вопросы и ответы

Чем MCP-сервер отличается от плагина или расширения для среды разработки?
Плагин пишется под одну конкретную среду и живёт внутри неё. MCP-сервер — отдельная программа, которая говорит на общем протоколе, поэтому один и тот же сервер подходит любому клиенту с поддержкой MCP: Claude Code, Codex, Cursor, VS Code, OpenCode, Hermes Agent. Меняете среду — сервер остаётся.
Мсп-сервер, мср-сервер, эм-си-пи — это одно и то же?
Да, это одно и то же, просто записанное по-разному. Латиницей — MCP-сервер. Русскими буквами по начертанию — «мср-сервер», по созвучию — «мсп-сервер», по произношению — «эм-си-пи». За всеми написаниями стоит Model Context Protocol. Не путайте с сокращением МСП в значении «малое и среднее предпринимательство»: к реестру МСП протокол отношения не имеет.
Нужно ли что-то менять в самой конфигурации 1С?
Для разбора, поиска и графа — нет: в конфигурацию ничего не встраивается и ничего в ней не правится. Достаточно обычной XML-выгрузки из Конфигуратора — по ней строится индекс. Исключение — модуль «Аналитик данных»: для вопросов к живой базе в неё ставится маленькое расширение-мост, а саму базу публикуют на веб-сервере. Мост только читает.
Нужен ли доступ в интернет, чтобы MCP-сервер работал?
Для индексации и поиска — нет: всё считается на вашей машине. Интернет нужен только встроенному ИИ-агенту, и только чтобы обратиться к той нейросети, которую вы сами подключили. Если подключена модель, развёрнутая внутри компании, наружу не уходит и это.
Нужна ли видеокарта?
Желательна видеокарта NVIDIA — на ней индексация идёт заметно быстрее. Но обязательной она не является: без подходящей видеокарты расчёт выполняется на процессоре, просто дольше.
Сколько MCP-серверов надо запускать и как ими управлять?
Вручную — ни одного. Модули поднимает и контролирует настольное приложение: в нём же видно состояние каждого. Закрыли приложение — модули остановились, фоновых процессов с вашим индексом не остаётся.
Работает ли это с самописной конфигурацией?
Да. Индекс строится по вашей выгрузке, а не по списку известных типовых. Расширения разбираются вместе с основной конфигурацией и накладываются на неё, поэтому система видит базу такой, какая она есть.
Сколько это стоит?
Сейчас — ничего. Идёт открытая бета: все возможности бесплатны, нужен только аккаунт с подтверждённой почтой. Платные тарифы вернутся позже, дату мы объявим заранее.

Остальные частые вопросы — про требования, приватность и совместимость — собраны в документации. Как устроен полный цикл от выгрузки до ответа агента, разобрано на странице «Как это работает». Отдельный справочник по механизму расширений платформы — устройство, порядок добавления и разбор отказов применения — на странице «Расширения конфигурации 1С». Если вы пришли к протоколу от более широкого вопроса — какие вообще задачи в 1С сегодня решаются нейросетью, — начните с разбора «ИИ и нейросеть для 1С». Если проект вы ведёте не в Конфигураторе, а в 1С:EDT, там отдельно разобрано, что для этой среды готовится и что работает уже сегодня.

Попробуйте на своей конфигурации

Идёт открытая бета: все возможности бесплатны, нужен только аккаунт с подтверждённой почтой.