Menú de documentación

Documentación

Conectar un cliente de IA mediante MCP

En esta página

Conecte un cliente de IA al banco de trabajo mediante MCP y, a continuación, itere un flujo de trabajo cambiando una sola cosa cada vez, sin ceder el control de la cámara.

Qué aporta MCP

MCP (Model Context Protocol) permite que un cliente de IA llame a las herramientas compatibles del banco de trabajo: inspeccionar un flujo de trabajo, proponer un candidato y volver a leer la evidencia del experimento. Es una segunda forma de controlar el mismo servicio de tareas. No añade un controlador de cámara, un nuevo motor de imagen ni una calificación de producción.

Pregunta Respuesta en la vista previa revisada
¿Dónde se ejecuta el cliente? En la estación de trabajo Windows. El cliente inicia por sí mismo el servicio de tareas local y se comunica con él mediante entrada/salida estándar.
¿Modifica una cámara? No por sí mismo. Leer un flujo de trabajo, ejecutar un experimento fuera de línea y escribir la configuración de la cámara son operaciones distintas. La optimización en la propia cámara sigue necesitando el flujo de trabajo de dispositivo compatible y sus pasos de verificación.
¿Necesita Internet? No. El acceso remoto por MCP es una configuración distinta y autenticada; consulte Permisos, seguridad y datos.

Antes de conectar

  1. Instale e inicie el banco de trabajo de Windows como se describe en Instalación y configuración y ejecute un flujo de trabajo fuera de línea para saber cómo es un resultado normal.
  2. Decida qué puede salir de la estación de trabajo. Un cliente reenvía a su propio proveedor los resultados de las herramientas que recibe, incluidas las muestras de imagen.
  3. Prepare un conjunto de muestras etiquetadas con las respuestas esperadas. Mantenga las imágenes de desarrollo separadas de un conjunto de validación congelado.
  4. Planifique conectar primero el servicio de demostración (simulado).

Exportar la configuración del cliente

  1. En la aplicación de escritorio, abra la ventana de optimización y utilice su exportación de configuración MCP.
  2. Elija el formato del cliente: JSON para Claude o TOML para Codex.
  3. Elija el servicio normal o el servicio de demostración (simulado).
  4. Copie el texto o guárdelo. El nombre de archivo sugerido es deyivision-mcp.

La entrada exportada se llama deyivision. Contiene la ruta completa del servicio de tareas instalado, el argumento --mcp (más --simulation para el servicio de demostración) y tres variables de entorno: DEYIVISION_TUNING_INSTANCE, DEYIVISION_TUNING_DESKTOP_INSTANCE y DEYIVISION_TUNING_DATA. Nunca contiene un token, credenciales de la cámara ni ninguna otra variable de entorno. La entrada de demostración omite la carpeta de datos porque ese servicio mantiene la suya propia.

Instalarla en el cliente

  1. Fusione la entrada deyivision con la configuración MCP del cliente: el objeto mcpServers del archivo JSON de Claude o el archivo TOML de Codex. La ubicación de ese archivo depende del cliente y de su versión; siga la documentación del propio cliente.
  2. Reinicie el cliente para que lea la entrada.
  3. Pida al cliente que enumere las herramientas de DeYiVision. Si no aparece ninguna, compruebe la ruta y el registro del cliente antes de cambiar nada en el banco de trabajo.
  4. Vuelva a exportar la configuración después de mover o reinstalar el banco de trabajo, de cambiar la instancia o de cambiar la raíz de datos. La entrada almacena rutas absolutas.

Comprobar la primera conexión

Empiece por el servicio de demostración. Una llamada a una herramienta que se complete con éxito demuestra que el cliente puede iniciar el servicio y comunicarse con él. No pone a prueba ninguna cámara ni una inspección de imagen real, y el servicio de demostración mantiene sus datos separados de los del modo de dispositivo. No lo dirija a la carpeta de datos del modo de dispositivo: dos servicios competirían por el mismo registro de tareas.

Pase al servicio normal solo cuando la llamada de demostración funcione. Una lista de herramientas no es evidencia de una conexión de cámara; consulte Conexión de cámara y adquisición.

Iterar un cambio cada vez

  1. Fije el conjunto de muestras y las respuestas esperadas antes de la primera ejecución.
  2. Pida al cliente que inspeccione la revisión actual del flujo de trabajo y su último resultado. Registre la revisión, los ajustes de los nodos, la identidad de la entrada, la salida o decisión, el tiempo transcurrido y cualquier discrepancia.
  3. Modifique un solo elemento por candidato: un nodo o un parámetro compatible. Enviar un candidato guarda una propuesta; no la ejecuta.
  4. Ejecute el candidato con las mismas imágenes fijas. Una ejecución consume el presupuesto de prueba de PC de la tarea; no es una nueva exposición de la cámara ni una escritura de parámetros de la cámara.
  5. Revise usted mismo la evidencia: imágenes, salida, versión y casos de falla. Una imagen más limpia puede seguir dando una decisión equivocada.
  6. Conserve o descarte el candidato y repita. Si entretanto una persona u otro cliente ha cambiado el flujo de trabajo, lea primero la última revisión y su revisión humana. Un borrador antiguo no debe sobrescribir la revisión actual, y se rechaza un candidato vinculado a una versión obsoleta de la revisión humana.

Consulte Crear y ejecutar un flujo para los controles de revisión, envío y ejecución.

Qué sigue bajo control humano

  • Escrituras en la cámara. Un cliente MCP no elude los controles descritos en Jobs y resultados de inspección. Escribir en una cámara sigue exigiendo el dispositivo y la sesión correctos, permisos, un estado elegible, una línea base registrada y una verificación de lectura.
  • Permisos. El acceso del modelo no es inherentemente de solo lectura: un modelo autenticado puede tener herramientas con capacidad de escritura. Decida a qué puede acceder el cliente antes de conectarlo y revise después lo que ha hecho.
  • Resultados desconocidos. Si una escritura tiene un resultado incierto, lea el recibo de solicitud original. No repita la escritura con un ID de solicitud nuevo.
  • Aceptación. Un experimento fuera de línea con imágenes guardadas no demuestra cómo se comportará un fotograma nuevo en su línea. Acuerde las muestras y los límites de aceptación antes de hacer una afirmación operativa.

Datos y privacidad

El cliente envía al proveedor que haya seleccionado lo que devuelven las herramientas, incluidas las muestras de imagen. Revise antes el destinatario, los derechos sobre los datos y la política del proveedor. Una preferencia de almacenamiento a nivel de solicitud no es una garantía sobre la retención de todas las partes posteriores.

La configuración exportada contiene únicamente rutas locales y nombres de carpetas. La salida de inicio puede contener tokens de acceso local, así que no la pegue en un mensaje de soporte.

Resolución de problemas

Síntoma Comprobaciones y siguiente paso
El cliente no muestra ninguna herramienta de DeYiVision Confirme que la entrada está fusionada en el archivo de configuración real del cliente, reinicie el cliente y compruebe que el comando apunta al ejecutable del servicio de tareas instalado. Vuelva a exportar si el banco de trabajo se movió.
El servicio se inicia y después falla Compare las variables de instancia y de datos con las del banco de trabajo en ejecución. Utilice la pareja que coincida y no comparta nunca una carpeta de datos entre el servicio de demostración y el servicio normal.
Funcionaba y dejó de hacerlo tras una reinstalación o un traslado La entrada almacena rutas absolutas. Vuelva a exportar la configuración y sustituya la entrada antigua.
Se rechaza un candidato por obsoleto Lea la última revisión del flujo de trabajo y su revisión humana y después vuelva a proponer el cambio.
Una escritura tiene un resultado desconocido Lea el recibo de solicitud original antes de decidir si procede una nueva operación.

Límites de esta guía

La lista exacta de herramientas y sus nombres proceden del servicio conectado y pueden cambiar entre compilaciones; pida al cliente que las enumere. La exportación cubre los formatos de Claude (JSON) y de Codex (TOML); el comportamiento con cada versión de cliente no se ha calificado aquí.

Una comprobación de ingeniería realizada el 23 de septiembre de 2026 en una compilación aislada de Windows recuperó una imagen de origen y una imagen procesada mediante un cliente MCP remoto. Ambas ejecuciones devolvieron NoRead (0/1). Demostró el traspaso del flujo de trabajo, el control de revisiones y la recuperación de evidencia; no estableció la tasa de lectura de códigos de barras, la compatibilidad con cámaras en vivo ni la estabilidad en producción.

Versión preliminar de ingeniería. Valide la versión suministrada y la aceptación en planta antes del uso en producción.

Cognex es una marca de terceros. No se implica afiliación ni certificación.

¿Tiene dudas sobre su configuración? Contactar con Deyi Vision

Contacto

Contacto RFQ directo

Hable con ingenieria sobre la inspeccion.

Envie imagenes de muestra, modelo referencia, FOV, distancia de trabajo y velocidad de linea.

Objetivo: brief de seleccion en 24h
Detectar defectos antes