GPT Windows Connector

リモートファースト、マルチユーザー対応のWindows実行環境MCP。ChatGPT、Claude、Gemini、その他のMCP互換AIクライアント向け。

本製品は、VPSゲートウェイを介してローカルプロジェクトファイル、シェル、長時間実行プロセス、Git、ブラウザ自動化、Windowsデスクトップ/UIオートメーションを公開します。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からWindowsへのすべてのトラフィックはVPSを経由して中継されます。WindowsコンピュータはアウトバウンドWSS接続を行い、パブリックなインバウンドポートは必要ありません。

Related MCP server: pywinauto-mcp

ユーザーエクスペリエンス

1. VPSゲートウェイのウェブサイトを開く。

2. メール/パスワードで登録するか、Googleでサインインする。

3. Windows NodesからWindowsコンピュータをペアリングする。

4. Projectsからプロジェクトを作成する。

5. オンラインのWindowsコンピュータを選択する。

6. そのコンピュータの許可されたフォルダツリーを参照し、ワークスペースを選択する。

7. 同じアカウントを使用してRemote MCPエンドポイントをAIクライアントに接続する。

8. AIはプロジェクトIDを使用し、VPSが自動的に正しいユーザー、Windows Node、ワークスペースを解決する。

意図的に会話のバインディングはありません。

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

内蔵VPSダッシュボード

gwc-gatewayを実行すると、WebダッシュボードとRemote MCPエンドポイントの両方が提供されます。

ダッシュボードセクション：

• Dashboard — プロジェクト/ノード/アクティビティの概要

• Projects — プロジェクト → Windowsコンピュータ → フォルダのバインディング

• Windows Nodes — オンライン/オフラインのノードとワンタイムペアリングコード

• Activity Logs — フィルター付きのユーザースコープ監査履歴

• Account & Security — アカウント/プロバイダーとセキュリティ情報

フォルダピッカーはVPSのファイルシステムを読み取りません。選択されたWindows NodeからVPS WebSocketを介してディレクトリ情報を要求し、GWC_ALLOWED_ROOTS内のディレクトリのみを公開します。

認証

サポートされているログイン方法：

• メール/パスワードによる登録とログイン

• Google OAuth 2.0 / OpenID Connect

• MCP/APIクライアント用のJWTアクセストークン

• 内蔵Webダッシュボード用のHttpOnlyログインCookie

パスワードはArgon2でハッシュ化されます。ユーザー/プロジェクト/ノード/監査データはVPSのgateway.db SQLiteデータベースに保存されます。GWC_JWT_SECRETが省略された場合、ランダムなシークレットが一度生成され、GWC_DATA_DIR下に永続化されます。

Googleログイン

Google OAuth Webアプリケーションを作成し、以下を設定します：

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

クライアントID/シークレットが存在する状態でGWC_GOOGLE_REDIRECT_URIが省略された場合、ゲートウェイは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_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オートメーションの検査/クリック/テキスト入力をサポートします。

アクティビティログ

VPSはユーザースコープの監査イベントをgateway.dbに書き込みます。ダッシュボードは認証されたユーザーのレコードのみを公開します。パスワード、アクセストークン、認証ヘッダー、Cookie、クリップボードデータ、完全なコンテンツ値などの機密フィールドはUI APIによって編集されます。

マルチノードと制御ロック

1つのアカウントで複数のWindowsコンピュータを持つことができます：

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

インタラクティブなブラウザ/デスクトップ操作はノードごとのプロジェクトリースを使用するため、2つのプロジェクトが同じマウス/ウィンドウを巡って競合することはありません。

権限レベル

各Windows Nodeに設定：

GWC_PERMISSION_LEVEL=read | operate | admin

• read: 検査/読み取りメソッドのみ

• operate: 通常のコーディングと自動化

• admin: 直接ファイル削除とGit pushも許可

GWC_ALLOWED_ROOTSはコネクタの直接ファイル操作とワークスペース選択のハードバウンダリです。シェルコマンドは通常の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は実行時に必要ありません。