Документация
Подключение ИИ-клиента через MCP
На этой странице
Подключите ИИ-клиент к рабочей среде через MCP, а затем дорабатывайте рабочий процесс по одному изменению за раз, не передавая клиенту управление камерой.
Что даёт MCP
MCP (Model Context Protocol) позволяет ИИ-клиенту вызывать поддерживаемые инструменты рабочей среды: просматривать рабочий процесс, предлагать кандидата и считывать доказательства эксперимента. Это второй способ управлять той же службой задач. MCP не добавляет драйвер камеры, новый движок обработки изображений или производственную квалификацию.
| Вопрос | Ответ для рассмотренной предварительной версии |
|---|---|
| Где работает клиент? | На рабочей станции Windows. Клиент сам запускает локальную службу задач и обменивается с ней данными через стандартный ввод/вывод. |
| Меняет ли он камеру? | Сам по себе — нет. Чтение рабочего процесса, запуск автономного эксперимента и запись параметров камеры — отдельные операции. Настройка на стороне камеры по-прежнему требует поддерживаемой процедуры работы с устройством и её шагов проверки. |
| Нужен ли интернет? | Нет. Удалённый доступ по MCP — это отдельная конфигурация с аутентификацией; см. Права доступа, безопасность и данные. |
Перед подключением
- Установите и запустите рабочую среду Windows, как описано в разделе Установка и настройка, и выполните один автономный рабочий процесс, чтобы знать, как выглядит нормальный результат.
- Решите, что может покидать рабочую станцию. Клиент передаёт своему поставщику результаты инструментов, которые получает, включая образцы изображений.
- Подготовьте размеченный набор образцов с ожидаемыми ответами. Храните изображения для разработки отдельно от замороженного набора проверки.
- Запланируйте, что сначала будет подключена демонстрационная (смоделированная) служба.
Экспорт конфигурации клиента
- В настольном приложении откройте окно настройки и воспользуйтесь экспортом конфигурации MCP.
- Выберите формат клиента: JSON для Claude или TOML для Codex.
- Выберите обычную службу или демонстрационную (смоделированную) службу.
- Скопируйте текст или сохраните его. Предлагаемое имя файла —
deyivision-mcp.
Экспортируемая запись называется deyivision. Она содержит полный путь к установленной службе задач, аргумент --mcp (для демонстрационной службы — также --simulation) и три переменные окружения: DEYIVISION_TUNING_INSTANCE, DEYIVISION_TUNING_DESKTOP_INSTANCE и DEYIVISION_TUNING_DATA. В неё никогда не попадают токен, учётные данные камеры и другие переменные окружения. В записи демонстрационной службы папка данных не указывается, потому что эта служба хранит собственные данные.
Установка в клиенте
- Добавьте запись
deyivisionв MCP-конфигурацию клиента: в объектmcpServersJSON-файла Claude или в TOML-файл Codex. Расположение этого файла зависит от клиента и его версии; следуйте документации самого клиента. - Перезапустите клиент, чтобы он прочитал запись.
- Попросите клиент перечислить инструменты DeYiVision. Если ни один не появился, проверьте путь и журнал клиента, прежде чем что-либо менять в рабочей среде.
- Экспортируйте конфигурацию заново после переноса или переустановки рабочей среды, смены экземпляра или смены корня данных. Запись хранит абсолютные пути.
Проверка первого подключения
Начните с демонстрационной службы. Успешный вызов инструмента доказывает, что клиент может запустить службу и обмениваться с ней данными. Он не задействует камеру и не выполняет реальный контроль изображений, а демонстрационная служба хранит свои данные отдельно от данных режима устройства. Не направляйте её на папку данных режима устройства: две службы будут конкурировать за один и тот же реестр задач.
Переходите к обычной службе только после того, как вызов демонстрационной службы сработает. Список инструментов не является свидетельством подключения камеры; см. Подключение камеры и получение изображений.
Дорабатывайте по одному изменению
- Зафиксируйте набор образцов и ожидаемые ответы до первого запуска.
- Попросите клиент просмотреть текущую редакцию рабочего процесса и её последний результат. Запишите редакцию, параметры узлов, идентичность входных данных, выход или решение, затраченное время и все расхождения.
- Измените одного кандидата: один поддерживаемый узел или параметр. Отправка кандидата сохраняет предложение, но не запускает его.
- Запустите кандидата на тех же фиксированных изображениях. Запуск расходует пробный бюджет задачи на ПК; это не новая экспозиция камеры и не запись параметров камеры.
- Просмотрите доказательства самостоятельно: изображения, выход, версию и случаи сбоев. Более чистое изображение всё равно может привести к неверному решению.
- Сохраните или отбросьте кандидата и повторите. Если тем временем человек или другой клиент изменил рабочий процесс, сначала прочитайте последнюю редакцию и проверку человеком. Старый черновик не должен перезаписывать текущую редакцию, а кандидат, привязанный к устаревшей редакции проверки, отклоняется.
Об элементах управления редакцией, отправкой и запуском см. Создание и запуск процесса.
Что остаётся под контролем человека
- Запись в камеру. MCP-клиент не обходит механизмы контроля, описанные в разделе Задания и результаты контроля. Запись в камеру по-прежнему требует правильного устройства и сеанса, прав доступа, подходящего состояния, записанного исходного состояния и обратного чтения.
- Права доступа. Доступ модели по своей сути не является доступом только для чтения: аутентифицированная модель может иметь инструменты с возможностью записи. Определите, к чему клиент может обращаться, до подключения и проверяйте, что он сделал, после.
- Неизвестные результаты. Если результат записи неопределён, прочитайте квитанцию исходного запроса. Не повторяйте запись под новым идентификатором запроса.
- Приёмка. Автономный эксперимент на сохранённых изображениях не доказывает, как поведёт себя новый кадр на вашей линии. Согласуйте образцы и пределы приёмки, прежде чем делать утверждения о работе в эксплуатации.
Данные и конфиденциальность
Клиент отправляет выбранному вами поставщику всё, что возвращают инструменты, включая образцы изображений. Предварительно проверьте получателя, права на данные и политику поставщика. Параметр хранения на уровне запроса не является гарантией того, как долго сохраняют данные все последующие стороны.
Экспортируемая конфигурация содержит только локальные пути и имена папок. Вывод при запуске может содержать локальные токены доступа, поэтому не вставляйте его в обращение в поддержку.
Устранение неполадок
| Симптом | Проверки и следующий шаг |
|---|---|
| Клиент не показывает инструменты DeYiVision | Убедитесь, что запись добавлена в реальный файл конфигурации клиента, перезапустите клиент и проверьте, что команда указывает на исполняемый файл установленной службы задач. Экспортируйте конфигурацию заново, если рабочая среда была перенесена. |
| Служба запускается, а затем завершается с ошибкой | Сравните переменные экземпляра и данных с запущенной рабочей средой. Используйте соответствующую пару и никогда не делайте одну папку данных общей для демонстрационной и обычной службы. |
| Работало, но перестало после переустановки или переноса | Запись хранит абсолютные пути. Экспортируйте конфигурацию заново и замените старую запись. |
| Кандидат отклонён как устаревший | Прочитайте последнюю редакцию рабочего процесса и проверку человеком, затем предложите изменение снова. |
| У записи неизвестный результат | Прочитайте квитанцию исходного запроса, прежде чем решать, уместна ли новая операция. |
Ограничения этого руководства
Точный список инструментов и их имена определяет подключённая служба, и они могут меняться между сборками; попросите клиент перечислить их. Экспорт охватывает форматы Claude (JSON) и Codex (TOML); поведение с каждой версией клиента здесь не квалифицировано.
Инженерная проверка 23 сентября 2026 г. на изолированной сборке Windows получила исходное и обработанное изображения через удалённый MCP-клиент. Оба запуска вернули NoRead (0/1). Проверка показала передачу рабочего процесса, контроль редакций и получение доказательств; она не установила частоту считывания штрихкодов, совместимость с реальной камерой или стабильность в производстве.