Codex に solvethree MCP を追加する

1. 1.

   Node.js 22 と npx を使用できるようにする

   Codex を実行するプロセスから使用できる必要があります。Codex がアクセスできない別の環境にインストールしても、サーバーを起動できるようにはなりません。

2. 2.

   ホストの環境変数を設定する

   SOLVETHREE_API_KEY にワークスペースの API キーを、SOLVETHREE_PROXY にプロキシ URL を設定してください。これらの変数を使用できる状態で Codex を起動してください。IDE 連携の場合は、IDE プロセスもこれらを継承していることを確認してください。API キーをプロンプトやソース管理に含めないでください。

3. 3.

   reCAPTCHA サイトプロファイルを有効にする

   サイトプロファイルで HTTPS ページ URL を追加し、reCAPTCHA の種類を選択して、キャプチャアクションを指定してください。プロファイルが有効になるまで待ってください。必要なホスト名、キャプチャアクション、種類を設定してください。タスクのサイトとアクションによってプロファイルが作成されるわけではありません。初めての対象の場合は、サイトプロファイルの設定を参照してください。

Codex CLI と IDE は ~/.codex/config.toml を共有します。信頼済みプロジェクトの .codex/config.toml も使用できます。以下のサーバーエントリを追加してください。

[mcp_servers.solvethree]
command = "npx"
args = ["--yes", "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz", "solvethree-mcp"]
env_vars = ["SOLVETHREE_API_KEY", "SOLVETHREE_PROXY"]
startup_timeout_sec = 60
tool_timeout_sec = 100

このエントリは、公式 SDK の solvethree-mcp 実行ファイルを npx 経由で実行します。env_vars は既存のホスト変数を転送するもので、値を代入するものではありません。このローカルサーバーには、入力するホスト型 MCP エンドポイントも、OAuth ログインもありません。

startup_timeout_sec はサーバーの起動に 60 秒を許容します。tool_timeout_sec はツール呼び出しに 100 秒を許容します。どちらの設定も、対象ウェブサイトがソリューションを受け入れたことを意味するものではありません。

codex mcp list を実行するか、Codex TUI で /mcp を開いて、設定済みのサーバーを確認してください。起動できない場合は、Codex が npx を見つけられることと、両方の環境変数を継承していることを確認してください。

1. 1.

   利用可能な機能を確認する

   解決ツールを選ぶ前に、Codex に solvethree_capabilities を呼び出させてください。reCAPTCHA には solvethree_create_recaptcha を使用します。

2. 2.

   reCAPTCHA の入力を指定する

   site にホスト名を指定し、action と requestId を渡してください。このツールでは、任意で recaptchaType と waitMs も指定できます。デフォルトの種類は enterprise-v3 です。使用する単一のプロキシは SOLVETHREE_PROXY から読み取られるため、呼び出しごとに設定するプロキシとして扱わないでください。reCAPTCHA リクエストに type や url フィールドを追加しないでください。

3. 3.

   タスクIDを保持してステータスを確認する

   各作成呼び出しで作成されるタスクは最大で 1 件です。返された ID を使い、solvethree_get_task でそのタスクを取得してください。ステータスが pending または solving の間は確認を続けます。利用可能な解決結果が含まれるのは ready のみです。failed になった場合はポーリングを停止し、errorCode と error を確認してから、変更内容を判断してください。

MCP サーバーはブラウザーの操作、現在のセッションの検査、フォームへの入力を行いません。アプリケーション側で、準備ができた reCAPTCHA の結果を受け取り、solution.token を目的の送信先に送信する必要があります。

返された userAgent と secChUa によるブラウザー識別情報を、解決時と同じプロキシで使用してください。ブラウザーや HTTP クライアントが異なるプロキシや無関係なブラウザー識別情報を使用している場合は、送信前に修正してください。MCP サーバーを追加しても、これらの設定は自動では行われません。

Codex はツールの応答を通じて非公開の解決データを受け取るため、共有レポートやログに含めないでください。タスクが ready であることは、解決結果が生成されたことを意味します。アプリケーションのリクエストが受け入れられたかどうかは、送信先の応答を別途確認してください。