# chrome-devtools-mcp | ChromeDevTools | Knowledge Base | Instagit

Chrome DevTools for coding agents

GitHub Stars: 25.4k

Repository: https://github.com/chromedevtools/chrome-devtools-mcp

---

## Articles

### [How DevToolsConnectionAdapter Bridges MCP and Chrome DevTools Protocols](/chromedevtools/chrome-devtools-mcp/devtools-mcp-devtoolsconnectionadapter-protocol-bridge)

Learn how DevToolsConnectionAdapter bridges MCP and Chrome DevTools protocols by wrapping Puppeteer CDP sessions for seamless front-end communication.

- Tags: internals
- Published: 2026-02-19

### [How the Target Filter Excludes Internal Chrome Pages in chrome-devtools-mcp](/chromedevtools/chrome-devtools-mcp/devtools-mcp-target-filter-exclude-internal-pages)

Learn how the target filter in chrome-devtools-mcp excludes internal Chrome pages like chrome:// for cleaner debugging. Access essential browser pages while blocking unwanted targets.

- Tags: internals
- Published: 2026-02-19

### [How the MCP Telemetry System Sends Usage Data to Google Clearcut](/chromedevtools/chrome-devtools-mcp/devtools-mcp-telemetry-google-clearcut-integration)

Learn how the MCP telemetry system sends usage data to Google Clearcut. Discover its watchdog subprocess, batching, POST requests, and retry logic for efficient logging.

- Tags: internals
- Published: 2026-02-19

### [How to Selectively Enable or Disable Tool Categories in Chrome DevTools MCP](/chromedevtools/chrome-devtools-mcp/devtools-mcp-enable-disable-tool-categories)

Learn to selectively enable or disable tool categories in Chrome DevTools MCP using CLI flags or programmatic options. Control emulation, network, and more for efficient debugging.

- Tags: how-to-guide
- Published: 2026-02-16

### [Node.js and Chrome Version Compatibility Requirements for MCP: Complete Setup Guide](/chromedevtools/chrome-devtools-mcp/devtools-mcp-nodejs-chrome-version-compatibility)

Ensure Node.js v20.19+ and Chrome 135+ compatibility for Chrome DevTools MCP setup. Learn version requirements for automatic connection features and a smooth experience.

- Tags: setup-guide
- Published: 2026-02-16

### [Chrome DevTools MCP CLI Arguments: Complete Configuration Reference](/chromedevtools/chrome-devtools-mcp/devtools-mcp-cli-arguments-configuration-options)

Explore over 40 MCP CLI arguments to configure Chrome DevTools connection methods launch behavior tool categories experimental features and telemetry settings.

- Tags: api-reference
- Published: 2026-02-16

### [How StdioServerTransport Works in MCP: Implementation Guide for Chrome DevTools](/chromedevtools/chrome-devtools-mcp/devtools-mcp-stdioservertransport-implementation)

Explore the StdioServerTransport implementation in MCP for Chrome DevTools. Learn how it uses JSON-RPC over stdio streams for efficient communication. Get the technical details.

- Tags: implementation-guide
- Published: 2026-02-16

### [How to Configure a Proxy Server in Chrome DevTools MCP](/chromedevtools/chrome-devtools-mcp/devtools-mcp-proxy-server-configuration)

Learn to configure a proxy server in Chrome DevTools MCP easily. This guide shows how to effectively use the --proxyServer flag for seamless integration with Chromium.

- Tags: how-to-guide
- Published: 2026-02-16

### [How to Troubleshoot MCP Connection Issues in Chrome DevTools MCP](/chromedevtools/chrome-devtools-mcp/devtools-mcp-troubleshooting-connection-issues)

Resolve Chrome DevTools MCP connection issues by troubleshooting invalid CLI arguments, remote debugging errors, and sandbox restrictions. Verify URLs and adjust launch flags for a stable connection.

- Tags: how-to-guide
- Published: 2026-02-16

### [How Experimental Features Are Managed in the Chrome DevTools MCP Tool Registration System](/chromedevtools/chrome-devtools-mcp/devtools-mcp-experimental-features-tool-registration)

Learn how Chrome DevTools MCP manages experimental features using CLI flags and tool annotations for controlled registration and access. Optimize your DevTools experience today.

- Tags: internals
- Published: 2026-02-16

### [Error Handling Strategy for MCP Tool Execution in Chrome DevTools MCP](/chromedevtools/chrome-devtools-mcp/devtools-mcp-tool-execution-error-handling)

Learn the error handling strategy for MCP tool execution in Chrome DevTools MCP. Discover how unhandled exceptions are captured logged and returned to the client.

- Tags: how-to-guide
- Published: 2026-02-16

### [How to Enable Verbose Logging in Chrome DevTools MCP: A Complete Guide](/chromedevtools/chrome-devtools-mcp/devtools-mcp-enable-verbose-logging)

Learn how to enable verbose logging in Chrome DevTools MCP. Set the DEBUG environment variable to mcp:* or * and use flags for detailed output. Troubleshoot with ease.

- Tags: how-to-guide
- Published: 2026-02-16

### [How PageCollector Manages Multiple Browser Pages and Selection in Puppeteer](/chromedevtools/chrome-devtools-mcp/devtools-mcp-pagecollector-multiple-pages-management)

Discover how PageCollector simplifies managing multiple browser pages and selections in Puppeteer. Learn about its WeakMap storage, event tracking, and explicit page selection APIs.

- Tags: how-to-guide
- Published: 2026-02-16

### [How WaitForHelper Ensures Reliable Waiting for Browser State Changes in Chrome DevTools MCP](/chromedevtools/chrome-devtools-mcp/devtools-mcp-waitforhelper-browser-state-changes)

Discover how WaitForHelper ensures reliable waiting for browser state changes in Chrome DevTools MCP by coordinating DOM stability, navigation events, and abort handling to prevent flaky timeouts.

- Tags: internals
- Published: 2026-02-16

### [How Isolated Mode Manages Temporary User Data Directories in Chrome DevTools MCP](/chromedevtools/chrome-devtools-mcp/devtools-mcp-isolated-mode-temporary-user-data-directory)

Learn how Chrome DevTools MCP's isolated mode manages temporary user data directories via a disposable profile. Ensure clean, concurrent sessions by preventing profile conflicts.

- Tags: internals
- Published: 2026-02-16

### [How MCP Formatters Like NetworkFormatter Transform DevTools Data](/chromedevtools/chrome-devtools-mcp/devtools-mcp-formatters-data-transformation)

Discover how MCP formatters like NetworkFormatter transform raw DevTools data into human-readable strings markdown reports and JSON using lazy loading binary detection and configurable output.

- Tags: internals
- Published: 2026-02-16

### [Retry Logic for Chrome Connection Failures in MCP: A Deep Dive into chrome-devtools-mcp](/chromedevtools/chrome-devtools-mcp/devtools-mcp-chrome-connection-failure-retry-logic)

Understand Chrome connection failures in ChromeDevTools MCP. Learn why automatic retry logic is missing and how clients must handle reconnections manually for robust development.

- Tags: deep-dive
- Published: 2026-02-16

### [How MCP's Performance Trace Analysis Uses the Google CrUX API: A Deep Dive into Chrome DevTools MCP](/chromedevtools/chrome-devtools-mcp/devtools-mcp-performance-trace-crux-api-integration)

Discover how MCP's performance trace analysis integrates Google CrUX API data into Chrome DevTools for real-user insights and enhanced web performance evaluation.

- Tags: deep-dive
- Published: 2026-02-16

### [WebSocket Connection Flow for MCP to Chrome with Custom Headers: A Complete Technical Guide](/chromedevtools/chrome-devtools-mcp/devtools-mcp-websocket-connection-flow-custom-headers)

Understand the WebSocket connection flow for MCP to Chrome with custom headers. Learn how custom headers are routed and injected into the handshake.

- Tags: how-to-guide
- Published: 2026-02-16

### [Security Implications of Enabling the Remote Debugging Port for Chrome DevTools MCP](/chromedevtools/chrome-devtools-mcp/devtools-mcp-remote-debugging-port-security)

Understand the security risks of enabling the remote debugging port for Chrome DevTools MCP. Learn how it bypasses same-origin protections and exposes sensitive browser data.

- Tags: security
- Published: 2026-02-16

### [How MCP Selects Chrome Channels (Stable, Beta, Dev, Canary)](/chromedevtools/chrome-devtools-mcp/devtools-mcp-chrome-channel-selection)

Discover how MCP selects Chrome channels like Stable, Beta, Dev, and Canary. Learn about the --channel CLI flag and its role in Puppeteer-compatible Chrome release identifiers.

- Tags: internals
- Published: 2026-02-16

### [How autoConnect Works with Chrome 144+ for Multi-Session Testing in chrome-devtools-mcp](/chromedevtools/chrome-devtools-mcp/devtools-mcp-autoconnect-chrome-144-multisession-testing)

Discover how autoConnect in chrome-devtools-mcp facilitates multi-session testing with Chrome 144+ by attaching to existing instances via remote debugging. Boost your parallel testing efficiency.

- Tags: deep-dive
- Published: 2026-02-16

### [McpContext Architecture and Browser Session Management in Chrome DevTools MCP](/chromedevtools/chrome-devtools-mcp/mcpcontext-architecture-browser-session-management)

Explore McpContext architecture and browser session management in Chrome DevTools MCP. Learn how it efficiently handles page state and DevTools integration.

- Tags: architecture
- Published: 2026-02-16

### [How Chrome DevTools MCP Handles Concurrent Tool Calls Using Mutex](/chromedevtools/chrome-devtools-mcp/chrome-devtools-mcp-concurrent-tool-calls-mutex)

Learn how Chrome DevTools MCP uses a global FIFO mutex to serialize concurrent tool calls, preventing race conditions and ensuring safe access to shared browser state.

- Tags: internals
- Published: 2026-02-16

### [Chrome DevTools MCP Performance Trace Analysis Pipeline: From Start to Insight](/chromedevtools/chrome-devtools-mcp/chrome-devtools-mcp-performance-trace-analysis-pipeline)

Explore the chrome-devtools-mcp performance trace analysis pipeline. Learn how to capture, process, and analyze browser telemetry for actionable insights and LLM-ready reports.

- Tags: performance
- Published: 2026-02-16

### [Chrome DevTools MCP Experimental Flags: How They Unlock Advanced Browser Automation](/chromedevtools/chrome-devtools-mcp/chrome-devtools-mcp-experimental-flags-functionality)

Unlock advanced browser automation with Chrome DevTools MCP experimental flags. Explore computer vision, debugging, and extension management features for powerful DevTools capabilities.

- Tags: deep-dive
- Published: 2026-02-16

### [How the ClearcutLogger Telemetry System Works in chrome-devtools-mcp and What Data It Collects](/chromedevtools/chrome-devtools-mcp/chrome-devtools-mcp-clearcutlogger-telemetry-data-collection)

Learn how the ClearcutLogger telemetry system in chrome-devtools-mcp works. Discover the data collected across its API, IPC, and HTTP layers for tool usage and active metrics.

- Tags: internals
- Published: 2026-02-16

### [How chrome-devtools-mcp Handles Concurrent Tool Requests: The Mutex Implementation in src/Mutex.ts](/chromedevtools/chrome-devtools-mcp/chrome-devtools-mcp-concurrent-requests-mutex-implementation)

Learn how Chrome DevTools MCP serializes concurrent tool requests with its FIFO async Mutex in src/Mutex.ts, ensuring fair and deterministic ordering for DevTools state manipulation.

- Tags: internals
- Published: 2026-02-16