Codex ↔ Upwork MCP ブリッジ

Upwork の MCP サーバーを OpenAI Codex および ChatGPT デスクトップアプリケーションで使用するための非公式互換ブリッジです。

Upwork の MCP サーバーは一部の MCP クライアントでは認証と動作が可能ですが、Codex ではツールが公開されなかったり、Unexpected response type エラーが報告されたりします。この小さな stdio ブリッジは mcp-remote を実行し、Upwork のサーバーからクライアントへの ping リクエストにローカルで応答し、tools/list レスポンスで観測された 2 つのキャッシュヒントを Codex に転送する前に削除します。

これはコミュニティによる回避策であり、Upwork または OpenAI の公式プロジェクトではありません。まず Upwork の MCP エンドポイントを直接お試しください。互換性の問題はいつでも上流で修正される可能性があります。

ステータス

macOS で Codex CLI 0.149.0、Bun、および https://mcp.upwork.com/mcp を使用してテスト済みです。同じ Codex MCP 設定は、共有の Codex 設定を使用する場合、ChatGPT デスクトップアプリケーションでも利用できます。

正確な失敗フィールドは、最小限の上流リポジトリでの再現によってまだ特定されていません。このブリッジは、失敗したやり取り中に観測された 2 つのプロトコル差分を正規化します:

• サーバーからクライアントに送信される JSON-RPC ping リクエストに応答します。

• ツールリストの結果から ttlMs および cacheScope キャッシュヒントを削除します。

これらのキャッシュヒントは新しい MCP ドラフトに存在します。相互運用性の懸念は、これらのフィールドが普遍的に無効であるということではなく、古いプロトコルリビジョンがネゴシエートされている間に返されたということです。

Related MCP server: MCP Token Bridge

インストール

前提条件:

• Bun 1.2 以降

• Codex CLI

• Upwork OAuth 用のウェブブラウザ

クローンして依存関係をインストールします:

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

ブリッジを Codex に登録します。例のパスをクローン先の絶対パスに置き換えてください:

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

すでに upwork という名前の MCP サーバーがある場合は、コマンドを実行する前にそのエントリを削除または名前変更してください。MCP 設定を変更した後は、Codex と ChatGPT を再起動してください。初回使用時、mcp-remote はブラウザで Upwork の OAuth 認証を開きます。

~/.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

Bun の絶対パスは command -v bun で確認できます。

検証

codex mcp list
codex mcp get upwork

次に、Codex に利用可能な Upwork ツールの一覧表示や、Upwork プロフィールの表示などの読み取り専用アクションを依頼してください。問題を報告する際は、プライベートなツール出力を投稿しないでください。

削除

codex mcp remove upwork

Codex のエントリを削除しても、mcp-remote のローカル OAuth セッションは削除されません。そのセッションもクリアしたい場合は、mcp-remote のドキュメントを参照してください。

仕組み

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

このブリッジは、観測された 2 つの互換性ポイントのみを変更します。その他の JSON-RPC メッセージはそのまま通過します。プロトコルトラフィックは stdout に残り、診断情報は stderr に出力されるため、MCP ストリームを破損させることはありません。

関連する Codex レポート

このリポジトリは Upwork のケースに対応していますが、同様のレポートでは、他のクライアントでは動作する MCP ツールの結果を Codex が拒否したり、表示できなかったりするケースが説明されています:

• 有効な MCP 結果が予期しないレスポンスタイプとしてデコードされる

• 仕様に準拠したアノテーションが Codex に拒否される

• MCP サーバーは接続されるがツールが一覧表示されない

• より良い MCP 診断のリクエスト

開発

bun install --frozen-lockfile
bun test

ライセンス

MIT