Secure Local Workspace MCP

English | 中文（默认）

Lassen Sie ChatGPT Web sicher eine Verbindung zu lokalen Projekten herstellen: Ob mit oder ohne Git – Dateien können angezeigt, durchsucht und geändert sowie Whitelist-Aufgaben ausgeführt werden. Bei Git-Projekten können zusätzlich Diffs geprüft, lokale Commits erstellt und – nach ausdrücklicher Benutzerfreigabe – an ein bestimmtes Remote und einen bestimmten Branch gepusht werden.

Sie müssen Codex nicht installieren. ChatGPT ruft den weiterhin auf Ihrem Computer laufenden MCP-Dienst über den OpenAI Secure MCP Tunnel auf; das Projektverzeichnis und der MCP-Port müssen nicht öffentlich erreichbar sein.

Wählen Sie zuerst Ihr Nutzungsszenario

Related MCP server: Kastor

Was Sie erhalten

Das Projekt bietet keine beliebige Shell, kein git add ., kein force push, keine Historie-Umschreibung, keine Produktionsbereitstellung und keinen beliebigen Datenträgerzugriff.

Erstinstallation: ChatGPT von Grund auf verbinden

Die folgenden Schritte verwenden Windows PowerShell als Beispiel. In der Regel ist dies nur einmal erforderlich.

Schritt 1: Voraussetzungen prüfen

Erforderlich:

• Windows PowerShell;

• Git;

• Node.js 20 oder höher;

• ChatGPT-Entwicklermodus verfügbar;

• Berechtigungen für Tunnel in der OpenAI Platform.

Lokale Befehle prüfen:

git --version
node --version
npm --version

Wenn ChatGPT Git-Commits erstellen soll, muss zuerst die Git-Identität festgelegt werden. Bereits eingerichtet – dann überspringen:

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Schritt 2: Projekt herunterladen

git clone https://github.com/dxawdc/secure-local-workspace-mcp.git
Set-Location .\secure-local-workspace-mcp

Schritt 3: Tunnel auf der OpenAI-Seite vorbereiten

Befolgen Sie die offizielle Dokumentation zum OpenAI Secure MCP Tunnel und führen Sie Folgendes aus:

1. Erstellen Sie einen Tunnel in der OpenAI Platform;

2. Verknüpfen Sie den Tunnel mit dem ChatGPT-Workspace, der ihn verwenden soll;

3. Erstellen Sie einen Runtime-API-Key für die Verwendung durch tunnel-client;

4. Laden Sie die offizielle neueste Version von tunnel-client herunter;

5. Notieren Sie die tunnel_id und den lokalen Pfad von tunnel-client.exe.

Diese Schritte betreffen Kontoberechtigungen und Schlüssel und müssen vom Benutzer auf der OpenAI-Seite bestätigt werden; das Projekt erstellt oder liest keine Kontozugangsdaten im Namen des Benutzers.

Schritt 4: Runtime-Key außerhalb des Repositories speichern

Schreiben Sie den Key nicht in die README, Projektkonfiguration, Git oder den PowerShell-Befehlsverlauf. Erstellen Sie zuerst eine Datei außerhalb des Repositories:

New-Item -ItemType Directory -Path "C:\Secrets" -Force
notepad "C:\Secrets\openai-tunnel-runtime-key.txt"

Fügen Sie den Runtime-Key im Editor ein, lassen Sie nur eine Zeile stehen, speichern und schließen Sie. In Produktions- oder Teamumgebungen sollte ein von der Organisation genehmigtes Schlüsselverwaltungsschema verwendet und der Zugriff auf diese Datei eingeschränkt werden.

Schritt 5: Ein-Klick-Konfiguration ausführen

Ersetzen Sie die drei Pfade und die Tunnel-ID im Beispiel durch Ihre eigenen Werte:

.\scripts\quick-setup.ps1 `
  -ProjectRoot "D:\Projects\my-app" `
  -DiscoveryRoot "D:\Projects" `
  -TunnelId "tunnel_REPLACEME" `
  -TunnelClient "C:\Tools\tunnel-client\tunnel-client.exe" `
  -ControlPlaneApiKeyRef "file:C:\Secrets\openai-tunnel-runtime-key.txt" `
  -RegisterStartup `
  -StartTunnel

So füllen Sie die Parameter aus:

• ProjectRoot: Das Projektverzeichnis, das ChatGPT zur Bearbeitung übergeben werden soll; muss kein Git-Repository sein;

• DiscoveryRoot: Das übergeordnete Verzeichnis, in dem ChatGPT Projekte entdecken darf, in der Regel die übergeordnete Ebene von ProjectRoot;

• TunnelId: Die echte tunnel_id aus der OpenAI Platform;

• TunnelClient: Die heruntergeladene und entpackte tunnel-client.exe;

• ControlPlaneApiKeyRef: Der Pfad zur Runtime-Key-Datei, muss mit dem Präfix file: versehen sein.

Das Skript führt automatisch Folgendes aus:

1. Installiert Node.js-Abhängigkeiten mithilfe einer Sperrdatei;

2. Führt Unit-Tests und MCP-Smoke-Tests aus;

3. Setzt das Projekt auf lesbar/schreibbar und erlaubt lokale Commits;

4. Genehmigt das Projekt-Erkennungsverzeichnis;

5. Erkennt automatisch test、lint、build、typecheck in package.json;

6. Erstellt und prüft das Tunnel-Profil;

7. Registriert eine Login-Autostart-Aufgabe für den aktuellen Benutzer und startet den Tunnel sofort.

Standardmäßig ist push nicht erlaubt. Nicht-Git-Projekte behalten automatisch die Datei-Lese-/Schreibfähigkeit, während Commit und push erzwungen deaktiviert werden; ein manuelles Hinzufügen von -DisableCommit ist nicht erforderlich.

Wenn der Zugriff auf OpenAI über einen Proxy erfolgen muss, fügen Sie am Ende des Befehls hinzu:

-HttpProxy "http://127.0.0.1:7890"

Schritt 6: Private App in ChatGPT erstellen

1. Aktivieren Sie den Entwicklermodus in den ChatGPT-Einstellungen. Enterprise-/Edu-Benutzer benötigen möglicherweise eine Administratorfreigabe;

2. Öffnen Sie ChatGPT Plugins;

3. Klicken Sie auf das Pluszeichen, um eine Entwicklermodus-App zu erstellen;

4. Wählen Sie bei Connection Tunnel;

5. Wählen Sie den gerade erstellten Tunnel oder fügen Sie die echte tunnel_id ein;

6. Erstellen Sie die App und warten Sie, bis ChatGPT die Tools entdeckt.

Die offizielle Dokumentation verlangt, dass tunnel-client weiterläuft; andernfalls kann ChatGPT die Tools nicht entdecken oder aufrufen.

Schritt 7: Verbindung verifizieren

Wählen Sie in einem neuen ChatGPT-Chat diese App aus oder verwenden Sie @, und senden Sie dann:

调用 diagnostics 和 list_projects。
告诉我 Tunnel 后面的本地 MCP 是否正常，并列出已授权项目、读写权限、commit 权限和 push 权限。
不要修改任何文件。

Normalerweise sollte die Projektliste erscheinen und allowPush standardmäßig false sein. Die neue Version bietet insgesamt 17 Tools; wenn noch alte Tools angezeigt werden, starten Sie den Tunnel neu und aktualisieren Sie die App in ChatGPT oder erstellen Sie einen neuen Chat.

Bereits vorhandener Tunnel: Ein neues Projekt anbinden

Wenn Tunnel und Login-Autostart-Aufgabe über dieses Projekt konfiguriert wurden, führen Sie im Repository-Verzeichnis aus:

.\scripts\quick-setup.ps1 `
  -ProjectRoot "D:\Projects\another-app" `
  -DiscoveryRoot "D:\Projects" `
  -SkipInstall `
  -SkipTests `
  -RestartTunnel

Dies fügt die Projektkonfiguration hinzu oder aktualisiert sie, ohne andere autorisierte Projekte zu überschreiben.

Wenn Sie die Login-Aufgabe nicht über dieses Projekt registriert haben, entfernen Sie -RestartTunnel, schließen Sie die Konfiguration ab und starten Sie tunnel-client auf die ursprüngliche Weise neu. Aktualisieren Sie danach die Tools in den ChatGPT-App-Einstellungen.

ChatGPT automatisch Nicht-Git-Projekte anbinden lassen

Gängige Projektverzeichnisse wie Node.js, Python, Java, Go, Rust, .NET, PHP, Ruby, Elixir, Swift, CMake usw. werden von discover_projects automatisch erkannt. Selbst wenn ein Verzeichnis keine gängigen Projektkennzeichen aufweist, kann es innerhalb des genehmigten DiscoveryRoot über einen expliziten absoluten Pfad angebunden werden:

调用 discover_projects，列出已批准目录中的 Git 和非 Git 项目。
把 D:\Projects\notes-app 接入为可读写项目。
如果它不是 Git 仓库，必须自动关闭 commit 和 push。
接入后调用 list_projects，确认 projectType 和最终权限。

Nachdem ChatGPT connect_project aufgerufen hat, wird die Konfiguration sofort persistent und im aktuellen MCP-Prozess wirksam; ein Neustart des Tunnels für ein einzelnes Projekt ist nicht erforderlich.

Nur Anzeigen erlauben, keine Änderungen

.\scripts\quick-setup.ps1 `
  -ProjectRoot "D:\Projects\reference-project" `
  -DiscoveryRoot "D:\Projects" `
  -ReadOnly `
  -SkipInstall `
  -SkipTests `
  -RestartTunnel

Änderungen erlauben, aber keine Commits

.\scripts\quick-setup.ps1 `
  -ProjectRoot "D:\Projects\my-app" `
  -DiscoveryRoot "D:\Projects" `
  -DisableCommit `
  -SkipInstall `
  -SkipTests `
  -RestartTunnel

Nur ein übergeordnetes Verzeichnis für die Projekterkennung hinzufügen

.\scripts\quick-setup.ps1 `
  -DiscoveryRoot "E:\OtherProjects" `
  -SkipInstall `
  -SkipTests `
  -RestartTunnel

Setzen Sie DiscoveryRoot nicht auf das Datenträger-Stammverzeichnis, das gesamte Benutzerverzeichnis oder ein Verzeichnis mit vielen privaten Dateien. Es sollte ein übergeordnetes Verzeichnis sein, das speziell für Code-Repositories vorgesehen ist.

Prompts für den täglichen Gebrauch

Der Projektname richtet sich nach der von list_projects zurückgegebenen ID. Die folgenden Prompts können direkt in ChatGPT kopiert und dann Projektname und Anforderung ersetzt werden.

1. Nur anzeigen und analysieren

使用 Secure Local Workspace MCP 检查项目 my-app。
先调用 list_projects 确认项目，再查看与登录流程有关的代码。
解释实现和可能的问题，不要修改文件，不要提交。

2. Ändern und testen, aber nicht committen

检查项目 my-app 的重复提交问题并完成修复。
修改前重新读取目标文件并使用最新 SHA-256，只改与本次问题有关的文件。
运行项目允许的 test 或 lint 任务，最后展示 git_status 和 git_diff。
不要 commit，不要 push。

3. Ändern, testen und lokalen Commit erstellen

修复项目 my-app 的重复提交问题。
运行相关测试，然后展示完整 git_diff 和 git_status。
确认差异只包含本次修改后，使用最新 statusSha256，
只提交本次涉及的明确文件，提交信息为：fix: prevent duplicate submissions。
提交后报告本地 commit SHA。不要 push。

4. Nur bereits abgeschlossene Änderungen committen

检查项目 my-app 当前 git_status 和 git_diff，不要继续改代码。
如果存在与本任务无关或已经预暂存的文件，停止并告诉我。
否则使用最新 statusSha256，只提交这些明确文件：src/example.js、test/example.test.js。
提交信息为：fix: handle duplicate submissions。不要 push。

git_commit lehnt Folgendes ab:

• .、Verzeichnisse oder Pfade außerhalb des Projekts;

• Git-Status, der sich nach der Prüfung geändert hat;

• Vorab vorhandene staged changes;

• Sensitive Pfade wie .env、private Schlüssel、Zertifikate、Passwort-Tresore;

• Hochvertrauenswürdige API-Keys、Tokens、private Schlüssel oder echte Tunnel-/Organisationskennungen;

• Fehlgeschlagenes git diff --cached --check;

• Commit nicht in der lokalen Konfiguration aktiviert.

Ein erfolgreicher Commit bedeutet nur, dass lokal committet wurde, nicht dass gepusht wurde.

Controlled Push separat aktivieren

Push ist eine externe Schreiboperation und muss daher lokal pro Projekt explizit aktiviert werden. Es wird empfohlen, gleichzeitig den Ziel-Branch einzuschränken:

.\scripts\quick-setup.ps1 `
  -ProjectRoot "D:\Projects\my-app" `
  -AllowPush `
  -AllowedRemote "origin" `
  -AllowedBranch "main" `
  -SkipInstall `
  -SkipTests `
  -RestartTunnel

Fordern Sie dann in ChatGPT ausdrücklich an:

检查项目 my-app 当前分支、HEAD、git_status 和待推送 commit。
只有在工作区状态和 commit 都符合预期时，才把当前 HEAD 推送到允许的 origin/main。
禁止 force push。分别报告本地 commit SHA、远端分支和推送结果。

git_push erstellt keine Commits automatisch und pusht nicht an nicht konfigurierte Remotes oder Branches.

Grenzen zwischen Automatisierung und manuellen Vorgängen

Ausführlichere Batch-Konfiguration, Proxy, Autostart, Rollback und unbeaufsichtigten Betrieb finden Sie unter: Windows-Automatisierungskonfiguration.

Konfigurationsverwaltung

Die Standardkonfigurationsdatei befindet sich außerhalb des Repositories:

%USERPROFILE%\.secure-local-workspace-mcp\config.json

Wenn die neue Konfiguration nicht vorhanden ist, liest der Dienst kompatibel den alten Pfad:

%USERPROFILE%\.local-project-workspace\config.json

Aktuelle Konfiguration anzeigen:

npm run config -- list

Wenn Sie die PowerShell-Automatisierung nicht verwenden, können Sie auch das plattformübergreifende Konfigurations-CLI aufrufen:

npm run config -- add-discovery-root --root "D:\Projects"

npm run config -- add-project `
  --root "D:\Projects\my-app" `
  --writable `
  --allow-commit `
  --no-push

Das kompatible Skript bootstrap-config.ps1 fügt ebenfalls idempotent einzelne Projekte hinzu oder aktualisiert sie, ohne die gesamte Konfiguration zu ersetzen.

Projekt aktualisieren

Set-Location .\secure-local-workspace-mcp
git pull --ff-only
npm ci
npm test
npm run smoke:mcp

Nach einem Update von Code oder Tool-Definitionen muss tunnel-client neu gestartet und die App in ChatGPT aktualisiert oder ein neuer Chat erstellt werden.

Projektzugriff aufheben

Senden Sie in ChatGPT:

调用 disconnect_project 撤销项目 my-app 的 MCP 访问权限，然后重新列出项目。

Dies löscht nur die lokale Autorisierungskonfiguration, nicht das Projektverzeichnis, Dateien oder die Git-Historie.

Zum Entfernen der Login-Autostart-Aufgabe:

Stop-ScheduledTask -TaskName "Secure Local Workspace MCP Tunnel"
Unregister-ScheduledTask -TaskName "Secure Local Workspace MCP Tunnel" -Confirm:$false

Dies löscht weder Tunnel, Runtime-Key, Profil noch Projektdateien.

Häufige Fragen

Git commit identity is missing

Legen Sie zuerst Git-Benutzername und E-Mail fest und führen Sie dann die Konfiguration erneut aus:

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Scheduled task not found

Sie haben -RestartTunnel verwendet, aber der Tunnel wurde nicht über dieses Projekt registriert. Entfernen Sie den Parameter, schließen Sie die Projektkonfiguration ab und starten Sie tunnel-client auf die ursprüngliche Weise neu.

Tunnel in ChatGPT nicht sichtbar

Prüfen Sie der Reihe nach:

1. Ist der Tunnel mit dem aktuellen ChatGPT-Workspace verknüpft, nicht nur mit der Platform-Organisation?

2. Verfügt das aktuelle Konto über Tunnels Read + Use?

3. Ist der ChatGPT-Entwicklermodus aktiviert?

4. Läuft tunnel-client weiterhin und ist im Status healthy/ready?

ChatGPT hat die 17 Tools nicht entdeckt

• Tunnel-Runtime neu starten;

• tunnel-client doctor --profile <profile> --explain ausführen;

• In den ChatGPT-App-Einstellungen aktualisieren;

• Einen neuen ChatGPT-Chat erstellen, damit alte Sitzungen nicht weiterhin gecachte Tool-Definitionen verwenden.

Projekt kann nicht entdeckt oder angebunden werden

• Das Projekt muss innerhalb des genehmigten DiscoveryRoot liegen;

• Git-Repositories und Nicht-Git-Verzeichnisse mit gängigen Projektkennzeichen erscheinen automatisch in den Erkennungsergebnissen;

• Gewöhnliche Verzeichnisse ohne Projektkennzeichen werden nicht automatisch aufgelistet, aber ChatGPT kann connect_project mit ihrem expliziten absoluten Pfad aufrufen;

• Nicht-Git-Projekte zeigen projectType: non-git und erzwingen die Deaktivierung von Commit und push;

• Führen Sie npm run config -- list aus, um die tatsächliche Konfiguration zu prüfen;

• Fügen Sie bei Bedarf das übergeordnete Verzeichnis erneut hinzu und starten Sie den Tunnel neu.

Schreiben abgelehnt oder SHA abgelaufen

• Das Projekt muss Schreibzugriff erlauben;

• Vor dem Ändern oder Löschen vorhandener Dateien muss ChatGPT read_file erneut aufrufen;

• Wenn die Datei von anderen Programmen geändert wurde, wird der alte SHA ungültig – das ist normaler Nebenläufigkeitsschutz.

Commit wegen vorhandener staged changes abgelehnt

Lassen Sie ChatGPT zuerst git_status aufrufen, um zu prüfen. Wenn das Unstaging bestätigt ist, rufen Sie git_unstage für die expliziten Dateien auf; dieser Vorgang verwirft keine Arbeitsbereichsinhalte.

Tunnel lokal normal, aber ChatGPT-Aufruf timeout

• Prüfen Sie die ausgehende Verbindung zu api.openai.com:443;

• Dass der Browser einen Proxy nutzt, bedeutet nicht, dass tunnel-client automatisch denselben Proxy verwendet;

• Schreiben Sie den Proxy bei der Erstkonfiguration über -HttpProxy;

• Prüfen Sie lokale Firewall, Proxy-Zertifikate und organisatorische Netzwerkrichtlinien.

Lokale Verifizierung

npm ci
npm test
npm run smoke:mcp
npm audit --omit=dev

Lokaler MCP-Vordergrundstart:

.\scripts\start-local.ps1

Der Tunnel-Status sollte mindestens erfüllen:

process_running = true
healthy = true
ready = true

Sicherheitsempfehlungen

• Discovery Root sollte ein spezielles Projekt-übergeordnetes Verzeichnis sein; verwenden Sie nicht das Datenträger-Stammverzeichnis oder das gesamte Benutzerverzeichnis;

• Bevorzugen Sie zunächst nur Commit; aktivieren Sie push nur bei Bedarf pro Projekt, Remote und Branch;

• Runtime-Key, Tunnel-Profil, echte Konfiguration und Protokolle müssen außerhalb des Repositories gespeichert werden;

• MCP-Commit deaktiviert temporär Git-Hooks des Projekts; Tests und Formatierung sollten über die explizite Aufgaben-Whitelist ausgeführt werden;

• Prüfen Sie vor dem Push weiterhin die explizite Commit-SHA, das Remote und den Branch;

• Wenn ein Schlüssel versehentlich committet wurde, widerrufen Sie ihn sofort und bereinigen Sie die vollständige Git-Historie.

Sicherheitsdesign und Meldung von Schwachstellen finden Sie unter SECURITY.md.

Offizielle Referenzen

• OpenAI Secure MCP Tunnel

• OpenAI MCP and Connectors

License

MIT