ftx-mcp

Sprechen Sie mit Ihrem FactoryTalk Optix-Projekt. ftx-mcp verbindet KI-Tools (Desktop, Cowork, Code – oder jeden MCP-Client) mit FactoryTalk Optix Studio auf Ihrem Windows-Rechner, sodass Sie HMI-Bildschirme durch Beschreibung dessen, was Sie möchten, erstellen und ändern können:

„Fügen Sie Screen 1 eine Kopfzeile mit ‚Hello Optix‘ hinzu und zeigen Sie sie mir.“

„Binden Sie die Sichtbarkeit dieses Labels an Model/PumpRunning.“

„Sieht gut aus. Starten Sie den Emulator und validieren Sie es.“

Ihr LLM schreibt die Änderung direkt in Ihr geöffnetes Studio-Projekt, führt den Emulator aus und betrachtet die gerenderte Laufzeit, um zu bestätigen, dass es funktioniert. Es ist ein Entwicklungs- und Testbegleiter: Das Ausliefern an die Hardware bleibt im eigenen Deploy-Dialog von Studio – in Ihren Händen. Alles außer den LLM-Aufrufen läuft lokal auf Ihrem Rechner. Kein Cloud-Dienst, kein API-Schlüssel; Ihr LLM Ihrer Wahl liefert die Intelligenz.

Blogbeitrag

Installation (10 Minuten)

Voraussetzungen: Windows 11, FactoryTalk Optix Studio 1.7.x und ein MCP-Client wie Claude Cowork. Außerdem: Google Chrome (die CDP-Verifizierungsschleife; überspringen mit setup.ps1 -NoCdp) und – für den Microsoft-Store-Build-Connector-Pfad von Claude Desktop – Node.js (winget install OpenJS.NodeJS.LTS; die Konfiguration verwendet npx mcp-remote). Das Setup installiert automatisch Tesseract OCR über winget für die Textwerkzeuge ohne Vision-Tokens (überspringen mit -NoOcr; alles andere funktioniert auch ohne) und Pillow in die venv für Pixel-Diffs.

Führen Sie setup.ps1 aus einem normalen PowerShell-Fenster aus – nicht aus einer Shell, die in einer gepackten App wie dem Store-Build von Claude Desktop gehostet wird, dessen %LOCALAPPDATA%-Schreibvorgänge virtualisiert sind (das Setup erkennt dies jetzt und verweigert). Wenn Sie ein ZIP heruntergeladen haben statt zu klonen, führen Sie zuerst Get-ChildItem -Recurse | Unblock-File aus.

Wenn setup.ps1 (oder ein beliebiges bootstrap\*.ps1) überhaupt nicht ausgeführt werden kann und ein Fehler zur Skriptausführung / „Ausführen von Skripts ist deaktiviert“ auftritt, blockiert Ihre Ausführungsrichtlinie nicht signierte Skripte. Entsperren Sie sie nur für das aktuelle Fenster – kein Administrator, keine dauerhafte Richtlinienänderung – und führen Sie dann erneut aus:

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

Authentifizierung: Die Standardinstallation ist nur auf Loopback beschränkt und die Authentifizierung ist AUS – das Setup fragt nie nach, und auf Ihrem eigenen Rechner ist kein Token erforderlich. Die Bindung an das LAN ist der einzige Fall, der eine Authentifizierung erfordert: Installieren Sie mit .\bootstrap\setup.ps1 -EnableAuth (siehe docs/security.md). Wenn eine UI/API unerwartet nach einem Bearer-Token fragt, hat eine frühere Installation die Authentifizierung aktiviert – führen Sie das Setup erneut mit -NoAuth aus, um sie zu deaktivieren.

Zum Entfernen einer Installation (oder zum Zurücksetzen vor einer sauberen Neuinstallation): .\bootstrap\uninstall.ps1 stoppt und deaktiviert die geplanten Aufgaben und räumt übrig gebliebene CDP-Chrome-Prozesse auf; fügen Sie -All hinzu, um auch den Zustand (ausgestellte Tokens, Chrome-Profil, gespeicherte Authentifizierungswahl) und die venv zu löschen.

Related MCP server: tiacommander-mcp

Start der Studio-Bridge (5 Minuten)

1. Einmalige Bridge-Einrichtung (pro Projekt): Klicken Sie im Studio-Projektbaum mit der rechten Maustaste auf NetLogic → fügen Sie eine neue DesignTime NetLogic mit dem Namen StudioMCPBridge hinzu, doppelklicken Sie darauf, um den C#-Editor zu öffnen, und fügen Sie studio-bridge/StudioMCPBridge.cs ein (stellen Sie sicher, dass Sie in Ihrem Code-Editor neu erstellen oder in Studio speichern, um einen Neubuild auszulösen).

2. Projekt einrichten einmal pro Studio-Sitzung: Rechtsklick auf StudioMCPBridge → SetupProject → Dies fügt nur eine WebUI für den Validierungszugriff unter localhost:8081 hinzu.

3. Bridge starten einmal pro Studio-Sitzung: Rechtsklick auf StudioMCPBridge → StartBridge → akzeptieren Sie die einmalige Sicherheitsabfrage von Studio.

4. Bridge-Gesundheit überprüfen: Die Studio-Ausgabe zeigt listening on http://127.0.0.1:8768 (die Bridge). Das Service-Dashboard unter http://127.0.0.1:8765/ui zeigt ebenfalls den Bridge-Status.

Cowork (5 Minuten)

Voraussetzungen: MCP-Server und Bridge laufen. Claude-Desktop-App heruntergeladen.

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

Starten Sie Claude Desktop neu (möglicherweise müssen Sie den Prozess im Task-Manager beenden, um einen vollständigen Neustart zu erreichen), und bitten Sie Claude dann, "run optix_status(action='doctor')" auszuführen – es meldet alles Fehlende mit einer verständlichen Lösung für jeden Punkt. In den Einstellungen > Connectors können Sie die Berechtigungen für jedes Werkzeug anpassen.

Claude Code (5 Minuten)

Voraussetzungen: MCP-Server gesund und Claude in der CLI verfügbar.

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

Führen Sie dann in Claude Code /mcp aus und bestätigen Sie, dass ftx-mcp als verbunden angezeigt wird.

Visual Studio Code (5 Minuten)

Erstellen oder öffnen Sie .vscode/mcp.json und fügen Sie hinzu:

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

Ihre erste Änderung

1. Bitten Sie um eine Änderung, z. B. „Fügen Sie mit dem ftx-mcp einen Start- und Stopp-Button hinzu, der Model/MotorRun auf MainWindow umschaltet, und verifizieren Sie es mit einem Label mit dem Text ‚MOTOR RUNNING‘, dessen Sichtbarkeit an MotorRun gebunden ist.“

2. Beobachten Sie, wie es funktioniert: Autor → Emulator-Vorschau → Screenshot → und wenn es richtig aussieht, stellen Sie es wie gewohnt von Studio aus auf Ihrer Hardware bereit.

Was es kann

• Autor Widgets, Eigenschaften, Bindungen, berechnete Ausdrücke, Ereignisse, Übersetzungen und Multi-Screen-Navigation – live im geöffneten Studio-Projekt.

• Ausführen des integrierten Emulators von Studio über die F5-Taste und Lesen des Laufzeitprotokolls.

• Verifizieren durch Betrachten der WebUI: Screenshot, Klicken auf Schaltflächen und Tabs, Eingeben in Felder.

• Übergabe an Sie zum Ausliefern, wenn die Vorschau richtig aussieht – Sie stellen wie gewohnt von Studio aus bereit. Diese Distribution führt nur den Emulator aus.

Die vollständige Werkzeugliste (33 Werkzeuge standardmäßig – Gate-Umgebungsvariablen können mehr hinzufügen – plus dieselbe Oberfläche über einfaches HTTP für Skripte und CI) finden Sie in docs/tool-reference.md. Token-Ökonomie: Screenshots kosten jeweils ~1-2k Vision-Tokens; die OCR-Werkzeugfamilie (optix_cdp_read_text, find_text, navigate, sweep/diff) verwandelt die meisten Prüfungen in kostenlose Textlesungen – siehe die Playbooks optix-blind-authoring und optix-visual-regression für den Workflow (das Setup installiert Tesseract automatisch; -NoOcr deaktiviert es).

Gebündelte Authoring-Playbooks (Navigation, gebundene Steuerelemente, Stile, Ausdrücke) werden mit dem Server selbst ausgeliefert – Claude entdeckt sie über optix_list_skills / optix_get_skill, sodass jeder verbundene Client sie ohne Einrichtung erhält. (In Claude Code werden sie auch nativ als Skills geladen.)

Sicherheits- und Schutzmaßnahmen

• Nur lokal. Der Dienst bindet an 127.0.0.1 und kommuniziert mit nichts außerhalb des Rechners. Optionale Bearer-Token-Authentifizierung, erzwungen vor jeder LAN-Bindung.

• Standardmäßig schreibgeschützt. Jedes Werkzeug trägt MCP-readOnlyHint- / destructiveHint-Annotationen (vertraglich durch Tests festgelegt), sodass Ihr MCP-Host Lesezugriffe automatisch genehmigen und Schreibvorgänge gaten kann.

• Schreib-Gates, nicht Hoffnung. Nicht deklarierte Eigenschaften, Array-Schreibvorgänge, doppelte Namen und unsichere Neu-Elternschaft werden mit typisierten Fehlern abgelehnt; zusammengesetzte Operationen werden bei Fehlern zurückgerollt. Dateiebene-Änderungen werden abgelehnt, während Studio das Projekt geöffnet hat.

• Geprüft. Jede Modellmutation fügt eine JSON-Zeile zu einem lokalen Prüfpfad hinzu (%LOCALAPPDATA%\ftx-mcp\logs\audit.jsonl) – was, wann, Ergebnis.

• Das Ausliefern bleibt in Ihren Händen. Die Vorschau berührt niemals Ihre Laufzeit; das Bereitstellen auf Hardware erfolgt ausschließlich über Studio. Diese Distribution führt Designzeit-Änderungen und Tests über den Emulator durch.

Die vollständige Haltung einschließlich der Analyse der Prompt-Injection-Oberfläche finden Sie in SECURITY.md.

Dokumentation

Kompatibilität

Getestet mit FactoryTalk Optix Studio 1.7.x unter Windows 11, Python 3.12. Das Verhalten der Optix-CLI ist über Hauptversionen hinweg nicht vertraglich stabil – pinnen Sie Ihre Studio-Version in der Produktion.

Lizenz

MIT · © 2026 ASQI · Nicht verbunden mit oder unterstützt von Rockwell Automation. FactoryTalk Optix ist eine Marke von Rockwell Automation, Inc.; dieses Projekt orchestriert lokal installierte Optix-Binärdateien, ohne sie weiterzuverteilen. Siehe NOTICE.