ftx-mcp

Общайтесь со своим проектом FactoryTalk Optix. ftx-mcp подключает AI-инструменты (Desktop, Cowork, Code — или любой MCP-клиент) к FactoryTalk Optix Studio на вашем компьютере с Windows, чтобы вы могли создавать и изменять HMI-экраны, описывая, что вам нужно:

«Добавь заголовок с текстом „Hello Optix“ на Screen 1 и покажи мне».

«Привяжи видимость этой метки к Model/PumpRunning».

«Выглядит правильно. Запусти эмулятор и проверь».

Ваша LLM вносит изменения прямо в открытый проект Studio, запускает эмулятор и смотрит на отрисованный runtime, чтобы убедиться, что всё работает. Это инструмент для разработки и тестирования: отправка на оборудование остаётся в собственном диалоге Deploy в Studio, в ваших руках. Всё, кроме вызовов LLM, выполняется локально на вашем компьютере. Никакого облачного сервиса, никакого API-ключа; интеллект обеспечивает выбранная вами LLM.

Запись в блоге

Установка (10 минут)

Требования: Windows 11, FactoryTalk Optix Studio 1.7.x и MCP-клиент, например Claude Cowork. Также: Google Chrome (цикл проверки CDP; можно пропустить с setup.ps1 -NoCdp) и — для пути подключения Microsoft Store build в Claude Desktop — Node.js (winget install OpenJS.NodeJS.LTS; в конфигурации используется npx mcp-remote). Установщик автоматически устанавливает Tesseract OCR через winget для текстовых инструментов без затрат vision-токенов (пропустите с -NoOcr; всё остальное работает и без него) и Pillow в виртуальное окружение для сравнения пикселей.

Запустите setup.ps1 из обычного окна PowerShell — не из оболочки, размещённой внутри упакованного приложения, такого как Store-версия Claude Desktop, чьи записи в %LOCALAPPDATA% виртуализированы (установщик теперь обнаруживает это и отказывается работать). Если вы скачали ZIP-архив, а не клонировали репозиторий, сначала выполните Get-ChildItem -Recurse | Unblock-File.

Если setup.ps1 (или любой bootstrap\*.ps1) вообще не запускается с ошибкой выполнения сценария / «выполнение сценариев отключено», ваша политика выполнения блокирует неподписанные сценарии. Разблокируйте их только для текущего окна — без прав администратора, без постоянного изменения политики — затем запустите снова:

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

Аутентификация: установка по умолчанию работает только через loopback с отключённой аутентификацией — установщик никогда не запрашивает её, и токен не нужен на вашем собственном компьютере. Привязка к локальной сети — единственный случай, требующий аутентификации: установите с .\bootstrap\setup.ps1 -EnableAuth (см. docs/security.md). Если UI/API неожиданно запрашивает bearer-токен, значит, предыдущая установка включила аутентификацию — повторно запустите установщик с -NoAuth, чтобы сбросить её.

Чтобы удалить установку (или сбросить перед чистой переустановкой): .\bootstrap\uninstall.ps1 останавливает и отменяет регистрацию запланированных задач и завершает оставшиеся процессы CDP chrome; добавьте -All, чтобы также удалить состояние (выданные токены, профиль chrome, сохранённый выбор аутентификации) и виртуальное окружение.

Related MCP server: tiacommander-mcp

Запуск моста Studio (5 минут)

1. Одноразовая настройка моста (для каждого проекта): в дереве проекта Studio щёлкните правой кнопкой мыши NetLogic → добавьте новый DesignTime NetLogic с именем StudioMCPBridge, дважды щёлкните его, чтобы открыть редактор C#, и вставьте содержимое studio-bridge/StudioMCPBridge.cs (убедитесь, что пересобрали в редакторе кода или сохранили в Studio, чтобы запустить пересборку)

2. Настройте проект один раз за сеанс Studio: щёлкните правой кнопкой мыши StudioMCPBridge → SetupProject → это просто добавляет webui для доступа к проверке на localhost:8081

3. Запустите мост один раз за сеанс Studio: щёлкните правой кнопкой мыши StudioMCPBridge → StartBridge → примите одноразовое предупреждение безопасности Studio.

4. Проверьте работоспособность моста: в выводе Studio появится listening on http://127.0.0.1:8768 (мост). Панель мониторинга сервиса на http://127.0.0.1:8765/ui также показывает статус моста.

Cowork (5 минут)

Требования: MCP-сервер и мост запущены. Приложение Claude desktop скачано.

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

Перезапустите Claude Desktop (возможно, придётся завершить процесс в диспетчере задач для полного перезапуска), затем попросите Claude "run optix_status(action='doctor')" — он сообщит обо всём отсутствующем с простым объяснением и способом исправления для каждого пункта. В настройках > connectors вы можете настроить разрешения для каждого инструмента.

Claude Code (5 минут)

Требования: MCP-сервер работает, и claude доступен в CLI.

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

Затем в Claude Code выполните /mcp и убедитесь, что ftx-mcp отображается как подключённый.

Visual Studio Code (5 минут)

Создайте или откройте .vscode/mcp.json и добавьте:

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

Ваше первое изменение

1. Попросите о изменении, например: «Используя ftx mcp, добавь кнопки Start и Stop, которые переключают Model/MotorRun на MainWindow, и проверь, что это работает, с помощью метки с текстом „MOTOR RUNNING“, видимость которой привязана к MotorRun».

2. Наблюдайте за работой: автор → предпросмотр в эмуляторе → скриншот → и когда всё выглядит правильно, вы развёртываете на оборудовании из Studio как обычно.

Что он умеет

• Автор виджетов, свойств, привязок, вычисляемых выражений, событий, переводов и многоэкранной навигации — в реальном времени в открытом проекте Studio.

• Запуск встроенного эмулятора Studio с помощью клавиши F5 и чтение журнала выполнения.

• Проверка через webui: скриншот, клики по кнопкам и вкладкам, ввод текста в поля.

• Передача вам для выпуска — когда предпросмотр выглядит правильно, вы развёртываете из Studio как обычно. Эта дистрибуция запускает только эмулятор.

Полный список инструментов (по умолчанию 33 инструмента — переменные окружения gate могут добавить больше — плюс тот же интерфейс через обычный HTTP для сценариев и CI) приведён в docs/tool-reference.md. Экономия токенов: скриншоты стоят ~1-2 тыс. vision-токенов каждый; семейство инструментов OCR (optix_cdp_read_text, find_text, navigate, sweep/diff) превращает большинство проверок в бесплатные текстовые чтения — см. playbooks optix-blind-authoring и optix-visual-regression для рабочего процесса (установщик автоматически ставит tesseract; -NoOcr отключает).

Встроенные playbooks для авторинга (навигация, связанные элементы управления, стили, выражения) поставляются вместе с самим сервером — Claude обнаруживает их через optix_list_skills / optix_get_skill, поэтому каждый подключённый клиент получает их без какой-либо настройки. (В Claude Code они также загружаются нативно как skills.)

Безопасность и защита

• Только локально. Сервис привязан к 127.0.0.1 и не общается ни с чем за пределами компьютера. Необязательная аутентификация по bearer-токену, обязательная перед любой привязкой к LAN.

• Только чтение по умолчанию. Каждый инструмент несёт аннотации MCP readOnlyHint / destructiveHint (закреплённые тестами), чтобы ваш MCP-хост мог автоматически одобрять чтения и ограничивать записи.

• Гейты записи, а не надежда. Незадекларированные свойства, записи массивов, дублирующиеся имена и небезопасное перемещение родительских элементов отклоняются с типизированными ошибками; составные операции откатываются при сбое. Изменения на уровне файлов отклоняются, пока проект открыт в Studio.

• Аудит. Каждая мутация модели добавляет строку JSON в локальный журнал аудита (%LOCALAPPDATA%\ftx-mcp\logs\audit.jsonl) — что, когда, результат.

• Выпуск остаётся в ваших руках. Предпросмотр никогда не касается вашего runtime; развёртывание на оборудовании происходит из Studio, и точка. Эта дистрибуция выполняет правки на этапе проектирования и тестирование через эмулятор.

Полная позиция, включая анализ поверхности атак через prompt-injection, приведена в SECURITY.md.

Документация

Совместимость

Протестировано с FactoryTalk Optix Studio 1.7.x на Windows 11, Python 3.12. Поведение Optix CLI не является контрактно стабильным между основными версиями — зафиксируйте версию Studio в производстве.

Лицензия

MIT · © 2026 ASQI · Не аффилировано с Rockwell Automation и не одобрено ею. FactoryTalk Optix является товарным знаком Rockwell Automation, Inc.; этот проект управляет локально установленными бинарными файлами Optix, не распространяя их. См. NOTICE.