codex-mcp-bridge

ChatGPT와 공식 로컬 Codex MCP 서버 사이의 작은 정책 계층입니다.

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

공식 Codex MCP 서버는 이미 codex와 codex-reply를 제공합니다. 이 브리지는 ChatGPT에서 더 안전한 일상 사용을 위해 필요한 제어 기능만 의도적으로 추가합니다:

• bridge_status: 활성 정책을 검사합니다.

• codex_read: 읽기 전용 Codex 세션을 강제합니다.

• codex_run: 정책으로 제한된 읽기 또는 쓰기 세션을 시작합니다.

• codex_reply: 이 브리지를 통해 생성된 스레드만 계속 진행합니다.

• codex_job_status: 장기 실행 결과를 검색합니다.

보안 기본값

• 127.0.0.1에 바인딩합니다.

• 루트가 명시적으로 구성되지 않은 경우 현재 작업 디렉터리 하나만 허용합니다.

• read-only Codex 샌드박스를 사용합니다.

• on-request 승인 정책을 사용합니다.

• danger-full-access를 절대 노출하지 않습니다.

• 브리지 소유자가 쓰기 프로필을 시작하지 않는 한 작업공간 쓰기를 차단합니다.

• 구성된 실제 경로 루트 밖의 경로를 거부합니다.

• 소유자가 사전 검사를 명시적으로 비활성화하지 않는 한 일반적인 비밀 파일 이름이 포함된 저장소를 거부합니다.

• 프롬프트 크기와 동시 Codex 작업 수를 제한합니다.

• 로컬 디버그 로깅이 활성화되지 않는 한 업스트림 Codex stderr를 억제합니다.

이러한 제어 기능은 정책 계층이지 OS 수준 격리가 아닙니다. 강력한 격리가 필요한 경우 스테이징 복사본, 컨테이너, VM 또는 별도의 OS 사용자를 사용하세요.

Related MCP server: mcp-governance-proxy

요구 사항

• Node.js 20 이상; Node.js 22 권장.

• Codex CLI 설치 및 인증, codex mcp-server 제공.

• ChatGPT 액세스를 위한 tunnel-client 및 OpenAI Secure MCP Tunnel.

공식 참조:

• Codex를 MCP 서버로 실행

• Secure MCP Tunnel

설치

npm ci
npm run check

로컬 스모크 테스트

로컬 모드는 공개 엔드포인트를 생성하지 않습니다:

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

MCP 엔드포인트는 http://127.0.0.1:8876/mcp이고 헬스 엔드포인트는 http://127.0.0.1:8876/healthz입니다.

Secure MCP Tunnel

OpenAI Platform에서 터널을 생성한 다음 해당 런타임 자격 증명을 이 저장소 외부에서 제공하세요:

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

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

런처는 브리지를 빌드하고, 루프백에서 시작하고, 터널 프로필을 초기화하고, tunnel-client doctor를 실행한 다음 터널 클라이언트를 계속 실행합니다.

의도적인 쓰기 세션의 경우:

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

필요하지 않을 때 쓰기 프로필을 실행 상태로 두지 마세요.

macOS 키체인

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

bridge:secure:write:keychain은 의도적인 쓰기 세션에서만 사용하세요.

구성

이전 CODEX_GPT_BRIDGE_* 변수 접두사는 업스트림 호환성을 위해 임시로 허용됩니다.

ChatGPT 설정

docs/chatgpt-setup.md를 참조하세요.

업스트림

이 저장소는 MIT 라이선스에 따라 DeepCogNeural/codex-gpt-bridge에서 파생되었습니다. 이 포크의 범위는 UPSTREAM.md를 참조하세요.