GPT Windows Connector

원격 우선, 다중 사용자 Windows 실행 MCP로 ChatGPT, Claude, Gemini 및 기타 MCP 호환 AI 클라이언트를 지원합니다.

이 제품은 VPS 게이트웨이를 통해 로컬 프로젝트 파일, Shell, 장기 실행 프로세스, Git, 브라우저 자동화 및 Windows 데스크톱/UI Automation을 제공합니다. Codex, Claude Code, Gemini CLI는 실행 계층으로 사용되지 않습니다.

최종 아키텍처

ChatGPT / Claude / Gemini / other Remote-MCP client
                    |
                    | HTTPS / MCP
                    v
              VPS Gateway
          account / projects / logs
                    |
                    | WSS
                    v
              Windows Node
                    |
        files / shell / git / browser / desktop

모든 AI-to-Windows 트래픽은 VPS를 통해 중계됩니다. Windows 컴퓨터는 아웃바운드 WSS 연결을 설정하며 공용 인바운드 포트가 필요하지 않습니다.

Related MCP server: pywinauto-mcp

사용자 경험

1. VPS 게이트웨이 웹사이트를 엽니다.

2. 이메일/비밀번호로 가입하거나 Google로 로그인합니다.

3. Windows Nodes에서 Windows 컴퓨터를 페어링합니다.

4. Projects에서 프로젝트를 생성합니다.

5. 온라인 상태인 Windows 컴퓨터를 선택합니다.

6. 해당 컴퓨터의 허용된 폴더 트리를 탐색하고 작업 공간을 선택합니다.

7. 동일한 계정을 사용하여 AI 클라이언트에 Remote MCP 엔드포인트를 연결합니다.

8. AI가 프로젝트 ID를 사용하며, VPS가 올바른 사용자, Windows Node 및 작업 공간을 자동으로 확인합니다.

의도적으로 대화 바인딩은 없습니다.

(user_id, project_id)
        |
        +-- node_id
        `-- workspace

내장 VPS 대시보드

gwc-gateway를 실행하면 웹 대시보드와 Remote MCP 엔드포인트가 함께 제공됩니다.

대시보드 섹션:

• Dashboard — 프로젝트/노드/활동 개요

• Projects — 프로젝트 → Windows 컴퓨터 → 폴더 바인딩

• Windows Nodes — 온라인/오프라인 노드 및 일회성 페어링 코드

• Activity Logs — 사용자 범위 감사 내역 및 필터

• Account & Security — 계정/제공자 및 보안 정보

폴더 선택기는 VPS 파일 시스템을 읽지 않습니다. VPS WebSocket을 통해 선택한 Windows Node에서 디렉터리 정보를 요청하며 GWC_ALLOWED_ROOTS 내부의 디렉터리만 노출합니다.

인증

지원되는 로그인 방식:

• 이메일/비밀번호 등록 및 로그인

• Google OAuth 2.0 / OpenID Connect

• MCP/API 클라이언트용 JWT 액세스 토큰

• 내장 웹 대시보드용 HttpOnly 로그인 쿠키

비밀번호는 Argon2로 해시됩니다. 사용자/프로젝트/노드/감사 데이터는 VPS의 gateway.db SQLite 데이터베이스에 저장됩니다. GWC_JWT_SECRET이 생략되면 임의의 시크릿이 한 번 생성되어 GWC_DATA_DIR 아래에 저장됩니다.

Google 로그인

Google OAuth 웹 애플리케이션을 생성하고 다음을 구성합니다:

GWC_GOOGLE_CLIENT_ID=...
GWC_GOOGLE_CLIENT_SECRET=...
GWC_GOOGLE_REDIRECT_URI=https://gwc.example.com/auth/google/callback

GWC_GOOGLE_REDIRECT_URI가 클라이언트 ID/시크릿이 있는 상태에서 생략되면 게이트웨이는 GWC_PUBLIC_BASE_URL에서 이를 파생합니다. Google 로그인은 기본적으로 내장 대시보드로 돌아갑니다.

프로젝트 바인딩 및 폴더 선택기

Windows Node는 구성된 허용 루트만 광고합니다:

$env:GWC_ALLOWED_ROOTS = "G:\;D:\Projects"

VPS 대시보드는 다음을 탐색할 수 있습니다:

Office-PC
├─ G:\
│  ├─ NiceC-WMS
│  ├─ OpenAkita
│  └─ PartyGame
└─ D:\Projects
   └─ another-project

선택한 프로젝트 바인딩은 VPS에 저장됩니다:

user_id + "NiceC-WMS"
  -> Office-PC
  -> G:\NiceC-WMS

Node는 게이트웨이가 저장하기 전에 선택한 폴더를 검증합니다. 허용 루트 외부의 경로는 거부됩니다.

MCP 도구

프로젝트 및 노드

• project_bind

• project_get

• project_list

• project_unbind

• node_pair

• node_list

• control_acquire

• control_status

• control_release

파일

files_tool(project_id, action, params)는 다음을 지원합니다:

• list

• read

• write

• patch

• search

• stat

• mkdir

• move

• copy

• delete

직접 파일 작업은 프로젝트의 바인딩된 작업 공간 내에서 샌드박싱됩니다.

Shell 및 프로세스

• shell_run — PowerShell/CMD, stdout/stderr/종료 코드, 타임아웃

• process_tool — 증분 출력 커서를 사용한 start/poll/stop/list

Git

git_tool은 status, diff, log, branch, branch create/switch, add, commit, pull, push, show를 지원합니다.

브라우저

browser_tool은 브라우저 검색, CDP 연결, 영구 프로필 실행, 탭/페이지, 탐색, DOM 검사, 클릭/입력/선택, 작업 공간 범위 업로드/다운로드, 스크린샷, 닫기를 지원합니다.

Windows 데스크톱

computer_tool은 시스템/프로세스 정보, 애플리케이션 실행, 창 목록/활성화, 스크린샷, 마우스/키보드, 클립보드, Windows UI Automation 검사/클릭/텍스트 입력을 지원합니다.

활동 로그

VPS는 사용자 범위의 감사 이벤트를 gateway.db에 기록합니다. 대시보드는 인증된 사용자의 레코드만 표시합니다. 비밀번호, 액세스 토큰, 인증 헤더, 쿠키, 클립보드 데이터 및 전체 콘텐츠 값과 같은 민감한 필드는 UI API에 의해 편집됩니다.

다중 노드 및 제어 잠금

하나의 계정에 여러 Windows 컴퓨터를 둘 수 있습니다:

Gateway
├─ Office-PC
├─ Warehouse-PC
└─ Home-PC

대화형 브라우저/데스크톱 작업은 노드별 프로젝트 임대를 사용하므로 두 프로젝트가 동일한 마우스/창을 두고 경쟁하지 않습니다.

권한 수준

각 Windows Node에 설정:

GWC_PERMISSION_LEVEL=read | operate | admin

• read: 검사/읽기 메서드만 허용

• operate: 일반 코딩 및 자동화

• admin: 직접 파일 삭제 및 Git push도 허용

GWC_ALLOWED_ROOTS는 직접 커넥터 파일 작업 및 작업 공간 선택에 대한 엄격한 경계입니다. Shell 명령은 여전히 일반 Windows 계정 권한으로 실행되므로 강력한 OS 수준 격리가 필요한 경우 전용 낮은 권한의 Windows 사용자 또는 VM을 사용하세요.

VPS에 게이트웨이 설치

Python 3.11+:

git clone https://github.com/Neal86/gpt-windows-connector.git
cd gpt-windows-connector
python -m venv .venv
source .venv/bin/activate
pip install -e .

구성:

export GWC_HOST=0.0.0.0
export GWC_PORT=8787
export GWC_DATA_DIR=./data
export GWC_PUBLIC_BASE_URL=https://gwc.example.com
gwc-gateway

공개 엔드포인트:

Dashboard:   https://gwc.example.com/
Remote MCP:  https://gwc.example.com/mcp
Node WSS:    wss://gwc.example.com/ws/node
Health:      https://gwc.example.com/health

Dockerfile과 docker-compose.yml이 포함되어 있습니다. 프로덕션에서는 서비스 앞에 HTTPS/WSS를 두십시오.

Windows Node 설치

Windows에 패키지를 설치하고 VPS 대시보드에서 일회성 페어링 코드를 생성한 후 다음을 실행합니다:

$env:GWC_NODE_ID = "Office-PC"
$env:GWC_NODE_NAME = "Office PC"
$env:GWC_GATEWAY_WS = "wss://gwc.example.com/ws/node"
$env:GWC_PAIRING_CODE = "123456"
$env:GWC_ALLOWED_ROOTS = "G:\;D:\Projects"
$env:GWC_PERMISSION_LEVEL = "operate"
gwc-node

성공적으로 페어링되면 게이트웨이는 영구적인 임의 노드 토큰을 발급합니다. Node는 현재 사용자의 로컬 앱 데이터 디렉터리에 저장하고 하트비트 및 지수 백오프로 자동 재연결합니다.

보안

• 프로덕션에서는 HTTPS/WSS를 사용하세요.

• GWC_ALLOWED_ROOTS를 제한하세요.

• read 또는 operate를 선호하고 꼭 필요한 경우에만 admin을 부여하세요.

• JWT 및 영구 노드 토큰을 비밀로 취급하세요.

• 실용적인 경우 전용 Windows 계정으로 Windows Node를 실행하세요.

• MCP Python SDK는 >=1.27.2,<2로 고정되고 명시적 Host/Origin 전송 보안이 활성화됩니다.

• Windows Node는 아웃바운드 전용입니다. 로컬 CDP, Shell 또는 Node 포트를 공개적으로 노출하지 마세요.

의도된 코딩 루프

AI -> VPS -> Windows Node
   read/search code
   -> patch/write
   -> build/test
   -> inspect errors
   -> patch again
   -> git diff/status
   -> commit/push when permitted
   -> VPS -> AI

저장소는 CursorTouch/Windows-MCP와 독립적입니다. Windows-MCP는 런타임에 필요하지 않습니다.