ftx-mcp

Habla con tu proyecto FactoryTalk Optix. ftx-mcp conecta herramientas de IA (Desktop, Cowork, Code — o cualquier cliente MCP) con FactoryTalk Optix Studio en tu máquina Windows, para que puedas crear y modificar pantallas HMI describiendo lo que quieres:

"Añade un encabezado que diga 'Hello Optix' a Screen 1 y muéstramelo."

"Vincula la visibilidad de esa etiqueta a Model/PumpRunning."

"Se ve bien. Lanza el emulador y valídalo."

Tu LLM escribe el cambio directamente en tu proyecto de Studio abierto, ejecuta el emulador y observa el runtime renderizado para confirmar que funcionó. Es un compañero de desarrollo y pruebas: el envío al hardware permanece en el diálogo Deploy de Studio, en tus manos. Todo excepto las llamadas al LLM se ejecuta localmente en tu máquina. Sin servicio en la nube, sin clave API; tu LLM de elección proporciona la inteligencia.

Entrada de blog

Instalación (10 minutos)

Requisitos: Windows 11, FactoryTalk Optix Studio 1.7.x y un cliente MCP como Claude Cowork. También: Google Chrome (el bucle de verificación CDP; omítelo con setup.ps1 -NoCdp) y — para la ruta del conector de Microsoft Store build de Claude Desktop — Node.js (winget install OpenJS.NodeJS.LTS; la configuración usa npx mcp-remote). La instalación instala automáticamente Tesseract OCR mediante winget para las herramientas de texto sin tokens de visión (omítelo con -NoOcr; todo lo demás funciona sin él) y Pillow en el venv para la comparación de píxeles.

Ejecuta setup.ps1 desde una ventana normal de PowerShell — no desde un shell alojado dentro de una aplicación empaquetada como la versión Store de Claude Desktop, cuyas escrituras en %LOCALAPPDATA% están virtualizadas (la instalación ahora detecta esto y se niega). Si descargaste un ZIP en lugar de clonar, ejecuta Get-ChildItem -Recurse | Unblock-File primero.

Si setup.ps1 (o cualquier bootstrap\*.ps1) falla por completo con un error de ejecución de scripts / "running scripts is disabled", la política de ejecución de tu máquina está bloqueando scripts sin firmar. Desbloquéalos solo para la ventana actual — sin administrador, sin cambio persistente de política — y vuelve a ejecutar:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

git clone https://github.com/asqi-carter/ftx-mcp.git
cd ftx-mcp
.\bootstrap\setup.ps1                                  # install (does not start anything)
.\bootstrap\services.ps1 start                         # start the service + cdp chrome
.\bootstrap\services.ps1 status                        # verify health
http://127.0.0.1:8765/ui                               # health dashboard

Autenticación: la instalación predeterminada es solo de bucle local con autenticación DESACTIVADA — la instalación nunca solicita nada y no se necesita token en tu propia máquina. Vincular a la LAN es el único caso que requiere autenticación: instala con .\bootstrap\setup.ps1 -EnableAuth (consulta docs/security.md). Si una UI/API solicita inesperadamente un token de portador, una instalación anterior habilitó la autenticación — vuelve a ejecutar la instalación con -NoAuth para limpiarlo.

Para eliminar una instalación (o restablecer antes de una reinstalación limpia): .\bootstrap\uninstall.ps1 detiene y anula el registro de las tareas programadas y elimina cualquier chrome CDP sobrante; añade -All para también eliminar el estado (tokens emitidos, perfil de chrome, elección de autenticación persistida) y el venv.

Related MCP server: tiacommander-mcp

Iniciar el Puente de Studio (5 minutos)

1. Configuración única del puente (por proyecto): en el árbol de proyectos de Studio, haz clic derecho en NetLogic → añade un nuevo DesignTime NetLogic llamado StudioMCPBridge, haz doble clic para abrir el editor de C# y pega studio-bridge/StudioMCPBridge.cs (asegúrate de recompilar en tu editor de código o guardar en Studio para activar una recompilación)

2. Configura el Proyecto una vez por sesión de Studio: haz clic derecho en StudioMCPBridge → SetupProject → Esto solo añade una webui para acceso de validación en localhost:8081

3. Inicia el puente una vez por sesión de Studio: haz clic derecho en StudioMCPBridge → StartBridge → acepta la solicitud de seguridad única de Studio.

4. Verifica la salud del puente: la Salida de Studio mostrará listening on http://127.0.0.1:8768 (el puente). El panel de servicio en http://127.0.0.1:8765/ui también muestra el estado del puente.

Cowork (5 minutos)

Requisitos: servidor MCP y puente en ejecución. Aplicación de escritorio de Claude descargada.

cd ftx-mcp                   # install + start the service
.\bootstrap\setup-mcp-client.ps1 -WriteConfig          # adds as a connector to desktop app

Reinicia Claude Desktop (puede que tengas que finalizar la tarea en el administrador de tareas para reiniciarlo por completo), luego pide a Claude que "ejecute optix_status(action='doctor')" — informará de cualquier cosa que falte, con una solución en lenguaje sencillo para cada elemento. En configuración > conectores puedes ajustar los permisos para cada una de las herramientas.

Claude Code (5 minutos)

Requisitos: servidor MCP saludable y claude accesible en la CLI

claude mcp add --transport http ftx-mcp http://127.0.0.1:8766/mcp

Luego, en Claude Code, ejecuta /mcp y confirma que ftx-mcp aparece como conectado.

Visual Studio Code (5 minutos)

Crea o abre .vscode/mcp.json y añade:

{
  "servers": {
    "ftx-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8766/mcp"
    }
  }
}

Tu primer cambio

1. Pide un cambio, por ejemplo: "Usando el ftx mcp, añade un botón de Inicio y Parada que alterne Model/MotorRun en MainWindow, y verifica que funciona con una etiqueta con el texto 'MOTOR RUNNING' que tenga visibilidad vinculada a MotorRun."

2. Obsérvalo funcionar: autor → vista previa del emulador → captura de pantalla → y cuando se vea bien, lo despliegas a tu hardware desde Studio como siempre.

De lo que es capaz

• Autor de widgets, propiedades, enlaces, expresiones calculadas, eventos, traducciones y navegación multi-pantalla — en vivo en el proyecto de Studio abierto.

• Ejecutar el emulador integrado de Studio mediante la tecla F5 y leer el registro del runtime.

• Verificar mirando la webui: captura de pantalla, hacer clic en botones y pestañas, escribir en campos.

• Devolverte el control para enviar cuando la vista previa se vea bien, despliegas desde Studio como siempre. Esta distribución solo ejecuta el emulador.

La lista completa de herramientas (33 herramientas por defecto — las variables de entorno de puerta pueden añadir más — además de la misma superficie sobre HTTP puro para scripts y CI) está en docs/tool-reference.md. Economía de tokens: las capturas de pantalla cuestan ~1-2k tokens de visión cada una; la familia de herramientas OCR (optix_cdp_read_text, find_text, navigate, sweep/diff) convierte la mayoría de las comprobaciones en lecturas de texto gratuitas — consulta los playbooks optix-blind-authoring y optix-visual-regression para el flujo de trabajo (la instalación instala tesseract automáticamente; -NoOcr opta por no hacerlo).

Los playbooks de autoría incluidos (navegación, controles vinculados, estilos, expresiones) se envían con el propio servidor — Claude los descubre mediante optix_list_skills / optix_get_skill, por lo que cada cliente conectado los recibe sin configuración. (En Claude Code también se cargan de forma nativa como skills.)

Postura de seguridad y protección

• Solo local. El servicio se vincula a 127.0.0.1 y no se comunica con nada fuera de la máquina. Autenticación opcional de token de portador, aplicada antes de cualquier vínculo LAN.

• Solo lectura por defecto. Cada herramienta lleva anotaciones MCP readOnlyHint / destructiveHint (fijadas por contrato mediante pruebas) para que tu host MCP pueda aprobar automáticamente las lecturas y controlar las escrituras.

• Puertas de escritura, no esperanzas. Propiedades no declaradas, escrituras de arrays, nombres duplicados y re-padres inseguros se rechazan con errores tipados; las operaciones compuestas se revierten en caso de fallo. Las ediciones a nivel de archivo se rechazan mientras Studio tiene el proyecto abierto.

• Auditado. Cada mutación del modelo añade una línea JSON a un rastro de auditoría local (%LOCALAPPDATA%\ftx-mcp\logs\audit.jsonl) qué, cuándo, resultado.

• El envío permanece en tus manos. La vista previa nunca toca tu runtime; el despliegue al hardware se realiza desde Studio, sin más. Esta distribución realiza ediciones en tiempo de diseño y pruebas mediante el emulador.

La postura completa, incluido el análisis de superficie de inyección de prompts, está en SECURITY.md.

Documentación

Compatibilidad

Probado con FactoryTalk Optix Studio 1.7.x en Windows 11, Python 3.12. El comportamiento de la CLI de Optix no es estable por contrato entre versiones principales — fija tu versión de Studio en producción.

Licencia

MIT · © 2026 ASQI · No afiliado ni respaldado por Rockwell Automation. FactoryTalk Optix es una marca comercial de Rockwell Automation, Inc.; este proyecto orquesta binarios de Optix instalados localmente sin redistribuirlos. Consulta NOTICE.