ChatGPT Local Supervisor Bridge

ChatGPT 웹 인터페이스가 OpenAI 공식 Secure MCP Tunnel을 통해 명시적으로 공개한 로컬 프로젝트를 안전하게 조회하고 조작할 수 있게 해줍니다.

이러한 워크플로우에 적합합니다: ChatGPT는 프로젝트 개요 파악, 커밋되지 않은 진행 상황 확인, 차이점 검토, 시공 카드 작성 담당; 로컬 에이전트는 시공 담당. 필요 시 ChatGPT는 허용 범위 내 파일을 직접 수정하고, 프로젝트 기존 검사를 실행하며 로컬 미리보기를 확인할 수도 있습니다.

Windows 우선, Node.js 타사 의존성 제로. 비 OpenAI 공식 프로젝트; 터널 클라이언트는 OpenAI 공식 오픈소스 프로젝트를 사용합니다.

할 수 있는 작업

• 구성된 프로젝트와 모든 Git worktree를 동적으로 나열합니다.

• 파일 읽기, 텍스트 검색, Git 상태, diff, 로그 및 커밋 내용 확인.

• 파일 생성; 기존 파일을 덮어쓰기 전에 마지막 읽기에서 반환된 SHA-256을 제공해야 합니다.

• 고유 텍스트 조각을 정확히 교체하여 여러 곳의 오수정을 방지합니다.

• 삭제는 브리지 자체의 복구 가능 영역으로 이동하는 방식으로 변경되며 복구를 지원합니다.

• 명시적으로 나열된 파일만 커밋; 관련 없는 사전 스테이징 파일의 동반 커밋을 거부합니다.

• 현재 브랜치에 대한 비강제 푸시만 허용하며 명시적 확인 문구를 요구합니다.

• 프로젝트에 이미 있는 check/test/lint/typecheck/build/verify 스크립트만 실행합니다.

• 프로젝트에 이미 있는 dev/start/preview 스크립트만 시작하고 로그를 읽고 프로세스를 중지할 수 있습니다.

• localhost 페이지를 캡처하여 웹 품질 검사를 지원합니다.

임의 Shell, 강제 푸시, 하드 리셋, 병합, 영구 삭제 또는 키 읽기 도구는 없습니다.

Related MCP server: OpenAI Secure MCP Tunnel

보안 경계

ChatGPT web
    │
    ▼
OpenAI-hosted Secure MCP Tunnel endpoint
    ▲
    │ outbound HTTPS only
    │
tunnel-client on your PC
    │ local stdio
    ▼
this bridge ── allowlisted projects and Git worktrees
              denyRoots, secret filters, SHA write guard

서버 측에서 다음 규칙을 강제하며 프롬프트만으로 우회할 수 없습니다:

• config.json의 프로젝트 루트 디렉터리와 해당 Git worktree에만 접근할 수 있습니다.

• denyRoots 아래의 디렉터리는 항상 거부됩니다.

• .env, 자격 증명, 토큰, 인증서, 개인 키, .ssh 및 .git 내부 디렉터리는 거부됩니다.

• 심볼릭 링크 또는 junction은 작업 영역을 벗어날 수 없습니다.

• 브리지 자체의 소스 코드, 구성, 실행 키 및 로그는 브리지가 읽거나 수정할 수 없습니다.

전체 위협 모델은 SECURITY.md를 참조하세요.

요금제 및 비용

이 프로젝트는 Responses API 또는 Chat Completions API를 호출하지 않습니다. 모델 추론은 일반 ChatGPT 웹 대화에서 발생합니다. Platform runtime API key는 tunnel-client가 OpenAI Tunnel 제어면에 인증하는 데만 사용됩니다.

공개 버전은 2026-08-22 ChatGPT Pro 웹 인터페이스에서 읽기/쓰기 실측 완료. Plus 또는 기타 요금제의 경우 요금제 이름만 보지 말고 계정에 다음 항목이 실제로 나타나는지 확인해야 합니다:

1. Developer mode;

2. 사용자 정의 플러그인/앱 생성;

3. Connection에서 Tunnel 선택 가능;

4. 대상 채팅에서 해당 플러그인의 쓰기 도구 호출 허용.

OpenAI는 기능 공개 범위를 조정할 수 있으며 팀 워크스페이스도 관리자 통제를 받을 수 있습니다. 따라서 이 프로젝트는 모든 Plus 계정에 이러한 항목이 있다고 보장하지 않습니다. 현재 계정 인터페이스와 한 번의 실제 저위험 읽기/쓰기 테스트를 기준으로 합니다.

사전 준비

• Windows 10/11;

• Node.js 20 이상;

• Git;

• OpenAI 공식 tunnel-client Windows 버전;

• Secure MCP Tunnel 하나;

• Tunnels Read + Use 권한만 있는 runtime API key;

• ChatGPT에서 사용 가능한 Developer mode 및 사용자 정의 플러그인 항목.

공식 자료:

• Secure MCP Tunnel 문서

• OpenAI tunnel-client 소스 및 배포판

• ChatGPT / Codex MCP 문서

빠른 시작

git clone https://github.com/VITASID57/chatgpt-local-supervisor-bridge.git
cd chatgpt-local-supervisor-bridge

공식 Release에서 Windows용 tunnel-client.exe를 다운로드하여 다음 위치에 넣습니다:

vendor\tunnel-client.exe

초기화를 실행합니다. 키 입력은 표시되지 않으며 Windows DPAPI로 현재 사용자에게 암호화됩니다:

.\scripts\setup.ps1

생성된 config.json을 편집하여 ChatGPT에 맡길 프로젝트만 채우고 모든 개인 디렉터리를 denyRoots에 넣습니다. 그런 다음 확인합니다:

.\scripts\start-tunnel.ps1 -Mode doctor
npm run check

포그라운드로 시작:

.\scripts\start-tunnel.ps1

연결이 정상인지 확인한 후 로그인 자동 시작을 설치할 수 있습니다:

.\scripts\install-autostart.ps1

ChatGPT 웹 인터페이스의 전체 연결 단계는 Windows 중국어 설치 튜토리얼을 참조하세요.

권장 첫 프롬프트

只使用 Local Supervisor Bridge。先调用 list_workspaces，选择目标项目，
再读取项目规则、NOW/README、Git 状态和未提交差异。
先给出当前事实、风险和下一张施工卡；除非我明确要求，否则先不要修改文件。

첫 쓰기는 중요하지 않은 수락 파일 하나만 생성한 다음 read_file로 다시 읽고 SHA-256을 확인하세요. 수락 후 move_to_trash로 정리합니다.

중지 및 철회

.\scripts\uninstall-autostart.ps1

이렇게 하면 로그인 작업이 중지되고 제거되지만 소스 코드, 구성 및 DPAPI 암호화 키는 유지됩니다. 완전히 비활성화하려면 OpenAI Platform에서 runtime key를 철회하고 더 이상 사용하지 않는 Tunnel을 삭제해야 합니다.

개발

npm test
npm run smoke
npm run check
.\scripts\verify-public.ps1

Issue 및 PR을 환영합니다. 기여 규칙은 CONTRIBUTING.md를 참조하세요.

License

MIT. OpenAI tunnel-client는 이 저장소에 포함되지 않으며 별도의 Apache-2.0 라이선스가 적용됩니다.