Chrome DevTools MCP 1.13でAPIの応答をモックする|mock_networkを有効にする設定と、ログポイントで値を確かめる方法

Chrome DevTools MCP 1.13.0で、通信の差し替えとログポイントが使えるようになった

Chromeの開発者ツール(DevTools)のチームが、2026年11月11日にChrome DevTools MCPの1.13.0を公開しました(1.13.0のリリースノート)。Chrome DevTools MCP(公式READMEの題名は「Chrome DevTools for agents」、パッケージ名はchrome-devtools-mcp)は、Gemini CLI、Codex、CursorなどのAIコーディングエージェントにChromeを操作させ、DevToolsで見られる通信やコンソールの情報を読ませるMCPサーバーです。

1.13.0では、ページが受け取る通信の応答を手元のファイルや別のURLの応答に差し替える「ネットワークモック」と、コードを書き換えずに変数の値をコンソールへ書き出す「ログポイント」が加わりました。モックは、本物のサーバーの代わりに用意した応答を返す仕組みです。APIが空の一覧やエラーを返したときの画面を、サーバー側のデータを変えずにAIエージェントに確かめさせられます。

この記事では、1.12.0と1.13.0を、TypeScriptで書いた小さな在庫一覧のページと手元のChrome 157(画面を出さないヘッドレスモード)で比べました。モックを有効にする設定、応答のファイルを置けるフォルダー、差し替えの規則、別のURLに差し替えるときの制限、ログポイントの置き方と値が出ないときの原因を、確かめた順に説明します。

要点

設定に2つのオプションを足すと、AIエージェントがAPIの応答を差し替えて画面を確かめられる

Chrome DevTools MCP 1.13.0とChrome 157で、テスト用のページを使って確かめた結果です。

有効にする

モックは、起動オプションを1つ足して有効にする

--categoryNetworkMocksを付けないと、mock_networkはツールの一覧に出ません。ログポイントのset_logpointsは最初から使えます。

ファイルの置き場所

--workspaceで指定したフォルダーに置く

指定したフォルダーとOSの一時フォルダーの外にあるファイルは、「Access denied」で使えませんでした。

差し替えの規則

再読み込みで反映し、後から設定したモックが優先される

モックは設定したページ(タブ)だけに効き、別のURLへ移動して戻っても残りました。

ログポイント

元のTypeScriptの行を指定して値を記録できる

ソースマップで生成後のJavaScriptの行に置かれ、再読み込みしても残りました。

ネットワークモックは、起動オプションに--categoryNetworkMocksを足して有効にする

1.13.0を入れただけでは、ネットワークモックのツールは使えません。起動オプションの組み合わせごとに、MCPクライアントへ渡されるツールの一覧を比べました。

1.12.0(オプションなし)

モックもログポイントもなし

ツールは32個です。

1.13.0(オプションなし)

ログポイントだけ使える

set_logpointsが加わり33個になりました。

1.13.0 + --categoryNetworkMocks

モックとログポイントの両方が使える

mock_networkとremove_network_mockが加わり35個になりました。

1.13.0 + --categoryNetworkMocks + --no-javascript-evaluation

ログポイントが消える

JavaScriptを実行するツールを止めるオプションで、evaluate_scriptとset_logpointsが一覧から外れました。

MCPクライアントの設定ファイルでは、argsにオプションを足します。公式のREADMEにあるmcpServersの書き方に、2つのオプションを足した例です。

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--categoryNetworkMocks",
        "--workspace",
        "/path/to/project/mocks"
      ]
    }
  }
}

書き方はクライアントごとに違います。Codexのconfig.tomlなどの書き方は、公式のClient Configurations Guideにあります。

オプションを変えたら、MCPサーバーを起動し直します。--categoryNetworkMocksを変えたときは再起動が要ると、公式の設定のドキュメントに書かれています。

--workspaceは、MCPサーバーがファイルを読み書きしてよいフォルダーを指定するオプションです。モックの応答に使うファイルは、このフォルダーの中に置きます。指定しないと、プロジェクトのフォルダーにあるファイルを渡したときに次のエラーになりました。

Error: Access denied: path "/…/mocks/items-empty.json" (…) is not within any of the configured workspace roots.

--workspaceを付けない場合でも、OSの一時フォルダー(macOSでは$TMPDIR)に置いたファイルは使えました。MCPクライアントが、開いているプロジェクトのフォルダーの一覧(roots)をサーバーに知らせる場合は、そのフォルダーの中のファイルも使えました。手元では、rootsを知らせる最小のクライアントで確かめています。クライアントの違いに関係なくファイルを使えるように、--workspaceを付けておきます。

JSONファイルを用意すれば、APIの応答を差し替えて画面を確かめられる

テスト用のページは、/api/items?lang=jaから商品の配列を受け取り、件数と在庫の合計を表示します。このAPIの応答を、中身が[]のファイル(items-empty.json)に差し替えて、空の一覧の表示を確かめました。

AIエージェントは、次の引数でmock_networkを呼びます。手元では、ツールを直接呼ぶ最小のMCPクライアントで同じ呼び出しを送りました。pageIdは対象のページ(タブ)の番号で、new_pageやlist_pagesの応答に出ます。routeは差し替えるURL、bodyは応答に使うファイルの絶対パスです。

mock_network {
  "pageId": 2,
  "route": "http://127.0.0.1:8765/api/items",
  "body": "/path/to/project/mocks/items-empty.json"
}

Network mock configured. Reload or navigate the page to apply it.
Network mocks disable the page HTTP cache and intercept every request. (以下略)
http://127.0.0.1:8765/api/items -> /path/to/project/mocks/items-empty.json (application/json; charset=utf-8)
  Since configured: 0 hits, 0 errors.
  No matches yet. Navigate or reload to verify this rule.

設定しただけでは、開いている画面は変わりません。応答に書かれているとおり、ページを再読み込みすると差し替えた応答で表示されます。

モックなし(本物のAPI)

在庫一覧のページ。「3件・在庫の合計 7,010円」と、ノート、ボールペン、付せんの3行が表示されている

/api/itemsを [] のファイルに差し替え

在庫一覧のページ。一覧の行はなく「商品がありません」とだけ表示されている
同じページを、モックを設定する前と、設定して再読み込みしたあとに、Chrome DevTools MCPのtake_screenshotで撮影。空の一覧の表示に切り替わりました。macOS 27.0.1、Chrome 157、Chrome DevTools MCP 1.13.0。2026年11月15日に確認。

モックが効いている間、テスト用のサーバーのログに/api/itemsへの要求は記録されませんでした。Chromeの中で応答が差し替わるので、サーバーのデータを空にしたり、エラーを返すようにコードを変えたりする必要はありません。

差し替えの規則は、次の4つを確かめました。

モックの差し替えで確かめた規則

  1. ファイルは要求のたびに読み直す。ファイルの中身をセール価格の2件に書き換えて再読み込みすると、MCPサーバーを起動し直さずに「2件・在庫の合計 2,880円」に変わりました。
  2. routeにクエリを書かなければ、どのクエリにも当たる。ページの要求は?lang=ja付きでしたが、クエリなしのrouteで差し替わりました。
  3. モックは設定したページだけに効き、移動しても残る。new_pageで開いた別のページでは本物の3件が表示されました。設定したページで別のURLへ移動して戻ると、まだ空の一覧でした。
  4. 同じURLに当たるモックが2つあると、後から設定したほうが使われる。完全一致のrouteのあとにhttp://127.0.0.1:8765/api/*を設定するとワイルドカードの応答に、完全一致のほうを設定し直すとそちらの応答に変わりました。

応答のContent-Typeは、ファイルの拡張子で決まります。.jsonのファイルではapplication/json; charset=utf-8になり、ページのres.json()はそのまま動きました。

差し替えが効かないときは、URLの書き方と要求の種類を確かめる

モックの一覧は、mock_networkをpageIdだけで呼ぶと表示されます。各モックに、当たった回数(hits)と、差し替えに失敗した回数(errors)が付きます。再読み込みしても画面が変わらないときは、まずここを見ます。次は、一覧の一部です。

http://127.0.0.1:8765/api/items [xhr] -> /path/to/project/mocks/items-empty.json (application/json; charset=utf-8)
  Since configured: 0 hits, 0 errors.
  Warning: no requests matched after navigation. Check the full-URL pattern, resource type, and service worker.

この例は、resourceType(要求の種類)をxhrに限ったモックです。ページはfetch()でAPIを呼んでいるので、要求の種類はfetchになり、モックは当たりませんでした。resourceTypeをfetchにするか、指定を外すと当たります。警告の文にもあるとおり、サービスワーカーが応答を返すページでは、モックを通らないことがあるとツールリファレンスに書かれています。

0 hits と警告が出る

routeかresourceTypeが要求と合っていない

routeに?lang=enのようなクエリを書くと、そのクエリの要求だけに当たります。fetch()の要求はxhrでは当たりません。

設定の時点でエラー

routeは絶対URLで書き、ワイルドカードには「*」だけを使う

/api/itemsのような相対URL、(items|stock)のような正規表現、:nameは、どれも入力エラーで設定されませんでした。

1 errors が出る

応答のファイルを読めなかった

設定後にファイルを消すと、ページは「Failed to fetch」になり、一覧にLast error: … ENOENTが出ました。

モックを外すときはremove_network_mockを使います。routeを渡すと、設定したときと同じ文字列のモックだけを外します。pageIdだけを渡すと、そのページのモックをすべて外します。

mock_networkのupstreamで、APIの応答を検証環境やエラーの応答に切り替えられる

mock_networkには、ファイルの代わりにURLを渡すupstreamもあります。指定したURLへMCPサーバーが要求を送り、返ってきた応答をページに渡します(upstreamを加えたプルリクエスト)。本番のページを開いたまま、APIだけを検証環境の応答に切り替えるといった使い方ができます。

Chrome DevTools MCPは、ブラウザーの中身をMCPクライアントが読み、書き換えられるようにするツールです。公式のREADMEも、MCPクライアントに見せたくない情報をブラウザーに入れないよう注意しています。本番のページで試すときは、テスト用のアカウントでログインします。

手元では、本番役(ポート8765)のページの/api/itemsを、検証環境役(ポート8766)の/api/itemsに差し替えました。続けて、500を返すURLにも差し替えました。

mock_network {
  "pageId": 2,
  "route": "http://127.0.0.1:8765/api/items",
  "upstream": "http://127.0.0.1:8766/api/items"
}

upstreamを検証環境役のAPIに

在庫一覧のページ。「1件・在庫の合計 200円」と「ノート(検証環境) 200円 × 1」が表示されている

upstreamを500を返すURLに

在庫一覧のページ。「読み込みに失敗しました: HTTP 500」と表示されている
本番役のページのまま、APIの応答だけを検証環境役のサーバーの応答に差し替えた画面。500の状態コードもそのままページに届き、エラー表示を確かめられました。macOS 27.0.1、Chrome 157、Chrome DevTools MCP 1.13.0。2026年11月15日に確認。

upstreamに渡したURLは、そのまま呼ばれます。ページは/api/items?lang=jaを要求しましたが、検証環境役のサーバーに届いたのは/api/itemsでした。クエリで応答が変わるAPIは、upstreamのURLにクエリまで書きます。?lang=jaまで書くと、そのクエリで呼ばれました。

routeにクエリを書かないモックでは、どのクエリの要求も、upstreamに書いた同じURLへ送られます。?lang=enと?page=2の要求も、?lang=ja付きのupstreamで呼ばれました。クエリごとに別の応答が要るときは、routeとupstreamの両方に同じクエリを書いたモックを、クエリごとに設定します。?lang=jaと?lang=enの組を設定すると、それぞれのクエリで呼ばれ、どちらにも当たらない?page=2は本物のサーバーに届きました。

upstreamは、GETとHEADの要求だけを差し替えます。upstreamのモックが当たるURLへページからPOSTすると、ページ側は「Failed to fetch」になり、どちらのサーバーにも要求は届きませんでした。モックの一覧には次のエラーが出ます。

Last error: Failed to load http://127.0.0.1:8766/api/items: Upstream mocks only support GET and HEAD requests.

ローカルファイルのモックは、POSTにもファイルの中身を200で返しました。送信ボタンを押したあとの表示を確かめたいときは、ファイルのモックを使います。

upstreamでもう1つ気をつけるのは、ページが付けたヘッダーの扱いです。ページからAuthorizationと独自のヘッダー、Cookieを付けて要求し、upstreamの先のサーバーに届いたヘッダーを記録しました。オリジンは、URLのスキーム、ホスト、ポートの組です。ポートが違えば別のオリジンになります。

別のオリジンへ差し替え(:8765 → :8766)

Authorization、Cookie、独自のヘッダーは届かない

届いたのはUser-Agent、Accept、Accept-Language(値は「*」)などだけでした。ログインが要るAPIは、未ログインの状態で呼ばれます。

同じオリジンの別のパスへ差し替え

Authorization、Cookie、独自のヘッダーも届く

AuthorizationとCookie、独自のヘッダーは、ページの要求のまま届きました。Accept-Languageは「*」に変わり、Sec-Fetch-Siteなど、ブラウザーが付ける一部のヘッダーは付きませんでした。

upstreamのプルリクエストにも、別のオリジンへ移るときは認証情報と許可されていないヘッダーを落とすと書かれています。別のオリジンにある、ログインが要る検証環境のAPIに差し替えたいときは、検証環境の応答をファイルに保存してbodyで渡すと、ページのログイン状態に関係なく同じ応答を返せます。保存する前に、応答に個人情報やトークンが入っていないかを確かめ、そのファイルはコミットしないよう、.gitignoreに入れておきます。

upstreamには絶対URLを渡します。/api/itemsのような相対URLやfile:のURLは、「upstream: Invalid URL」で設定されませんでした。

ログポイントは、元のTypeScriptの行を指定して変数の値を記録する

ログポイントは、指定した行が実行されるたびに、式の値をコンソールへ書き出す仕組みです。DevToolsのSourcesパネルにある同名の機能と同じく、コードにconsole.logを書き足さず、ブレークポイントのように実行を止めることもありません(ログポイントを加えたプルリクエスト)。

set_logpointsには、「ファイル:行番号 式」の形の文字列を配列で渡します。テスト用のページはsrc/app.tsをtsc --sourceMapでdist/app.jsにビルドし、ソースマップ(生成後のJavaScriptの行と元のTypeScriptの行を対応づけるファイル)も作っています。元のTypeScriptの21行目(在庫の合計に足す行)を指定しました。

set_logpoints {
  "pageId": 2,
  "logpoints": [
    "src/app.ts:21 'item:', item.name, item.price * item.stock, 'total before:', total"
  ]
}

1 logpoint(s) set on the page:
- http://127.0.0.1:8765/src/app.ts:21:7 logging `'item:', item.name, …` [bound via source map at http://127.0.0.1:8765/dist/app.js:15:13]

応答の最後のbound via source mapは、ソースマップを使って、生成されたJavaScriptの15行目に置いたという意味です。ページを再読み込みしてからlist_console_messagesを呼ぶと、ループが回るたびの値が出ました。

msgid=2 [log] item: ノート 2160 total before: 0 (5 args)
msgid=3 [log] item: ボールペン 3600 total before: 2160 (5 args)
msgid=4 [log] item: 付せん 1250 total before: 5760 (5 args)

ログポイントは再読み込みしても残ります。この状態でセール価格のファイルのモックを足して再読み込みすると、同じログポイントがitem: ノート 1080 total before: 0のように、差し替えた応答で計算した値を書き出しました。モックで入力を変え、ログポイントで計算の途中を見る組み合わせで、表示がおかしいときにAPIの応答と計算のどちらに原因があるかを切り分けられます。

set_logpointsは、渡した配列でそのページのログポイントをすべて置き換えます。1つ足すときも、残したいログポイントを一緒に渡します。空の配列[]を渡すと、すべて外れます。

ログポイントで期待した値が出ないときの5つの確認点

ログポイントの式は、その行が実行される直前に評価されます。この順番、置ける行の条件、MCPサーバーの起動オプションによって、手元では期待した値が出ない場面がありました。5つ目のビルドし直した直後の注意は、set_logpointsの応答に書かれているものです。

1. 宣言と同じ行に置いた

変数は宣言の次の行で記録する

const li = …の行でliを記録すると、1回目は本文のない[error]の行になり、2回目と3回目は1つ前の周回のliが出ました。次の行に置くと、3回ともその周回のliが出ました。

2. 式がエラーになった

本文のない[error]の行は、式がエラーになったときに出る

実行時に例外になる式(例: item.missing.field)を書くと、本文のない[error]の行だけが出ました。get_console_messageで見えるのはスタック(どの行か)だけです。

3. 実行されない行を指定した

生成後のJavaScriptに対応のない行(型だけの行など)には置けない

型だけの行を指定すると「No executable code at …」のエラーになり、同時に渡したほかのログポイントだけが設定されました。

4. MCPサーバーを--no-source-mapsで起動している

生成後のJavaScriptの行で指定する

src/app.tsは「No parsed script or original source file matches」になり、dist/app.js:15なら値が出ました。

5. ビルドし直した直後に読み込んだ

もう一度再読み込みしてから確かめる

ビルドし直した直後の最初の読み込みでは、読み込み中に動くコードが記録されないことがあると、set_logpointsの応答に書かれています。

set_logpointsの応答にあるとおり、オブジェクトはlist_console_messagesでは[object Object]と表示され、get_console_messageではJSONで見えます。一覧のまま中身を読みたいときは、JSON.stringify({count: items.length, total})のように文字列にすると、status: {"count":2,"total":2880}と出ました。

同じ行に2つのログポイントを渡すと、1つにまとまり、後に書いた式だけが残りました。1つの行で複数の値を見たいときは、1つの式にカンマで並べます。

使い終わったらモックを外し、性能の計測とは分ける

mock_networkの応答には、モックがある間はページのHTTPキャッシュを使わず、すべての要求を一度止めて調べるという注意が毎回付きます(JSONファイルの節で示したmock_networkの応答の2行目)。読み込み時間やLighthouseの点数を測るときは、remove_network_mockでモックを外してから測ります。最後のモックを外すと、キャッシュは元に戻ります(モックを加えたプルリクエスト)。

AIエージェントに画面の確認を任せる前に、次の5つを設定とAIエージェントへの指示に入れておくと、この記事で確かめた手順をそのまま再現できます。

任せる前に決める5つのこと

  1. MCPクライアントの設定に--categoryNetworkMocksを足して、起動し直す
  2. 応答のファイルを置くフォルダーを決めて、--workspaceで渡す
  3. 差し替えるAPIを絶対URLで伝える(fetch()の要求は種類をfetchで指定するか、種類を指定しない)。upstreamで差し替えるときは、upstreamのURLにクエリまで書き、クエリごとに応答を変えるときはrouteにも同じクエリを書く
  4. 別のオリジンにある、ログインが要るAPIやPOSTは、upstreamではなくファイルのモックで差し替える
  5. 確かめ終わったらremove_network_mockとset_logpointsの[]で外し、性能を測るのはそのあとにする

参考資料

検証環境

  • macOS 27.0.1(Apple Silicon)、Google Chrome 157.0.8103.52(ヘッドレスモード)
  • Chrome DevTools MCP 1.12.0・1.13.0、Node.js 24.12.0、TypeScript 5.9.3
  • 起動オプション: --headless --isolated --no-usage-statistics --no-performance-crux(ツールの数もこの条件で数えた)
  • 検証日: 2026年11月15日

この記事は、AIが調査と下書きを担当し、上記の環境で実際に動かして結果を確かめ、下書きとは別の担当が公開前に本文と出典を確認しています。制作と訂正の方針は編集・訂正方針で公開しています。