> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/pi-dsh-1c/mcp.md).

# MCP в Pi и DSH

MCP-серверы дают агенту справку платформы, поиск по коду и метаданным, граф связей, БСП, шаблоны, проверку синтаксиса и проверку через 1С:Напарник. Как поднять Docker-образы, ключи и каналы — в разделе [MCP серверы для 1С](https://docs.onerpa.ru/mcp-servery-1c.md). Бандл образы не содержит и контейнеры не стартует.

Пока нужные серверы не запущены, чат открывается. В Pi это режим **degraded**: нет инструментов конкретного молчащего сервера, правки файлов и скрипты навыков остаются. В DSH отсутствие необязательного сервера — предупреждение, а смысловая правка метаданных ждёт живой обязательный MCP и свежий индекс. Задачу нельзя считать проверенной через 1С, пока эти условия не выполнены.

## Серверы поставки

| Назначение        | Pi, id                  | DSH, id        | Порт |
| ----------------- | ----------------------- | -------------- | ---- |
| Код и метаданные  | `1c-code-metadata-mcp`  | `onec_code`    | 8000 |
| Синтаксис BSL     | `1c-syntaxcheck-mcp`    | `onec_syntax`  | 8002 |
| Справка платформы | `1c-docs-mcp`           | `onec_docs`    | 8003 |
| Шаблоны           | `1c-templates-mcp`      | `onec_tpl`     | 8004 |
| Граф метаданных   | `1c-graph-metadata-mcp` | `onec_graph`   | 8006 |
| 1С:Напарник       | `1c-code-checker-mcp`   | `onec_checker` | 8007 |
| БСП               | `1c-ssl-mcp`            | `onec_ssl`     | 8008 |
| UI-тесты          | `1c-qa`                 | `onec_qa`      | 8030 |

У QA порт 8030 — адрес по умолчанию в бандлах. Инструкция [MCP QA](https://docs.onerpa.ru/mcp-servery-1c/servery/qa.md) публикует контейнер на 8020: это значение `QA_HTTP_PORT` в `config.env`. Чтобы бандл увидел QA без своих настроек, задайте `QA_HTTP_PORT=8030`. Либо оставьте 8020 и укажите адрес в бандле: в DSH — `ONEC_MCP_QA_URL=http://127.0.0.1:8020/mcp` в `.dev.env` проекта, в Pi — `/mcp-settings apply 1c-qa <ревизия> endpoint=http://127.0.0.1:8020/mcp`. Текущую ревизию показывает `/mcp-settings`.

Если сервер QA запущен с токеном, DSH берёт его из `ONEC_MCP_QA_TOKEN`, а при отсутствии — из `QA_HTTP_TOKEN`: в `.dev.env` проекта или в окружении. При ответе 401 проверка адреса пишет, что токен не задан или сервер его не принял. После изменения токена перезапустите DSH.

В DSH отдельный Code необязателен, если подключённый Graph уже отдаёт поиск кода. Это не добавляет Graph проверку XML по XSD и другие методы Code: смотрите каталог методов на карточке сервера.

## Кто обязателен

В **Pi** режим ready — это семь серверов таблицы, кроме QA. Недоступность `1c-qa` сессию в degraded не переводит. В манифесте есть ещё `1c-data-mcp`: HTTP-сервис опубликованной базы, адрес из `INFOBASE_PUBLISH_URL` и `/hs/mcp`. По умолчанию он выключен и в готовность не входит.

В **DSH** обязателен Graph. Code обязателен, пока у подключённого Graph не подтверждён метод `search_code`. Справка, шаблоны, БСП, синтаксис, Напарник и QA обязательными не считаются: их отсутствие видно на карточке и чат не останавливает.

Отдельный сервер данных `onec_data` поднимается, когда задан адрес публикации базы. Своего фиксированного порта у него нет.

И в Pi, и в DSH адрес без успешной проверки соединением не считается подключением.

Имена методов в Pi имеют вид `mcp_<server>_<tool>`. В обычном режиме модель не получает все схемы сразу: она ищет метод через `tool_search` и вызывает его через `tool_dispatch`. Живая проверка сверяет identity, каталог и схему. Расхождение не рвёт сессию: остаётся пересечение с разрешённым списком. Административные методы — перезагрузка плагинов сервера, удаление проектов графа, произвольный Cypher, запись памяти шаблонов — модели не отдаются.

## Как проверить

**Pi:** `/mcp1c`, `/mcp1c reconnect`, `/checkmcp`, `/index1c status`, `/preflight1c`. Установщик и `--doctor` делают live-probe. `reconnect` без аргумента переподключает включённые, но молчащие серверы; `all` или id сервера переподключает принудительно, без перезапуска Pi. Расхождение каталога здесь предупреждение. Строго его отвергает probe установщика и `--doctor`.

**DSH:** «Настройки → MCP: серверы», на карточке «Предпросмотр» → «Проверить» → «Сохранить». Вкладка «MCP 1С» справа открывает те же настройки. Из консоли — `DSH-Desktop-1C.exe --doctor`. Недоступный MCP даёт предупреждение; код 1 — поломка профиля поставки, а не тихий сервер. После сохранения нового URL адреса уже можно проверить, но ход агента увидит их после полного перезапуска, включая выход из трея.

Сервер, поднятый после старта сессии Pi, сам в ней не появится: нужен `/mcp1c reconnect`. В DSH новый процесс сервера подхватывается перезапуском. В control center при росте каталога есть «Перезапустить хост».

Сторонний HTTP или stdio сервер подключается к проекту отдельно: в Pi — `/mcp-project`, в DSH — «Дополнительные серверы» и файл `.mcp.json`. Если адрес совпадает с уже включённым сервером бандла, работает сервер бандла, а дубль пропускается.

## EDT-MCP

EDT-MCP запускается вместе с 1С:EDT, бандл его не поднимает. Подключение проверяет `/check-edt` в Pi и DSH. Аргументов нет: команда авторизуется так же, как текущее подключение, читает каталог инструментов, вызывает `get_edt_version` и `list_projects` и показывает хост, порт, версию EDT и проекты. В DSH команда есть только в пресетах 1С.

DSH выбирает экземпляр EDT по текущей рабочей копии Git, в том числе по связанному worktree: по её `.mcp.json` или по служебным файлам уже запущенной EDT в `build/` (`edt-mcp-port`, `edt-mcp-ready`, `edt-mcp.pid`; процесс из `edt-mcp.pid` должен быть жив). Файлы учитываются, если EDT настроена для проекта или в 1С Full задано `USE_EDT=true`.

В DSH вызов инструмента EDT ждёт до 15 минут, а не одну. Свой `toolCallTimeoutMs` в `.mcp.json` проекта учитывается, если он от 1 секунды до часа.

Из терминала та же проверка возвращает код 0 при успехе и 1 при ошибке:

* Pi — `node "<папка поставки>/scripts/check-edt.mjs"`;
* DSH — `node "<папка поставки>/dsh-1c-bundle/lib/check-edt.js" "<папка проекта>"`.

На живой 1С:EDT проверка в выпуске не прогонялась: проверены тестовый MCP и настоящие Git worktree.

## Индексация

Поиск по вашей конфигурации требует выгрузки и индекса Code и Graph. Свежесть выгрузки смотрите в Pi командой `/freshness1c`, переиндексацию после выгрузки — `/sync1c` и `/index1c`. В DSH состояние индекса видно на карточке сервера, действия обновления и отмены — в «Подробностях индексации».

`/index1c start`, `reindex`, `cancel` и `retry` в Pi вызываются только если сервер объявил такой метод. Иначе команда честно отвечает `unsupported`.

После успешной загрузки исходников в базу DSH запускает переиндексацию code MCP и привязанного проекта graph. Пока индекс не подтверждён, старый поиск закрыт и остаются локальные файлы. Если MCP недоступен или не задан `graphProjectId`, причина показывается, а сама загрузка базы из-за этого не отменяется.
