Codex ↔ Upwork MCP Bridge

Eine inoffizielle Kompatibilitätsbrücke für die Verwendung des Upwork-MCP-Servers mit OpenAI Codex und der ChatGPT-Desktopanwendung.

Der Upwork-MCP-Server kann sich in einigen MCP-Clients authentifizieren und funktionieren, während Codex seine Tools nicht bereitstellt oder einen Unexpected response type-Fehler meldet. Diese kleine stdio-Brücke führt mcp-remote aus, beantwortet Upworks Server-zu-Client-Ping-Anfragen lokal und entfernt zwei Cache-Hinweise, die in tools/list-Antworten beobachtet wurden, bevor sie an Codex weitergeleitet werden.

Dies ist eine Community-Problemumgehung, kein offizielles Upwork- oder OpenAI-Projekt. Versuchen Sie zuerst den Upwork-MCP-Endpunkt direkt. Das Kompatibilitätsproblem kann jederzeit upstream behoben werden.

Status

Getestet auf macOS mit Codex CLI 0.149.0, Bun und https://mcp.upwork.com/mcp. Dieselbe Codex-MCP-Konfiguration ist auch für die ChatGPT-Desktopanwendung verfügbar, wenn beide die gemeinsame Codex-Konfiguration verwenden.

Das genaue fehlerhafte Feld wurde noch nicht mit einer minimalen Upstream-Reproduktion isoliert. Die Brücke normalisiert beide Protokollunterschiede, die während des fehlerhaften Austauschs beobachtet wurden:

• Es beantwortet JSON-RPC-ping-Anfragen, die vom Server an den Client gesendet werden.

• Es entfernt ttlMs- und cacheScope-Cache-Hinweise aus Tool-Listen-Ergebnissen.

Diese Cache-Hinweise existieren in neueren MCP-Entwürfen; das Interoperabilitätsproblem besteht darin, dass sie zurückgegeben wurden, während eine ältere Protokollrevision ausgehandelt wurde, nicht dass die Felder allgemein ungültig sind.

Related MCP server: MCP Token Bridge

Install

Voraussetzungen:

• Bun 1.2 oder neuer

• Codex CLI

• Ein Webbrowser für Upwork OAuth

Klonen und Abhängigkeiten installieren:

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

Registrieren Sie die Brücke bei Codex, indem Sie den Beispielpfad durch den absoluten Pfad zu Ihrem Klon ersetzen:

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

Wenn Sie bereits einen MCP-Server namens upwork haben, entfernen oder benennen Sie diesen Eintrag um, bevor Sie den Befehl ausführen. Starten Sie Codex und ChatGPT neu, nachdem Sie die MCP-Konfiguration geändert haben. Beim ersten Gebrauch öffnet mcp-remote die OAuth-Autorisierung von Upwork in Ihrem Browser.

Sie können es auch manuell zu ~/.codex/config.toml hinzufügen:

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

Finden Sie den absoluten Pfad von Bun mit command -v bun.

Verify

codex mcp list
codex mcp get upwork

Bitten Sie dann Codex, die verfügbaren Upwork-Tools aufzulisten oder eine schreibgeschützte Aktion auszuführen, z. B. Ihr Upwork-Profil anzuzeigen. Vermeiden Sie es, private Tool-Ausgaben zu posten, wenn Sie ein Problem melden.

Remove

codex mcp remove upwork

Das Entfernen des Codex-Eintrags entfernt nicht die lokale OAuth-Sitzung von mcp-remote. Konsultieren Sie die mcp-remote-Dokumentation, wenn Sie diese Sitzung ebenfalls löschen möchten.

How it works

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

Die Brücke ändert nur die beiden beobachteten Kompatibilitätspunkte. Andere JSON-RPC-Nachrichten werden durchgereicht. Protokollverkehr bleibt auf stdout; Diagnosen gehen an stderr, damit sie den MCP-Stream nicht beschädigen können.

Related Codex reports

Dieses Repository behandelt den Upwork-Fall, aber ähnliche Berichte beschreiben, dass Codex MCP-Tool-Ergebnisse ablehnt oder nicht anzeigt, die in anderen Clients funktionieren:

• Gültige MCP-Ergebnisse als unerwarteter Antworttyp dekodiert

• Spezifikationskonforme Annotationen von Codex abgelehnt

• MCP-Server verbindet sich, aber Tools werden nicht aufgelistet

• Anfrage für bessere MCP-Diagnose

Development

bun install --frozen-lockfile
bun test

License

MIT