Skip to main content
Glama

SolicitudPro Bridge

SolicitudPro Bridge conecta un cliente MCP con una instancia local de Codex sin exponer directamente el equipo ni convertir el gateway cloud en un ejecutor de comandos. Está diseñado para inspeccionar proyectos y aplicar cambios mediante un flujo explícito, trazable y limitado por proyecto y archivo.

Arquitectura

flowchart LR
  A[ChatGPT / cliente MCP] -->|OAuth + MCP| B[Cloudflare Worker]
  B --> C[Durable Object relay]
  C -->|WebSocket saliente autenticado| D[Bridge local]
  D --> E[Codex app-server]
  E --> F[Repositorio local autorizado]

El PC inicia una conexión saliente hacia el relay; no necesita abrir puertos de entrada. Cada dispositivo usa un deviceId y una credencial independientes. Si hay varios dispositivos activos, el routing exige una selección inequívoca en lugar de elegir uno silenciosamente.

Related MCP server: codex-session-gateway

Capacidades destacadas

  • MCP local por stdio y transporte cloud controlado.

  • Gateway Cloudflare con OAuth, scopes y cuotas por dispositivo.

  • Relay autenticado con heartbeat, reconexión y routing multi-device.

  • Integración con Codex app-server y threads persistentes por dispositivo y proyecto.

  • Perfiles de ejecución y Context Capsule con estado Git contemporáneo.

  • Lecturas allowlisted de contexto, estado Git y búsqueda literal.

  • Cambios controlados mediante PREPARE → APPROVE → APPLY.

Modelo de seguridad

  • Proyectos y raíces legibles/escribibles definidos en configuración local.

  • Credenciales, tokens, estado y rutas físicas fuera de Git.

  • OAuth y scopes separados para lectura y escritura.

  • Approval de un solo uso, con TTL, HEAD, fingerprint y lista exacta de archivos.

  • APPLY limitado al sandbox aprobado, sin fallback silencioso ni shell libre.

  • Binding entre approval y dispositivo para evitar aplicar en otro PC.

  • Errores saneados y límites de tamaño, cuota y concurrencia.

El Bridge no elimina la necesidad de revisar el plan y el diff. Un approval autoriza únicamente la operación preparada y vinculada a su estado Git.

Requisitos

  • Node.js 22 o superior.

  • Codex CLI con sesión local válida y soporte de codex app-server.

  • Un repositorio local que se quiera autorizar explícitamente.

  • Para el gateway opcional: cuenta Cloudflare y configuración OAuth propia.

Instalación local

npm ci
Copy-Item config/local.example.json config/local.json

Edita únicamente config/local.json con valores locales. Ejemplo conceptual:

{
  "projects": {
    "my-project": {
      "path": "C:\\path\\to\\project",
      "searchRoots": ["src", "tests", "docs"],
      "changeRoots": ["src", "tests"]
    }
  },
  "relay": {
    "enabled": false,
    "gatewayOrigin": "https://your-worker.workers.dev",
    "deviceId": "your-device-id",
    "tokenFile": "config/relay-token.txt"
  }
}

config/local.json, credenciales, tokens, logs y estado runtime están ignorados y no deben versionarse.

Ejecutar

npm run check
npm run build
npm test
npm start

Para el relay configurado:

npm run doctor
npm run relay

Validación

npm test
npm run test:integration
npm run cloud:check
npm run cloud:build

cloud:build usa el modo --dry-run; no despliega recursos. Las integraciones reales requieren Codex local y se ejecutan únicamente en un entorno controlado.

Documentación

Limitaciones

  • No es un servicio multiusuario listo para producción.

  • El gateway y OAuth deben desplegarse y administrarse en una cuenta propia.

  • Cada dispositivo mantiene su configuración, credencial y thread local.

  • No se comparten sesiones de Codex ni bases de estado entre equipos.

  • No existe rollback automático ante una escritura parcial; APPLY revalida el checkout inmediatamente antes de escribir.

Estado

Proyecto técnico funcional y validado en entornos controlados. Este snapshot de portfolio contiene código, tests y ejemplos saneados, sin credenciales, IDs de dispositivos reales ni endpoints privados.

Licencia

No se incluye licencia todavía. Antes de publicar, se recomienda adoptar una licencia open source explícita que permita estudiar, usar y contribuir al proyecto manteniendo atribución y condiciones claras.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients to safely access user-local filesystems, apply validated patches, inspect git state, and run persistent jobs on outbound-connected local runners through a stateless Cloudflare control plane.
      18
      PolyForm Noncommercial 1.0.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Bridges remote MCP clients such as ChatGPT connectors, Codex, and other MCP agents to a local DSH Relay MCP endpoint by providing an OAuth 2.1 authorization server plus a tool allowlist proxy that works behind a Cloudflare Tunnel. It exposes a controlled subset of relay tools (with added session archiving and permission reconciliation) so remote clients can list workspaces, dispatch read-only or writable runs, and monitor or steer them on the local machine.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to connect once to self-hosted, user-owned upstream accounts and then discover and invoke granted tools through a single authenticated endpoint. Each client receives its own key with deny-by-default tool grants, while sensitive calls require durable human approval and credentials stay encrypted and never forwarded upstream.
      Apache 2.0