セットアップガイド

3 つの部品が連携して動作します。Chrome 拡張機能、あなた自身のコンピューター上のサーバー、そして wcr コマンド(CLI と MCP サーバー)です。すべてローカルで動作します。

your AI assistant / script ──▶ wcr ──HTTP──▶ local server ◀──WebSocket── Chrome extension ──▶ ChatGPT, Gemini, …
                                          127.0.0.1:8787

アーリーアクセス

WebCodeReview はまだ一般にはインストールできません。wcr コマンドラインツール(npm パッケージ @webcodereview/cli)と Chrome ウェブストアの掲載は近日公開予定です。アーリーアクセスのユーザーには、インストール手順をメールでお送りします。ウェイトリストに登録してください。このページの以降の内容は、両方の構成要素をインストールした後のリファレンスです。

1. サーバーと wcr

Node.js 20 以降が必要です。サーバーは 127.0.0.1:8787 のみで待ち受けます。初回起動時にペアリング用 token を生成し、~/.config/webcodereview/token に保存します。wcr は WCR_TOKEN またはそのファイルから token を読み取り、サーバーをバックグラウンドで起動します(ログ: ~/.config/webcodereview/server.log)。起動は、WCR_PORT(デフォルトは 8787)で応答するものがないとき、たとえば wcr status の実行時に行われます。wcr serve を使えば、フォアグラウンドで実行することもできます。

2. Chrome 拡張機能

利用したい AI サイトにログインしている Chrome プロファイルに拡張機能をインストールし、その同じプロファイルで各サイトにログインしてください。初回のインストール時に、拡張機能はウェルカムページを開きます。

3. 拡張機能とサーバーをペアリングする

  1. ターミナルで wcr setup を実行します。必要に応じてサーバーを起動し、拡張機能のペアリングページで Chrome を開きます。Chrome を自動で開けない場合は、どうすればよいかをお知らせします。
  2. ペアリング用 token は、ページのアドレスの # の後ろに含まれる形で拡張機能に渡されるため、ネットワーク上には送信されません。コピーや貼り付けは不要です。
  3. するとポップアップに「このコンピューターの wcr に接続済み」と表示されます。

token が無効になった場合、ポップアップに「ペアリングが無効です」と表示されます。もう一度 wcr setup を実行してください。次のコマンドで接続を確認できます。

wcr status

同時に接続できるブラウザまたはプロファイルは 1 つだけです。2 つ目が接続すると、1 つ目は無効になります。そのポップアップには「別のブラウザが接続を引き継ぎました」と表示され、「このブラウザを使う」ボタンが現れます。

4. 依頼する: wcr ask

# one provider
wcr ask claude "Review this function for race conditions: ..."

# several providers in parallel (comma-separated), prompt from a file
wcr ask chatgpt,gemini,claude -f review.md

# prompt from stdin, per-provider timeout in seconds, raw JSON output
git diff | wcr ask chatgpt,deepseek -t 240 --json

プロバイダー: chatgpt、gemini、claude、deepseek、grok。デフォルトのタイムアウトは、プロバイダーごとに 180 秒です。1 つのプロバイダーが失敗しても(未ログイン、確認チャレンジ、タイムアウトなど)、他のプロバイダーは結果を返し、終了コードは 0 以外になります。

5 つのプロバイダー（ChatGPT、Gemini、Claude、DeepSeek、Grok）すべてを 2026-10-12 に実際のサイトで検証しました。チャットサイトはページを頻繁に変更するため、拡張機能が更新されるまでプロバイダーが動かなくなることがあります。

5. AI コーディングアシスタントから使う(MCP)

wcr mcp は標準的な stdio MCP サーバーなので、どの MCP クライアントからでも実行できます。ツール:

ツール用途
wcr_review_submit + wcr_review_result複数プロバイダーのレビューを開始し、その後ポーリングします(各ポーリングは最大 50 秒待ちます)。デフォルトではこれを使います。
wcr_ask, wcr_ask_manyブロッキング版で、1 回の呼び出しに 30〜180 秒かかります。ツールのタイムアウトが長いクライアント専用です。
wcr_automateブラウザの自動化。allowDomains は必須です。拡張機能で WebCodeReview にサインインしている必要があります。
wcr_status拡張機能は接続されているか?

重要なのは、クライアントの 1 回のツール呼び出しあたりのタイムアウトです。3 プロバイダーのレビューには、最大で約 270 秒かかることがあるためです。レビューのジョブはサーバーのメモリ上にあります。再起動すると失われ、個別にキャンセルすることはできません。

自動ブラウジングにはサインインが必要です

コードレビューにアカウントは不要です。アカウントが必要なのは自動ブラウジングだけです。拡張機能のポップアップを開き、「自動ブラウジング」の行(サインインするまでは「サインイン後に利用できます」と表示されます)で「Google で続ける」をクリックし、Chrome 自身のウィンドウで Google アカウントを選択してください。その後、「自動ブラウジング」のスイッチをオンにすると、Chrome がすべてのウェブサイトへのアクセス許可を求めます。ポップアップ上部の「サインイン」チップからもサインインを開始できます。ワンクリックのサインインがうまくいかない場合は、「ウェブサイトでサインインする」を使い、webcodereview.com/device でブラウザを承認してください。スイッチをオフにすると自動化は停止しますが、その権限は取り消されません。完全に取り消すには、chrome://extensions を開き、WebCodeReview を選んで「サイトアクセス」を変更してください。

Claude Code (テスト済み)

claude mcp add wcr -- wcr mcp
# add --scope user to make it available in every project

実際のツール呼び出しで、エンドツーエンドでテストしました。330 秒のツール呼び出しが正常に返りました(Claude Code v2.1.222 で計測)。

Codex (未検証)

codex mcp add wcr -- wcr mcp

または ~/.codex/config.toml に:

[mcp_servers.wcr]
command = "wcr"
args = ["mcp"]
tool_timeout_sec = 120   # optional: the 60 s default is enough for wcr_review_result (waits <= 50 s)

設定を読み戻して確認しただけで、Codex 経由のツール呼び出しはテストしていません。60 秒というデフォルトのタイムアウトはドキュメントに基づくもので、計測はしていません。複数プロバイダーのレビューには、wcr_review_submit と wcr_review_result を使ってください。

Cursor (未検証)

~/.cursor/mcp.json(またはプロジェクト内の .cursor/mcp.json)に追加します:

{ "mcpServers": { "wcr": { "command": "wcr", "args": ["mcp"] } } }

まったくテストしていません。フォーラムの報告では、Cursor は約 60 秒で呼び出しを打ち切り、これは設定で変更できないとされていますが、未計測です。複数プロバイダーのレビューには、wcr_review_submit と wcr_review_result を使ってください。

使うタイミングをエージェントに伝える

レビューには 30〜180 秒かかり、あなたのチャットアカウントを使います。そのため、すべての編集ではなく、影響の大きい変更やセキュリティ上重要な変更に使うよう、エージェントに伝えてください。資料はすべてプロンプトに含め、秘密情報は決して含めないでください。回答は、検証済みの指摘ではなく、確認すべき独立した意見として扱ってください。結果に、プロンプトがすでに送信された可能性があると書かれている場合は、確認せずに再送しないでください。サーバーのリポジトリには、CLAUDE.md、AGENTS.md、または Cursor ルールにそのまま使える文面が agent-guide.md として含まれています。

セキュリティに関する注意