# real-browser

Локальный MCP-сервер и расширение Chrome: агент отдаёт команды, а выполняет их ваша уже открытая вкладка с куками и пройденным SSO.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 57
- Автор: ofershap
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ofershap/real-browser-mcp
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/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-расширении. Без подключённого расширения сервер не сделает ничего.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add real-browser -- npx -y real-browser-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add real-browser -- npx -y real-browser-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "real-browser": {
            "command": "npx",
            "args": [
                "-y",
                "real-browser-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "real-browser": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "real-browser-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add real-browser npx -y real-browser-mcp
```

## Когда брать
- проверить фикс на странице стенда, где вы уже залогинены
- пройти форму за SSO, не входя заново
- снять консоль и DOM вкладки, которую агент должен починить
- прогнать сценарий в своём профиле Chrome вместо чистого Chromium
- отдать агенту открытую вкладку с воспроизведённым багом

## Примеры запросов агенту
- Открой вкладку со стендом и проверь, что форма отправляется без ошибок.
- Сними консоль на странице, где у меня воспроизвёлся баг.
- Пройди по ссылке в уже открытой вкладке Chrome и покажи, что видно после логина.

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md