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로 건너뛸 수 있음; 다른 모든 기능은 그것 없이도 작동함). 픽셀 diff를 위해 venv에 Pillow도 설치합니다.

일반 PowerShell 창에서 setup.ps1을 실행하세요 — Claude Desktop의 Store 빌드처럼 패키지된 앱 내부에서 호스팅되는 셸이 아닌 창에서 말입니다. 그런 앱의 %LOCALAPPDATA% 쓰기는 가상화되어 있기 때문입니다(설정은 이제 이를 감지하고 거부합니다). ZIP을 다운로드했지 클론하지 않았다면, 먼저 Get-ChildItem -Recurse | Unblock-File을 실행하세요.

setup.ps1(또는 bootstrap\*.ps1)이 스크립트 실행 / "running scripts is disabled" 오류로 전혀 실행되지 않으면, 머신의 실행 정책이 서명되지 않은 스크립트를 차단하고 있는 것입니다. 현재 창에 대해서만 차단을 해제하세요 — 관리자 권한도, 영구적인 정책 변경도 필요 없습니다 — 그런 다음 다시 실행하세요:

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

인증: 기본 설치는 루프백 전용이며 인증이 꺼져 있습니다 — 설정은 프롬프트를 표시하지 않으며, 자신의 머신에서는 토큰이 필요 없습니다. LAN에 바인딩하는 것이 인증이 필요한 유일한 경우입니다: .\bootstrap\setup.ps1 -EnableAuth로 설치하세요(docs/security.md 참조). UI/API가 예기치 않게 bearer 토큰을 요구하면, 이전 설치에서 인증이 활성화된 것입니다 — -NoAuth로 설정을 다시 실행하여 해제하세요.

설치를 제거하려면(또는 깨끗한 재설치 전에 초기화하려면): .\bootstrap\uninstall.ps1이 예약된 작업을 중지하고 등록을 해제하며 남은 CDP chrome을 정리합니다. -All을 추가하면 상태(발급된 토큰, chrome 프로필, 저장된 인증 선택)와 venv도 삭제합니다.

Related MCP server: tiacommander-mcp

Studio 브리지 시작 (5분)

1. 일회성 브리지 설정(프로젝트별): Studio 프로젝트 트리에서 NetLogic을 마우스 오른쪽 버튼으로 클릭 → 새 DesignTime NetLogic을 추가하고 이름을 StudioMCPBridge로 지정한 다음, 더블클릭하여 C# 편집기를 열고 studio-bridge/StudioMCPBridge.cs를 붙여넣으세요(코드 편집기에서 다시 빌드하거나 Studio에서 저장하여 다시 빌드를 트리거해야 합니다)

2. Studio 세션당 한 번 프로젝트 설정: StudioMCPBridge를 마우스 오른쪽 버튼으로 클릭 → SetupProject → 이렇게 하면 localhost:8081에 검증 액세스용 webui가 추가됩니다.

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 데스크톱 앱이 다운로드되어 있어야 합니다.

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 프로젝트에 실시간으로 반영됩니다.

• 실행: F5 키로 Studio의 내장 에뮬레이터를 실행하고 런타임 로그를 읽습니다.

• 검증: 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에 바인딩되며 머신 외부와 통신하지 않습니다. 선택적 bearer 토큰 인증은 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를 참조하세요.