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.
設定しただけでは、開いている画面は変わりません。応答に書かれているとおり、ページを再読み込みすると差し替えた応答で表示されます。
take_screenshotで撮影。空の一覧の表示に切り替わりました。macOS 27.0.1、Chrome 157、Chrome DevTools MCP 1.13.0。2026年11月15日に確認。モックが効いている間、テスト用のサーバーのログに/api/itemsへの要求は記録されませんでした。Chromeの中で応答が差し替わるので、サーバーのデータを空にしたり、エラーを返すようにコードを変えたりする必要はありません。
差し替えの規則は、次の4つを確かめました。
モックの差し替えで確かめた規則
- ファイルは要求のたびに読み直す。ファイルの中身をセール価格の2件に書き換えて再読み込みすると、MCPサーバーを起動し直さずに「2件・在庫の合計 2,880円」に変わりました。
- routeにクエリを書かなければ、どのクエリにも当たる。ページの要求は
?lang=ja付きでしたが、クエリなしのrouteで差し替わりました。 - モックは設定したページだけに効き、移動しても残る。
new_pageで開いた別のページでは本物の3件が表示されました。設定したページで別のURLへ移動して戻ると、まだ空の一覧でした。 - 同じ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に渡した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つのこと
- MCPクライアントの設定に
--categoryNetworkMocksを足して、起動し直す - 応答のファイルを置くフォルダーを決めて、
--workspaceで渡す - 差し替えるAPIを絶対URLで伝える(
fetch()の要求は種類をfetchで指定するか、種類を指定しない)。upstreamで差し替えるときは、upstreamのURLにクエリまで書き、クエリごとに応答を変えるときはrouteにも同じクエリを書く - 別のオリジンにある、ログインが要るAPIや
POSTは、upstreamではなくファイルのモックで差し替える - 確かめ終わったら
remove_network_mockとset_logpointsの[]で外し、性能を測るのはそのあとにする
参考資料
- Chrome DevTools MCP 1.13.0のリリースノート(GitHub、2026年11月11日)
- Chrome DevTools MCPのツールリファレンス(1.13.0)
- feat: add page-scoped network mocks(#3384)、feat: support upstream network mock responses(#3420)
- feat: add logpoints built on the DevTools BreakpointManager(#3211)
- Chrome DevTools MCPのREADME(MCPクライアントの設定例)
- Chrome DevTools MCPの設定のドキュメント(1.13.0)、Client Configurations Guide
検証環境
- 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が調査と下書きを担当し、上記の環境で実際に動かして結果を確かめ、下書きとは別の担当が公開前に本文と出典を確認しています。制作と訂正の方針は編集・訂正方針で公開しています。












