Почему без инженерного контура интеграция разваливается
Типовой сценарий выглядит одинаково: endpoint однажды открылся, демонстрация прошла, а на следующий день результат никто не может повторить. Причина чаще всего не в модели, а в разрывах между шагами и отсутствующих контрольных точках.
- зависимости установлены частично или в неверном порядке;
- проект в EDT не доведен до стабильного состояния до подключения MCP;
- URL и порт сервера расходятся между инструкцией и фактической настройкой;
- диагностика выполняется хаотично, а не по короткому регламенту.
|
Подход |
Как запускают |
Что ломается |
Практический итог |
|
Демо-подход |
Разовый запуск на машине автора |
Повторяемость и переносимость |
Работает только у одного человека |
|
Частично регламентированный |
Есть шаги, но без контрольных точек |
Ошибки поздно обнаруживаются |
Высокие затраты на поддержку |
|
Инженерный процесс |
У каждого шага есть цель и проверка |
Точки отказа локализуются быстро |
Связка масштабируется на команду |
Архитектура связки EDT-MCP-Codex
Базовая схема: `1С:EDT -> EDT-MCP -> endpoint -> Codex -> задача`. Endpoint здесь выступает контрактом между сервером и клиентом. Если endpoint недоступен, вся цепочка неработоспособна.
Рабочая связка состоит из среды разработки, MCP-сервера, сетевой точки доступа и клиента агента.
|
Компонент |
Роль |
Что проверить |
|
1С:EDT |
Рабочая среда проекта, метаданные, сборка |
EDT запускается стабильно, проект открывается без критичных ошибок |
|
EDT-MCP |
Поднимает MCP-сервер и endpoint |
Раздел MCP Server доступен, сервер стартует |
|
Endpoint |
Сетевой контракт доступа |
URL, порт и путь /mcp отвечают предсказуемо |
|
Codex |
Клиент, работающий через MCP |
Сервер добавлен, виден в mcp list, параметры корректны |
Пошаговый маршрут внедрения
Следующий этап начинается только после контрольной проверки предыдущего. Это ключевое правило, которое снижает количество ложных причин и ускоряет внедрение.
- Установить Java Liberica 11 Full JDK и затем 1С:EDT.
- Подключить проект в EDT и убедиться, что базовые операции стабильны до установки MCP.
- Установить EDT-MCP через update site и перезапустить EDT.
- Настроить MCP Server, указать путь к каталогу check и запустить сервер.
- Проверить endpoint, затем подключить сервер в Codex (add, list, get).
- Запустить тестовую задачу малого объема и зафиксировать результат в чеклисте.
Мини-регламент диагностики
Для сокращения времени на инциденты полезно закрепить единый порядок диагностики и соблюдать его во всех случаях подключения.
- Сверить URL полностью: протокол, IP, порт и путь /mcp.
- Проверить, что MCP Server в EDT запущен и endpoint отвечает.
- Проверить сетевую доступность между клиентом и сервером, включая VPN.
- Пересоздать запись MCP в Codex (remove -> add) и перепроверить параметры.
- Повторно запустить минимальную контрольную задачу.
|
Симптом |
Вероятная причина |
Что делать |
|
Сервер добавился, но задачи не идут |
Endpoint недоступен или неверный путь |
Проверить доступность URL и параметры --url |
|
Локально работает, удаленно нет |
Проблема сетевого маршрута или VPN |
Проверить видимость хоста и порта |
|
Сервер нестабилен после установки |
Не задан путь к каталогу check |
Дозаполнить настройки и перезапустить сервер |
|
Ошибки повторяются в команде |
Нет единых проверок |
Ввести короткий регламент запуска и диагностики |
Критерии готовности для команды
Интеграция считается готовой не после первой удачной демонстрации, а когда процесс стабильно повторяется несколькими участниками без устных подсказок.
- Java и EDT установлены и запускаются стабильно;
- проект в EDT открывается и проходит базовую проверку;
- MCP Server поднят, endpoint отвечает;
- Codex корректно видит MCP-конфигурацию;
- тестовая задача проходит через MCP и результат верифицируется;
- шаги зафиксированы в коротком чеклисте команды.
Главный вывод: MCP в 1С полезен тогда, когда он встроен в проверяемый процесс. Ценность возникает не в моменте «модель ответила», а в моменте «команда стабильно повторила цикл и получила предсказуемый результат».
Вступайте в нашу телеграмм-группу Инфостарт
