GPT Windows Connector

Remote-first, Multi-User Windows Execution MCP für ChatGPT, Claude, Gemini und andere MCP-kompatible KI-Clients.

Das Produkt stellt lokale Projektdateien, Shell, langlebige Prozesse, Git, Browser-Automatisierung und Windows Desktop/UI Automation über ein VPS-Gateway bereit. Codex, Claude Code und Gemini CLI werden nicht als Ausführungsschicht verwendet.

Endgültige Architektur

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

Der gesamte KI-zu-Windows-Datenverkehr wird über das VPS weitergeleitet. Ein Windows-Computer stellt eine ausgehende WSS-Verbindung her und benötigt keinen öffentlichen eingehenden Port.

Related MCP server: pywinauto-mcp

Benutzererfahrung

1. Öffnen Sie die VPS-Gateway-Website.

2. Registrieren Sie sich mit E-Mail/Passwort oder melden Sie sich mit Google an.

3. Koppeln Sie einen Windows-Computer unter Windows Nodes.

4. Erstellen Sie ein Projekt unter Projects.

5. Wählen Sie einen online verfügbaren Windows-Computer aus.

6. Durchsuchen Sie den erlaubten Ordnerbaum dieses Computers und wählen Sie einen Arbeitsbereich aus.

7. Verbinden Sie den Remote-MCP-Endpunkt mit dem KI-Client unter Verwendung desselben Kontos.

8. Die KI verwendet die Projekt-ID; das VPS löst automatisch den richtigen Benutzer, Windows-Node und Arbeitsbereich auf.

Es gibt bewusst keine Gesprächsbindung.

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

Integriertes VPS-Dashboard

Die Ausführung von gwc-gateway bedient sowohl das Web-Dashboard als auch den Remote-MCP-Endpunkt.

Dashboard-Bereiche:

• Dashboard — Projekt-/Node-/Aktivitätsübersicht

• Projects — Projekt → Windows-Computer → Ordnerbindungen

• Windows Nodes — Online-/Offline-Nodes und einmalige Kopplungscodes

• Activity Logs — benutzerspezifischer Audit-Verlauf mit Filtern

• Account & Security — Konto-/Anbieter- und Sicherheitsinformationen

Der Ordnerauswähler liest niemals das VPS-Dateisystem. Er fordert Verzeichnisinformationen vom ausgewählten Windows-Node über das VPS-WebSocket an und zeigt nur Verzeichnisse innerhalb von GWC_ALLOWED_ROOTS an.

Authentifizierung

Unterstützte Anmeldemethoden:

• Registrierung und Anmeldung mit E-Mail/Passwort

• Google OAuth 2.0 / OpenID Connect

• JWT-Zugriffstoken für MCP/API-Clients

• HttpOnly-Anmeldecookie für das integrierte Web-Dashboard

Passwörter werden mit Argon2 gehasht. Benutzer-/Projekt-/Node-/Auditdaten werden in der VPS-SQLite-Datenbank gateway.db gespeichert. Wenn GWC_JWT_SECRET weggelassen wird, wird ein zufälliges Geheimnis einmal generiert und unter GWC_DATA_DIR gespeichert.

Google-Anmeldung

Erstellen Sie eine Google OAuth-Webanwendung und konfigurieren Sie:

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

Wenn GWC_GOOGLE_REDIRECT_URI weggelassen wird, während Client-ID/Geheimnis vorhanden sind, leitet das Gateway sie von GWC_PUBLIC_BASE_URL ab. Die Google-Anmeldung kehrt standardmäßig zum integrierten Dashboard zurück.

Projektbindung und Ordnerauswähler

Der Windows-Node gibt nur konfigurierte erlaubte Wurzeln bekannt:

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

Das VPS-Dashboard kann durchsuchen:

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

Eine ausgewählte Projektbindung wird auf dem VPS gespeichert:

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

Der Node validiert den ausgewählten Ordner, bevor das Gateway ihn speichert. Pfade außerhalb der erlaubten Wurzeln werden abgelehnt.

MCP-Tools

Projekte und Nodes

• project_bind

• project_get

• project_list

• project_unbind

• node_pair

• node_list

• control_acquire

• control_status

• control_release

Dateien

files_tool(project_id, action, params) unterstützt:

• list

• read

• write

• patch

• search

• stat

• mkdir

• move

• copy

• delete

Direkte Dateioperationen sind auf den gebundenen Arbeitsbereich des Projekts beschränkt.

Shell und Prozesse

• shell_run — PowerShell/CMD, stdout/stderr/Exit-Code, Timeout

• process_tool — start/poll/stop/list mit inkrementellen Ausgabe-Cursorn

Git

git_tool unterstützt status, diff, log, branch, branch create/switch, add, commit, pull, push und show.

Browser

browser_tool unterstützt Browsererkennung, CDP-Anbindung, Starten eines persistenten Profils, Tabs/Seiten, Navigation, DOM-Inspektion, click/type/select, arbeitsbereichsbezogenes Hoch-/Herunterladen, Screenshots und Schließen.

Windows Desktop

computer_tool unterstützt System-/Prozessinformationen, Anwendungsstart, Fensterauflistung/-aktivierung, Screenshots, Maus/Tastatur, Zwischenablage und Windows UI Automation-Inspektion/Klick/Text-Eingabe.

Aktivitätsprotokolle

Das VPS schreibt benutzerspezifische Audit-Ereignisse in gateway.db. Das Dashboard zeigt nur die Datensätze des authentifizierten Benutzers an. Sensible Felder wie Passwörter, Zugriffstoken, Autorisierungsheader, Cookies, Zwischenablagedaten und vollständige Inhaltswerte werden von der UI-API geschwärzt.

Multi-Node und Steuerungssperre

Ein Konto kann mehrere Windows-Computer haben:

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

Interaktive Browser-/Desktop-Operationen verwenden eine projektbezogene Node-Lease, sodass sich zwei Projekte nicht um dieselbe Maus/dasselbe Fenster streiten.

Berechtigungsstufen

Auf jedem Windows-Node festgelegt:

GWC_PERMISSION_LEVEL=read | operate | admin

• read: nur Inspektions-/Lesemethoden

• operate: normales Codieren und Automatisierung

• admin: erlaubt auch direkte Dateilöschung und Git-Push

GWC_ALLOWED_ROOTS ist eine harte Grenze für direkte Connector-Dateioperationen und Arbeitsbereichsauswahl. Shell-Befehle werden weiterhin mit den normalen Windows-Kontoberechtigungen ausgeführt. Verwenden Sie daher einen dedizierten Windows-Benutzer mit niedrigen Rechten oder eine VM, wenn eine starke OS-Isolation erforderlich ist.

Gateway auf VPS installieren

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 .

Konfigurieren:

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

Öffentliche Endpunkte:

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

Ein Dockerfile und docker-compose.yml sind enthalten. Stellen Sie in der Produktion HTTPS/WSS vor den Dienst.

Windows-Node installieren

Installieren Sie das Paket unter Windows, erstellen Sie einen einmaligen Kopplungscode über das VPS-Dashboard und führen Sie dann aus:

$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

Nach erfolgreicher Kopplung stellt das Gateway ein persistentes, zufälliges Node-Token aus. Der Node speichert es im lokalen App-Datenverzeichnis des aktuellen Benutzers und verbindet sich automatisch mit Heartbeat und exponentiellem Backoff neu.

Sicherheit

• Verwenden Sie in der Produktion HTTPS/WSS.

• Beschränken Sie GWC_ALLOWED_ROOTS.

• Bevorzugen Sie read oder operate; gewähren Sie admin nur bei Bedarf.

• Behandeln Sie JWTs und persistente Node-Token als Geheimnisse.

• Führen Sie den Windows-Node nach Möglichkeit unter einem dedizierten Windows-Konto aus.

• Das MCP Python SDK ist auf >=1.27.2,<2 festgelegt und die explizite Host/Origin-Transport-Sicherheit ist aktiviert.

• Der Windows-Node ist nur ausgehend; setzen Sie lokale CDP-, Shell- oder Node-Ports nicht öffentlich.

Beabsichtigter Codierungsablauf

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

Das Repository bleibt unabhängig von CursorTouch/Windows-MCP. Windows-MCP wird zur Laufzeit nicht benötigt.