New article "Let agents inspect w/ Chrome DevTools MCP" by mikehoffms · Pull Request #3811 · MicrosoftDocs/edge-developer

mikehoffms · 2026-05-28T00:09:28Z

Rendered article for review:

Let agents inspect your site and WebView2 app with Chrome DevTools MCP
- /web-platform/devtools-mcp-server.md
- Internal preview: https://review.learn.microsoft.com/microsoft-edge/web-platform/devtools-mcp-server?branch=pr-en-us-3811
- External preview:
- Planned live: https://learn.microsoft.com/microsoft-edge/web-platform/devtools-mcp-server.md
- New article.
AI for the web
- /web-platform/index.md
- Internal preview: https://review.learn.microsoft.com/microsoft-edge/web-platform/index?branch=pr-en-us-3811
- External preview:
- Planned live: https://review.learn.microsoft.com/microsoft-edge/web-platform/
- New page.
  - Firstchild nav/landing.
  - Fallback for truncated URL.
  - Defines the contained TOC buckets.
toc.yml
- Added article Let agents inspect your site and WebView2 app with Chrome DevTools MCP.
- Added article AI for the web.

AB#62447540

captainbrosset · 2026-06-04T08:38:56Z

+In this mode, you start Edge yourself (or it's already running), and the MCP server connects to it.  This is useful when:
+
+* You want to maintain browser state between manual testing and agent-driven testing.
+* You need to be signed into a website that blocks automated browser launches.


I don't understand what we mean by a website that blocks automated browser launches. How can a website blocks this?

What's meant by "a website that blocks automated browser launches". How can a website block automated browser launches?

https://review.learn.microsoft.com/en-us/microsoft-edge/web-platform/devtools-mcp-server?branch=pr-en-us-3811&tabs=windows#auto-connect-to-a-running-edge-instance

@zoherghadyali

learn-build-service-prod · 2026-06-04T23:39:06Z

Learn Build status updates of commit ec914bd:

✅ Validation status: passed

File	Status	Preview URL
microsoft-edge/toc.yml	✅Succeeded	View
microsoft-edge/web-platform/devtools-mcp-server.md	✅Succeeded	View
microsoft-edge/web-platform/index.md	✅Succeeded	View

For more details, please refer to the build report.

learn-build-service-prod · 2026-06-04T23:40:36Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-06-04T23:51:02Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

mikehoffms · 2026-06-04T23:51:07Z

+<!-- ------------------------------ -->
+#### "Could not connect to Chrome"<!-- todo: to Microsoft Edge? --> error with auto-connect
+
+If you are using auto-connect and get an error such as "Could not connect to Chrome"<!-- todo: to Microsoft Edge? -->:


"Could not connect to Chrome" - to Microsoft Edge? 2x

https://review.learn.microsoft.com/en-us/microsoft-edge/web-platform/devtools-mcp-server?branch=pr-en-us-3811&tabs=windows#could-not-connect-to-chrome-error-with-auto-connect

I suspect this string is coming from the Chrome DevTools MCP server. We're using this server to connect to Edge or WebView2, because it's inherently compatible with them, being Chromium-based, but we don't control what's in the Chrome DevTools MCP server itself. It may very well be that the server has that string "Could not connect to Chrome" hard-coded in it.

@zoherghadyali can confirm.

learn-build-service-prod · 2026-06-04T23:51:39Z

Learn Build status updates of commit 3457b47:

✅ Validation status: passed

File	Status	Preview URL
microsoft-edge/toc.yml	✅Succeeded	View
microsoft-edge/web-platform/devtools-mcp-server.md	✅Succeeded	View
microsoft-edge/web-platform/index.md	✅Succeeded	View

For more details, please refer to the build report.

captainbrosset

A few comments, and follow-up questions for Zoher, but otherwise LGTM. Approving already, I don't need to re-review once the remaining comments have been addressed.

captainbrosset · 2026-06-05T07:10:37Z

+<!-- ---------- -->
+###### By using WebView2Utilities
+
+In this approach, you use WebView2Utilities and follow the steps in [How to: Auto open DevTools](https://github.com/david-risney/WebView2Utilities/wiki/How-to:-Auto-open-DevTools).  But instead of selecting the **Auto open DevTools** checkbox, in the **Arguments** textbox, enter `--remote-debugging-port=0`.


@zoherghadyali would you be ok if we inlined the wiki instructions? This would avoid potential confusion/context switching. The wiki isn't that long.

https://review.learn.microsoft.com/en-us/microsoft-edge/web-platform/devtools-mcp-server?branch=pr-en-us-3811&tabs=windows#by-using-webview2utilities

captainbrosset · 2026-06-05T07:16:20Z

+<!-- ------------------------------ -->
+#### "Could not connect to Chrome"<!-- todo: to Microsoft Edge? --> error with auto-connect
+
+If you are using auto-connect and get an error such as "Could not connect to Chrome"<!-- todo: to Microsoft Edge? -->:


I suspect this string is coming from the Chrome DevTools MCP server. We're using this server to connect to Edge or WebView2, because it's inherently compatible with them, being Chromium-based, but we don't control what's in the Chrome DevTools MCP server itself. It may very well be that the server has that string "Could not connect to Chrome" hard-coded in it.

@zoherghadyali can confirm.

learn-build-service-prod · 2026-06-05T07:26:23Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-06-05T07:26:53Z

Learn Build status updates of commit 88a90e9:

✅ Validation status: passed

File	Status	Preview URL
microsoft-edge/toc.yml	✅Succeeded	View
microsoft-edge/web-platform/devtools-mcp-server.md	✅Succeeded	View
microsoft-edge/web-platform/index.md	✅Succeeded	View

For more details, please refer to the build report.

draft doc

28dedf8

mikehoffms added the cat: devtools DevTools-related content. label May 28, 2026

mikehoffms changed the title ~~Using Microsoft Edge and WebView2 with Chrome DevTools MCP~~ Using Edge and WebView2 with Chrome DevTools MCP May 28, 2026

MicrosoftDocs deleted a comment from learn-build-service-prod Bot May 28, 2026

mikehoffms added 3 commits May 27, 2026 17:15

localtoc

4fb04c2

test-link not in Note

8d41715

tabset termin

1f322e7

MicrosoftDocs deleted a comment from learn-build-service-prod Bot May 28, 2026

mikehoffms added 6 commits May 27, 2026 17:26

del test-link

94c129e

new toc design

1ab9822

restore toc Exper APIs

26ae8cf

Merge branch 'main' into user/mikehoffms/mcp

39e8cf1

Update index.md

a9ddfc3

Merge branch 'main' into user/mikehoffms/mcp

da7401d

mikehoffms commented Jun 2, 2026

View reviewed changes

Comment thread microsoft-edge/devtools/agents/index.md Outdated

MicrosoftDocs deleted a comment from learn-build-service-prod Bot Jun 4, 2026

captainbrosset reviewed Jun 4, 2026

View reviewed changes

mikehoffms added 2 commits June 4, 2026 12:58

inc cmts

2884011

Writer/Editor pass

0e39f2c

mikehoffms commented Jun 4, 2026

View reviewed changes

Comment thread microsoft-edge/web-platform/devtools-mcp-server.md Outdated

mikehoffms changed the title ~~Using Edge and WebView2 with Chrome DevTools MCP~~ New article "Let agents inspect your site with Chrome DevTools MCP" Jun 4, 2026

mikehoffms changed the title ~~New article "Let agents inspect your site with Chrome DevTools MCP"~~ New article "Let agents inspect your site w/ Chrome DevTools MCP" Jun 4, 2026

mikehoffms changed the title ~~New article "Let agents inspect your site w/ Chrome DevTools MCP"~~ New article "Let agents inspect site w/ Chrome DevTools MCP" Jun 4, 2026

mikehoffms changed the title ~~New article "Let agents inspect site w/ Chrome DevTools MCP"~~ New article "Let agents inspect w/ Chrome DevTools MCP" Jun 4, 2026

mikehoffms commented Jun 4, 2026

View reviewed changes

Comment thread microsoft-edge/web-platform/devtools-mcp-server.md Outdated

linkfix

ec914bd

MicrosoftDocs deleted a comment from learn-build-service-prod Bot Jun 4, 2026

`

3457b47

mikehoffms commented Jun 4, 2026

View reviewed changes

captainbrosset approved these changes Jun 5, 2026

View reviewed changes

Step 3 lead-in

88a90e9

Conversation

mikehoffms commented May 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

captainbrosset Jun 4, 2026

Choose a reason for hiding this comment

Uh oh!

mikehoffms Jun 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

learn-build-service-prod Bot commented Jun 4, 2026

✅ Validation status: passed

Uh oh!

learn-build-service-prod Bot commented Jun 4, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented Jun 4, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

mikehoffms Jun 4, 2026

Choose a reason for hiding this comment

Uh oh!

captainbrosset Jun 5, 2026

Choose a reason for hiding this comment

Uh oh!

learn-build-service-prod Bot commented Jun 4, 2026

✅ Validation status: passed

Uh oh!

captainbrosset left a comment

Choose a reason for hiding this comment

Uh oh!

captainbrosset Jun 5, 2026

Choose a reason for hiding this comment

Uh oh!

mikehoffms Jun 5, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

captainbrosset Jun 5, 2026

Choose a reason for hiding this comment

Uh oh!

learn-build-service-prod Bot commented Jun 5, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented Jun 5, 2026

✅ Validation status: passed

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

mikehoffms commented May 28, 2026 •

edited

Loading

mikehoffms Jun 4, 2026 •

edited

Loading