ChatGPT Local Supervisor Bridge

Permite que la interfaz web de ChatGPT vea y opere de forma segura tus proyectos locales explícitamente abiertos, a través del Secure MCP Tunnel oficial de OpenAI.

Es adecuado para este flujo de trabajo: ChatGPT se encarga de revisar el proyecto, verificar el progreso sin confirmar, examinar diferencias y redactar tarjetas de trabajo; el agente local se encarga de la ejecución. Cuando sea necesario, ChatGPT también puede modificar directamente archivos dentro del rango permitido, ejecutar las comprobaciones existentes del proyecto y ver la vista previa local.

Windows-first, Node.js sin dependencias de terceros. No es un proyecto oficial de OpenAI; el cliente de túnel utiliza el proyecto oficial de código abierto de OpenAI.

Qué puede hacer

• Enumerar dinámicamente los proyectos configurados y todos sus Git worktrees.

• Leer archivos, buscar texto, ver el estado de Git, diff, registros y contenido de confirmaciones.

• Crear archivos; antes de sobrescribir un archivo existente, debe proporcionar el SHA-256 de la última lectura devuelta.

• Reemplazar con precisión fragmentos de texto únicos, evitando modificaciones erróneas en múltiples lugares.

• La eliminación se cambia a mover al área recuperable del puente, con soporte de recuperación.

• Confirmar solo los archivos explícitamente listados; rechazar archivos pre-staged no relacionados.

• Solo permitir push no forzado de la rama actual, y exigir una frase de confirmación explícita.

• Ejecutar solo los scripts check/test/lint/typecheck/build/verify existentes del proyecto.

• Iniciar solo los scripts dev/start/preview existentes del proyecto, con capacidad de leer registros y detener procesos.

• Capturar páginas de localhost para ayudar en el control de calidad web.

No tiene herramientas de shell arbitrario, push forzado, hard reset, merge, borrado permanente o lectura de claves.

Related MCP server: OpenAI Secure MCP Tunnel

Límites de seguridad

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

El servidor aplica las siguientes reglas de forma obligatoria, no se pueden eludir solo con indicaciones:

• Solo se puede acceder a los directorios raíz de los proyectos en config.json y sus Git worktrees.

• Los directorios bajo denyRoots siempre se rechazan.

• .env, credenciales, tokens, certificados, claves privadas, .ssh y los directorios internos de .git se rechazan.

• Los enlaces simbólicos o junctions no pueden escapar del espacio de trabajo.

• El código fuente, la configuración, la clave de ejecución y los registros del propio puente no pueden ser leídos ni modificados por el puente.

El modelo de amenazas completo se encuentra en SECURITY.md.

Planes y costos

Este proyecto no llama a la API de Responses ni a la API de Chat Completions; el razonamiento del modelo ocurre en la conversación web normal de ChatGPT. La clave de API de runtime de la plataforma se usa solo para que tunnel-client se autentique ante el plano de control del Tunnel de OpenAI.

La versión pública se probó de lectura y escritura en la interfaz web de ChatGPT Pro el 2026-08-22. Para Plus u otros planes, no se debe juzgar solo por el nombre del plan: tu cuenta debe mostrar realmente las siguientes entradas:

1. Developer mode;

2. Crear complementos/aplicaciones personalizados;

3. En Connection se puede seleccionar Tunnel;

4. El chat de destino permite invocar las herramientas de escritura de ese complemento.

OpenAI ajusta el alcance de las funciones disponibles, y los espacios de trabajo de equipo también pueden estar controlados por el administrador. Por lo tanto, este proyecto no garantiza que todas las cuentas Plus tengan estas entradas; se debe verificar según la interfaz actual de la cuenta y una prueba real de lectura/escritura de bajo riesgo.

Preparación

• Windows 10/11;

• Node.js 20 o posterior;

• Git;

• La versión para Windows del tunnel-client oficial de OpenAI;

• Un Secure MCP Tunnel;

• Una clave de API de runtime con solo permisos de Tunnels Read + Use;

• Developer mode y entrada de complementos personalizados disponibles en ChatGPT.

Documentación oficial:

• Documentación de Secure MCP Tunnel

• Código fuente y versiones de OpenAI tunnel-client

• Documentación de MCP de ChatGPT / Codex

Inicio rápido

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

Descarga la versión para Windows de tunnel-client.exe desde la Release oficial y colócala en:

vendor\tunnel-client.exe

Ejecuta la inicialización. La entrada de la clave no se muestra y se cifra con DPAPI de Windows para el usuario actual:

.\scripts\setup.ps1

Edita el config.json generado, rellena solo los proyectos que estés dispuesto a entregar a ChatGPT y coloca todos los directorios privados en denyRoots. Luego verifica:

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

Inicia en primer plano:

.\scripts\start-tunnel.ps1

Después de confirmar que la conexión es normal, puedes instalar el inicio automático al iniciar sesión:

.\scripts\install-autostart.ps1

Los pasos completos de conexión en la interfaz web de ChatGPT se encuentran en Tutorial de instalación en chino para Windows.

Primer prompt recomendado

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

Para la primera escritura, crea solo un archivo de aceptación sin importancia y luego vuelve a leerlo con read_file y verifica el SHA-256. Después de la aceptación, límpialo con move_to_trash.

Detención y revocación

.\scripts\uninstall-autostart.ps1

Esto detiene y elimina la tarea de inicio de sesión, pero conserva el código fuente, la configuración y la clave cifrada con DPAPI. Para la desactivación completa, también debes revocar la clave de runtime en OpenAI Platform y eliminar el Tunnel que ya no se use.

Desarrollo

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

Se aceptan Issues y PRs. Las reglas de contribución se encuentran en CONTRIBUTING.md.

Licencia

MIT. El tunnel-client de OpenAI no está incluido en este repositorio y se rige por su licencia independiente Apache-2.0.