real-browser — MCP-сервер для Claude Code: как установить
Локальный MCP-сервер и расширение Chrome: агент отдаёт команды, а выполняет их ваша уже открытая вкладка с куками и пройденным SSO.
claude mcp add real-browser -- npx -y real-browser-mcpЧто делает real-browser
real-browser соединяет две части: сервер на вашей машине и расширение для Chrome. Агент шлёт вызовы по MCP, а работу делает настоящая вкладка — та самая, где вы залогинены на стенде и где уже воспроизвёлся баг.
Связь идёт через WebSocket на localhost. Сервер запускается командой npx -y real-browser-mcp внутри вашего клиента, расширение ставится из Chrome Web Store или грузится распакованным из папки extension/ на странице chrome://extensions. Зелёная точка на иконке в тулбаре — канал открыт, серая — сервер ещё не поднялся.
Для параллельных прогонов в CI с чистым профилем это не годится, там остаётся Playwright. Подключиться к дефолтному профилю через CDP на Chrome 136+ не выйдет, порт отладки на нём закрыт, поэтому мост и построен на MV3-расширении. Без подключённого расширения сервер не сделает ничего.
Какие задачи решает
- проверить фикс на странице стенда, где вы уже залогинены
- пройти форму за SSO, не входя заново
- снять консоль и DOM вкладки, которую агент должен починить
- прогнать сценарий в своём профиле Chrome вместо чистого Chromium
- отдать агенту открытую вкладку с воспроизведённым багом
Примеры запросов агенту
- Открой вкладку со стендом и проверь, что форма отправляется без ошибок.
- Сними консоль на странице, где у меня воспроизвёлся баг.
- Пройди по ссылке в уже открытой вкладке Chrome и покажи, что видно после логина.
Как установить real-browser
Командой платформы
claude mcp add real-browser -- npx -y real-browser-mcpКомандой платформы
codex mcp add real-browser -- npx -y real-browser-mcpФайл настроек
{
"mcpServers": {
"real-browser": {
"command": "npx",
"args": [
"-y",
"real-browser-mcp"
]
}
}
}Файл настроек
{
"servers": {
"real-browser": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"real-browser-mcp"
]
}
}
}Командой платформы
gemini mcp add real-browser npx -y real-browser-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о real-browser
Как установить real-browser в Claude Code?
Одной командой: claude mcp add real-browser -- npx -y real-browser-mcp. Дальше подключите расширение Chrome — без него сервер не заработает.
Что делает real-browser?
Даёт агенту доступ к вашему открытому Chrome: он видит текущие вкладки и действует в них с вашей сессией и куками, а не в отдельном браузере с чистым профилем.
Чем real-browser отличается от Playwright MCP?
Playwright поднимает новый браузер, поэтому SSO и открытые вкладки туда не попадают. Здесь агент работает в вашем Chrome, зато параллельные чистые прогоны в CI на нём не построить.
