ProBridge

Puente MCP local de código abierto para ChatGPT desktop Quick Chat + GPT-5.6 Pro.

Los agentes de codificación en Codex, OpenCode, Claude u otros hosts MCP llaman a ProBridge. ProBridge encola el trabajo, abre una sesión de ChatGPT Quick Chat verificada y envía el prompt. Dentro de esa sesión de ChatGPT, LocalAnt / DevSpace es el conector que llega a tu Mac local y al espacio de trabajo activo.

Se usa la cuota de ChatGPT Pro. No se usa la cuota de modelos de Codex. No hay ninguna clave de API de modelos.

Objetivo actual: macOS. Windows y Linux aún no son compatibles. Las contribuciones que añadan un controlador real para esas plataformas son bienvenidas.

Cómo encaja

Codex / OpenCode / Claude
        |
        | MCP tool call
        v
     ProBridge
   prompt · queue · status · follow-up
        |
        | drives ChatGPT desktop Quick Chat
        v
 ChatGPT Quick Chat  (GPT-5.6 Pro)
        |
        | LocalAnt / DevSpace inside ChatGPT
        v
 authenticated device tunnel
        |
        v
 local Mac / active workspace

El agente que llama solo necesita tres herramientas:

gpt56_pro_start({ prompt })
gpt56_pro_status({ jobId })
gpt56_pro_followup({ jobId, prompt })

start devuelve inmediatamente un jobId. Consulta status. Usa follow-up solo después de que esa misma ronda de Quick Chat haya terminado.

Related MCP server: mcacp

Qué aporta este repositorio

LocalAnt / DevSpace da a ChatGPT acceso a tu Mac. ProBridge no reemplaza ese conector y no puede instalarlo por ti.

ProBridge da a tu agente de codificación un puente hacia ChatGPT Pro. Un host MCP envía un prompt a ProBridge; ProBridge lo encola, maneja Quick Chat y devuelve el estado del trabajo a través de MCP. Por eso este repositorio tiene sentido cuando ya quieres que ChatGPT Pro realice trabajo local, pero quieres que Codex, OpenCode, Claude u otro agente lo invoque como subagente.

Requisitos

• macOS

• Node 20+

• Herramientas de línea de comandos de Xcode (swiftc)

• ChatGPT desktop con sesión iniciada con Pro

• LocalAnt / DevSpace conectado en ChatGPT

• Permiso de Accesibilidad para el binario bin/ax-driver

LocalAnt / DevSpace es lo que le da a ChatGPT Pro manos en la máquina. ProBridge es lo que permite que otros agentes envíen trabajo a esa sesión de ChatGPT.

Configuración: dos partes necesarias

1. Configura primero el conector local de ChatGPT

ProBridge necesita que ChatGPT ya tenga un conector que pueda llegar a tu Mac local. Elige un conector y completa su configuración previa antes de instalar ProBridge:

LocalAnt (la vía probada): sigue la guía de configuración de LocalAnt. El inicio rápido es:

npx -y localant setup
localant tools profile coding

localant setup imprime tu endpoint de MCP autenticado. En ChatGPT desktop, ve a Ajustes → Apps y conectores, activa Modo de desarrollo, elige Conectores → Crear, pega ese endpoint de MCP, selecciona Autenticación: Ninguna y llama al conector LocalAnt. Mantén los ajustes locales de aprobación y seguridad de LocalAnt apropiados para tu máquina.

• DevSpace: sigue Waishnav/devspace y conecta su entorno local a ChatGPT según las instrucciones de ese proyecto.

Abre una sesión de ChatGPT Quick Chat y verifica que el conector seleccionado puede leer un archivo inofensivo del proyecto antes de continuar. Esto es una configuración independiente del lado de ChatGPT; instalar ProBridge por sí solo no le da a ChatGPT acceso a tu Mac.

2. Instala ProBridge en el Mac

git clone https://github.com/HAMZADEMIR33412005/probridge.git
cd probridge
node scripts/build-ax.mjs
node scripts/install.mjs
node scripts/doctor.mjs

install.mjs crea ~/.codex/config.toml si es necesario, escribe la entrada MCP de ProBridge y en el archivo de configuración existente un backup con marca de tiempo. Luego concede Accesibilidad a bin/ax-driver si macOS lo pide, mantén Programa de CPT de escritorio y abre un nuevo chat de Codex.

No establece cwd; Codex debe iniciar el servidor desde el proyecto que ya tienes abierto.

MCP para Codex

Automático:

node scripts/install.mjs

Manual: copia examples/codex.config.toml en ~/.config/codex/config.toml y reemplaza la ruta absoluta del servidor.

El nombre de servidor registrado es probridge. Después de cualquier actualización, inicia un nuevo chat de Codex para que recargue el proceso MCP y el protocolo del daemon.

MCP para Claude Code / OpenCode / otros hosts

Apuntan a un servidor MCP stdio en este checkout:

{
  "mcpServers": {
    "probridge": {
      "command": "/Applications/ChatGPT.app/Contents/Resources/cua_node/bin/node",
      "args": ["/ABS/PATH/TO/probridge/src/server.mjs"]
    }
  }
}

Consulta examples/claude-code.mcp.json y examples/opencode.json. Si te falta el Node console que no se incluido con ChatGPT, cualquier binario Node 20+ funciona.

El host MCP debe iniciar el servidor desde el espacio de trabajo del proyecto, o bien indicar exactamente un raíz file://. ProBridge rechaza la carpeta home, Desktop, Documents y otras carpetas amplias similares.

Uso

Desde un agente en el espacio de trabajo del proyecto:

gpt56_pro_start({
  prompt: "Inspect the failing tests, fix the root cause, run focused tests, and report changed files."
})

Poll:

gpt56_pro_status({ jobId: "pro_..." })

Continúa el mismo Quick Chat después de que se complete:

gpt56_pro_followup({
  jobId: "pro_...",
  prompt: "Now implement the review findings."
})

Los trabajos se encolan. Se puede enviar un segundo New chat tan pronto como el prompt anterior se verifique como enviado. Los seguimientos quedan en la misma conversación.

El estado está en dos lugares:

• ~/.chatgpt-pro-subagent/ — estado autoritativo del daemon, cola y bloqueo

• <workspace>/.chatgpt-pro-jobs/<jobId>.md — archivo de control cooperativo que ChatGPT escribe a través de LocalAnt / DevSpace

Proyectos relacionados

• LocalAnt — puerta de enlace MCP local / conector de computadora de ChatGPT.

• DevSpace — conector de entorno local / computadora que se usa con ChatGPT

Plataformas compatibles

El servidor MCP, la cola y el protocolo de archivo de control son independientes del sistema. La pieza que falta en otras plataformas es una reemplazo confiable para src/native/ax-driver.swift.

Seguridad

ProBridge drive la aplicación de ChatGPT en la que ya has iniciado sesión, y luego ChatGPT usa LocalAnt / DevSpace para tocar el espacio de trabajo. Trátalo como una ejecución local de tu mismo usuario, no como un sandbox.

Los archivos en tiempo de ejecución bajo ~/.chatgpt-pro-subagent son privados (0700 / 0600). Los archivos de trabajo del workspace se excluyen de git mediante .git/info/exclude cuando sea posible. Las carpetas personales y amplias se rechazan como workspaces.

Desarrollo

npm test
npm run build:ax
node scripts/doctor.mjs

Licencia

MIT