ftx-mcp

FactoryTalk Optix プロジェクトと対話できます。 ftx-mcp は、AI ツール (Desktop、Cowork、Code — または任意の MCP クライアント) を Windows マシン上の FactoryTalk Optix Studio に接続し、HMI 画面を説明するだけで作成・変更できるようにします:

"Screen 1 に 'Hello Optix' と表示されるヘッダーを追加して、表示して。"

"そのラベルの可視性を Model/PumpRunning にバインドして。"

"良さそうだ。エミュレータを起動して検証して。"

LLM が変更を開いている Studio プロジェクトに直接書き込み、エミュレータを実行し、 レンダリングされたランタイムを確認して動作を確認します。これは開発・テストの コンパニオンです。ハードウェアへの出荷は Studio の Deploy ダイアログで、あなたの 手で行います。LLM 呼び出し以外はすべてローカルマシン上で実行されます。クラウド サービスも API キーも不要で、インテリジェンスはお好みの LLM が提供します。

ブログ記事

インストール (10 分)

要件: Windows 11、FactoryTalk Optix Studio 1.7.x、および Claude Cowork などの MCP クライアント。また、Google Chrome (CDP 検証ループ。setup.ps1 -NoCdp で スキップ可能) と — Claude Desktop Microsoft Store ビルド コネクタパスの場合 — Node.js (winget install OpenJS.NodeJS.LTS; 設定では npx mcp-remote を使用)。 セットアップは winget 経由で Tesseract OCR を自動インストールし、ゼロビジョン トークンのテキストツールを有効にします (-NoOcr でスキップ可能。それ以外は すべて動作します)。また、ピクセル差分用に Pillow を venv にインストールします。

setup.ps1 は通常の PowerShell ウィンドウから実行してください — Claude Desktop の Store ビルドのようなパッケージ化されたアプリ内でホストされているシェルでは 実行しないでください。その場合 %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

認証: デフォルトのインストールはループバックのみで認証 OFF です — セットアップは プロンプトを表示せず、自分のマシンではトークンは不要です。LAN にバインドする場合のみ 認証が必要です: .\bootstrap\setup.ps1 -EnableAuth でインストールします (docs/security.md を参照)。UI/API が予期せずベアラートークンを 要求する場合、以前のインストールで認証が有効になっています — -NoAuth を指定して セットアップを再実行してクリアしてください。

インストールを削除する場合 (またはクリーンな再インストール前にリセットする場合): .\bootstrap\uninstall.ps1 はスケジュールされたタスクを停止・登録解除し、残った CDP chrome を回収します。-All を追加すると、状態 (発行済みトークン、chrome プロファイル、永続化された認証選択) と venv も削除します。

Related MCP server: tiacommander-mcp

Studio ブリッジを開始する (5 分)

1. 1 回限りのブリッジセットアップ (プロジェクトごと): Studio プロジェクト ツリーで NetLogic を右クリック → 新しい DesignTime NetLogic を追加し、 StudioMCPBridge という名前を付け、ダブルクリックして C# エディタを開き、 studio-bridge/StudioMCPBridge.cs を貼り付けます (コードエディタでリビルドするか、Studio で保存してリビルドをトリガーしてください)

2. プロジェクトをセットアップ (Studio セッションごとに 1 回): StudioMCPBridge を右クリック → SetupProject → これにより、localhost:8081 に検証アクセス用の webui が追加されます

3. ブリッジを開始 (Studio セッションごとに 1 回): StudioMCPBridge を 右クリック → StartBridge → Studio の 1 回限りのセキュリティプロンプトを 受け入れます。

4. ブリッジのヘルスを確認: Studio の出力に listening on http://127.0.0.1:8768 (ブリッジ) と表示されます。サービスダッシュボード http://127.0.0.1:8765/ui でも ブリッジのステータスを確認できます。

Cowork (5 分)

要件: MCP サーバーとブリッジが実行されていること。Claude デスクトップアプリが ダウンロードされていること。

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')" を実行するよう依頼します — 不足しているものがあれば、各項目の平易な英語での修正方法と ともに報告されます。設定 > コネクタで、各ツールの権限を調整できます。

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 を使用して、MainWindow に Model/MotorRun を トグルする開始ボタンと停止ボタンを追加し、'MOTOR RUNNING' というテキストで MotorRun に可視性がバインドされたラベルで動作を確認して。"

2. 動作を確認します: 作成 → エミュレータプレビュー → スクリーンショット → そして 問題なければ、通常どおり Studio からハードウェアにデプロイします。

できること

• 作成: ウィジェット、プロパティ、バインディング、計算式、イベント、翻訳、 複数画面ナビゲーションを、開いている Studio プロジェクトにライブで行います。

• 実行: Studio 組み込みのエミュレータを F5 キーで起動し、ランタイムログを 読み取ります。

• 検証: webui を確認します: スクリーンショット、ボタンやタブのクリック、 フィールドへの入力。

• 出荷はあなたに返却: プレビューが問題なければ、通常どおり Studio から デプロイします。このディストリビューションはエミュレータのみを実行します。

完全なツールリスト (デフォルトで 33 ツール — ゲート環境変数で追加可能 — さらに スクリプトや CI 用に同じサーフェスをプレーン HTTP で提供) は docs/tool-reference.md にあります。 トークン経済: スクリーンショットは各 ~1-2k ビジョントークン。OCR ツール ファミリー (optix_cdp_read_text、find_text、navigate、sweep/diff) は ほとんどのチェックを無料のテキスト読み取りに変えます — ワークフローについては optix-blind-authoring および optix-visual-regression プレイブックを参照して ください (セットアップは tesseract を自動インストールします。-NoOcr でオプトアウト 可能)。

バンドルされたオーサリングプレイブック (ナビゲーション、バインドされたコントロール、 スタイル、式) はサーバー自体に同梱されています — Claude は optix_list_skills / optix_get_skill でそれらを発見するため、接続されたすべてのクライアントがセットアップ 不要で利用できます。(Claude Code では skills としてネイティブに読み込まれます。)

セキュリティと安全性の姿勢

• ローカルのみ。 サービスは 127.0.0.1 にバインドされ、マシン外とは通信しません。 オプションのベアラートークン認証。LAN バインドの前に強制されます。

• デフォルトで読み取り専用。 すべてのツールは MCP readOnlyHint / destructiveHint アノテーション (テストでコントラクト固定) を保持するため、MCP ホストは読み取りを自動承認し、書き込みをゲートできます。

• 書き込みゲート、期待ではなく。 未宣言のプロパティ、配列書き込み、重複名、 安全でない再親化は型付きエラーで拒否されます。複合操作は失敗時にロールバック されます。Studio がプロジェクトを開いている間、ファイルレベルの編集は拒否されます。

• 監査。 すべてのモデル変更はローカルの監査証跡 (%LOCALAPPDATA%\ftx-mcp\logs\audit.jsonl) に JSON 行を追加します — 何を、 いつ、結果。

• 出荷はあなたの手に。 プレビューはランタイムに触れません。ハードウェアへの デプロイは Studio から行われます。このディストリビューションは設計時編集と エミュレータによるテストを行います。

プロンプトインジェクションの表面分析を含む完全な姿勢は SECURITY.md にあります。

ドキュメント

互換性

Windows 11、Python 3.12 上の FactoryTalk Optix Studio 1.7.x でテスト済み。 Optix CLI の動作はメジャーバージョン間でコントラクト安定ではありません — 本番環境では Studio のバージョンを固定してください。

ライセンス

MIT · © 2026 ASQI · Rockwell Automation とは提携・承認関係にありません。 FactoryTalk Optix は Rockwell Automation, Inc. の商標です。このプロジェクトは ローカルにインストールされた Optix バイナリを再配布せずにオーケストレーションします。 NOTICE を参照してください。