Codex ↔ Upwork MCP Bridge

Un puente de compatibilidad no oficial para usar el servidor MCP de Upwork con OpenAI Codex y la aplicación de escritorio de ChatGPT.

El servidor MCP de Upwork puede autenticarse y funcionar en algunos clientes MCP, mientras que Codex no expone sus herramientas o informa de un error Unexpected response type. Este pequeño puente stdio ejecuta mcp-remote, responde localmente a las solicitudes ping que el servidor de Upwork envía al cliente y elimina dos sugerencias de caché observadas en las respuestas de tools/list antes de reenviarlas a Codex.

Esto es una solución comunitaria, no un proyecto oficial de Upwork ni de OpenAI. Prueba primero el endpoint de MCP de Upwork directamente. El problema de compatibilidad puede corregirse upstream en cualquier momento.

Estado

Probado en macOS con Codex CLI 0.149.0, Bun y https://mcp.upwork.com/mcp. La misma configuración de MCP de Codex también está disponible para la aplicación de escritorio de ChatGPT cuando ambos usan la configuración compartida de Codex.

El campo exacto que falla aún no se ha aislado con una reproducción mínima upstream. El puente normaliza las dos diferencias de protocolo observadas durante el intercambio fallido:

• Responde a las solicitudes ping JSON-RPC enviadas del servidor al cliente.

• Elimina las sugerencias de caché ttlMs y cacheScope de los resultados de tools/list.

Esas sugerencias de caché existen en borradores más recientes de MCP; la preocupación de interoperabilidad es que se devolvieron mientras se negociaba una revisión anterior del protocolo, no que los campos sean universalmente inválidos.

Related MCP server: harness_to_mcp

Instalación

Requisitos previos:

• Bun 1.2 o superior

• Codex CLI

• Un navegador web para la autorización OAuth de Upwork

Clona el repositorio e instala las dependencias:

git clone https://github.com/drharunyuksel/codex-upwork-mcp-bridge.git
cd codex-upwork-mcp-bridge
bun install --frozen-lockfile

Registra el puente con Codex, reemplazando la ruta de ejemplo por la ruta absoluta de tu clon:

codex mcp add upwork -- bun run /absolute/path/to/codex-upwork-mcp-bridge/src/index.ts

Si ya tienes un servidor MCP llamado upwork, elimina o renombra esa entrada antes de ejecutar la orden. Reinicia Codex y ChatGPT después de cambiar la configuración de MCP. En el primer uso, mcp-remote abrirá la autorización OAuth de Upwork en tu navegador.

También puedes añadirlo manualmente a la ~/.codex/config.toml:

[mcp_servers.upwork]
command = "/absolute/path/to/bun"
args = ["run", "/absolute/path/to/codex-upwork-mcp-bridge/src/index.ts"]
startup_timeout_sec = 60

Encuentra la ruta absoluta de Bun con command -v bun.

Verificación

codex mcp list
codex mcp get upwork

Después, pide a Codex que enumere las herramientas de Upwork disponibles o que realice una acción de solo lectura, como mostrar tu perfil de Upwork. Evita publicar la salida privada de las herramientas si vas a informar de un problema.

Desinstalación

codex mcp remove upwork

Eliminar la entrada de Codex no elimina la sesión OAuth local de mcp-remote. Consulta la documentación de mcp-remote si también quieres borrar esa sesión.

Cómo funciona

Codex / ChatGPT  <-- stdio JSON-RPC -->  this bridge
                                             |
                                             v
                                        mcp-remote
                                             |
                                             v
                                 https://mcp.upwork.com/mcp

El puente solo cambia los dos puntos de compatibilidad observados. El resto de mensajes JSON-RPC pasan directamente. El tráfico de protocolo queda en stdout; los diagnósticos van a stderr para no corromper el flujo MCP.

Informes relacionados con Codex

Este repositorio aborda el caso de Upwork, pero hay informe similares que describen cómo Codex rechaza o no muestra resultados de herramientas MCP que funcionan en otros clientes:

• Resultados MCP válidos decodificados como un tipo de respuesta inesperado

• Anotaciones válidas por la especificación rechazadas por Codex

• El servidor MCP se conecta, pero las herramientas no se muestran

• Solicitud de mejores diagnósticos de MCP

Desarrollo

bun install --frozen-lockfile
bun test

Licencia

MIT