Дайте вашему агенту по программированию AI глаза на браузере. BrowserTools MCP транслирует консоль выход, сетевая активность, скриншоты и аудиты Lighthouse от вашего настоящего Chrome session — той, что уже вошёл в ваше приложение — для любого MCP-совместимого клиент: Cursor, Claude Code, Windsurf, Cline, Zed, Gemini CLI и другие.

Версия 2.0 — это перезапись. Один процесс вместо трёх, нет неаутентифицированных локальный сервер, учетные данные, очищенные перед выходом из браузера, и настоящий тестового набора. Если вы переходите из 1.x, читайте MIGRATION.md — и обновить, потому что в версии 1.2.x есть критическая уязвимость. См. SECURITY.md.

---

Почему именно это, а не сервер на основе CDP

Инструменты вроде Chrome DevTools MCP и Playwright MCP обеспечивают свежую, автоматизированную модель Браузер. Это правильный выбор для написания тестов. Это неправильный выбор для отладка приложения, которое вы действительно рассматриваете, потому что с Chrome 136 Браузер отказывается от удалённой отладки на вашем профиле по умолчанию — в том профиле, который хранит ваш Входы. В итоге вы заново создаёте состояние аутентификации в временном профиле Отладить можно что угодно.

BrowserTools подключается к сессии, в которой вы уже находитесь, через DevTools расширение.

BrowserTools MCP

If you are still on 1.x, upgrade. 1.x is unsupported. It has known critical vulnerabilities (remote code execution, unauthenticated access to captured data) that were fixed in 2.0 and will not be patched on 1.x. See SECURITY.md and MIGRATION.md.

Give your AI coding agent eyes on the browser. BrowserTools MCP streams console output, network activity, screenshots and Lighthouse audits from your real Chrome session — the one already logged into your app — to any MCP-compatible client: Cursor, Claude Code, Windsurf, Cline, Zed, Gemini CLI, and others.

Version 2.0 is a rewrite. One process instead of three, no unauthenticated local server, credentials scrubbed before they leave the browser, and a real test suite. Coming from 1.x? Read MIGRATION.md.

---

Why this instead of a CDP-based server

Tools like Chrome DevTools MCP and Playwright MCP drive a fresh, automated browser. That is the right choice for writing tests. It is the wrong choice for debugging the app you are actually looking at, because since Chrome 136 the browser refuses remote debugging on your default profile — the one holding your logins. So you end up recreating your auth state in a throwaway profile before you can debug anything.

BrowserTools attaches to the session you are already in, through a DevTools extension. You stay logged in, on the page you were already on, and your agent reads what you see. It also reports Lighthouse-grade performance, accessibility and SEO data, which the automation-first servers do not.

Install

Two pieces: an MCP server (one command) and a Chrome extension.

1. Point your MCP client at the server

{
  "mcpServers": {
    "browser-tools": {
      "command": "npx",
      "args": ["-y", "@agentdeskai/browser-tools-mcp@latest"]
    }
  }
}

On Windows, if your client cannot find npx, use "command": "cmd" with "args": ["/c", "npx", "-y", "@agentdeskai/browser-tools-mcp@latest"].

Requires Node 22.19 or newer. Check with node --version; if you use nvm or asdf, make sure your editor inherits the same version.

2. Load the Chrome extension

1. Download or clone this repository.
2. Open chrome://extensions and turn on Developer mode.
3. Choose Load unpacked and select the chrome-extension directory.

That is the whole setup. There is no second server to start — the MCP server runs the connector itself.

3. Use it

Open Chrome DevTools (F12) on the page you want to inspect. Capture begins as soon as DevTools is open; the BrowserTools panel is only for settings and status. Then ask your agent something like “check the console for errors” or “run an accessibility audit on this page”.

Not working? Run npx @agentdeskai/browser-tools-mcp --doctor, which reports exactly which piece is missing.

To watch capture happen live — useful when checking a fresh install — start the connector with --verbose: