codex-mcp-bridge

Eine kleine Policy-Schicht zwischen ChatGPT und dem offiziellen lokalen Codex-MCP-Server.

ChatGPT
  -> OpenAI Secure MCP Tunnel
  -> codex-mcp-bridge (loopback HTTP)
  -> codex mcp-server (stdio)
  -> one explicitly allowed repository

Der offizielle Codex-MCP-Server bietet bereits codex und codex-reply. Diese Bridge fügt absichtlich nur die Steuerungen hinzu, die für die sicherere tägliche Nutzung über ChatGPT erforderlich sind:

• bridge_status: die aktive Policy einsehen.

• codex_read: eine schreibgeschützte Codex-Sitzung erzwingen.

• codex_run: eine policy-begrenzte Lese- oder Schreibsitzung starten.

• codex_reply: nur einen Thread fortsetzen, der über diese Bridge erstellt wurde.

• codex_job_status: ein langlaufendes Ergebnis abrufen.

Sicherheitsvoreinstellungen

• Bindet an 127.0.0.1.

• Erlaubt genau ein aktuelles Arbeitsverzeichnis, sofern keine Roots explizit konfiguriert sind.

• Verwendet die Codex-Sandbox read-only.

• Verwendet die Genehmigungs-Policy on-request.

• Stellt danger-full-access niemals bereit.

• Blockiert Workspace-Schreibvorgänge, sofern der Bridge-Besitzer kein Schreibprofil startet.

• Lehnt Pfade außerhalb der konfigurierten Real-Path-Roots ab.

• Verweigert Repositorys, die gängige Secret-Dateinamen enthalten, sofern der Bridge-Besitzer den Preflight nicht explizit deaktiviert.

• Begrenzt die Promptgröße und gleichzeitige Codex-Jobs.

• Unterdrückt stderr des vorgelagerten Codex, sofern keine lokale Debug-Protokollierung aktiviert ist.

Diese Steuerungen sind eine Policy-Schicht, keine Isolation auf Betriebssystemebene. Verwenden Sie eine Staging-Kopie, einen Container, eine VM oder einen separaten OS-Benutzer, wenn eine harte Isolation erforderlich ist.

Related MCP server: mcp-governance-proxy

Voraussetzungen

• Node.js 20 oder höher; Node.js 22 wird empfohlen.

• Codex CLI muss installiert und authentifiziert sein und codex mcp-server bereitstellen.

• tunnel-client und ein OpenAI Secure MCP Tunnel für den ChatGPT-Zugriff.

Offizielle Referenzen:

• Codex als MCP-Server ausführen

• Secure MCP Tunnel

Installation

npm ci
npm run check

Lokaler Smoke-Test

Der lokale Modus erstellt niemals einen öffentlichen Endpunkt:

npm run bridge:local -- --root /absolute/path/to/repository

Der MCP-Endpunkt ist http://127.0.0.1:8876/mcp und der Health-Endpunkt ist http://127.0.0.1:8876/healthz.

Secure MCP Tunnel

Erstellen Sie einen Tunnel in der OpenAI Platform und geben Sie dessen Laufzeit-Zugangsdaten außerhalb dieses Repositorys an:

export CONTROL_PLANE_API_KEY="<runtime-key>"
export CONTROL_PLANE_TUNNEL_ID="tunnel_..."

npm run bridge:secure -- --root /absolute/path/to/repository

Der Launcher baut die Bridge, startet sie auf Loopback, initialisiert das Tunnelprofil, führt tunnel-client doctor aus und hält den Tunnel-Client am Laufen.

Für eine bewusste Schreibsitzung:

npm run bridge:secure -- --root /absolute/path/to/repository --write

Lassen Sie kein Schreibprofil laufen, wenn es nicht benötigt wird.

macOS Keychain

security add-generic-password -a "$USER" -s "codex-mcp-bridge:control-plane-api-key" -w "<runtime-key>" -U
security add-generic-password -a "$USER" -s "codex-mcp-bridge:control-plane-tunnel-id" -w "tunnel_..." -U

CODEX_MCP_BRIDGE_ROOT=/absolute/path/to/repository npm run bridge:secure:keychain

Verwenden Sie bridge:secure:write:keychain nur für eine beabsichtigte Schreibsitzung.

Konfiguration

Das alte Variablenpräfix CODEX_GPT_BRIDGE_* wird vorübergehend für die Kompatibilität mit dem Upstream akzeptiert.

ChatGPT-Einrichtung

Siehe docs/chatgpt-setup.md.

Upstream

Dieses Repository ist von DeepCogNeural/codex-gpt-bridge unter der MIT License abgeleitet. Siehe UPSTREAM.md für den Umfang dieses Forks.