# agent-browser

MCP-сервер подключает ИИ-агента к отдельной сессии Chrome, которую можно наблюдать и перехватывать вручную.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Автор: AetherAI3
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/AetherAI3/agent-browser
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/mcp/agent-browser

## Что делает

agent-browser запускает одну управляемую сессию Chrome и отдаёт её агенту через MCP. Сервер предоставляет инструменты для открытия, навигации, чтения страницы, кликов, ввода текста, прокрутки и закрытия сессии. Человек видит ту же вкладку через noVNC и может продолжить действие сам, например на шаге с 2FA.

Для локального запуска используется Docker Compose: стек поднимает Chrome, виртуальный дисплей, noVNC и API. Подключение через Claude Code настраивается командой с токенами контроллера и наблюдателя; для удалённого адреса используется `AGENT_BROWSER_URL`. Для quickstart нужен Docker Engine for Linux с Compose v2, а Docker Desktop и удалённый хост в этот сценарий не входят.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `AGENT_BROWSER_URL`, `AGENT_BROWSER_CONTROLLER_TOKEN`, `AGENT_BROWSER_OBSERVER_TOKEN` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env AGENT_BROWSER_URL=<AGENT_BROWSER_URL> --env AGENT_BROWSER_CONTROLLER_TOKEN=<AGENT_BROWSER_CONTROLLER_TOKEN> --env AGENT_BROWSER_OBSERVER_TOKEN=<AGENT_BROWSER_OBSERVER_TOKEN> --transport stdio agent-browser -- npx -y aether-browser
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add agent-browser --env AGENT_BROWSER_URL=<AGENT_BROWSER_URL> --env AGENT_BROWSER_CONTROLLER_TOKEN=<AGENT_BROWSER_CONTROLLER_TOKEN> --env AGENT_BROWSER_OBSERVER_TOKEN=<AGENT_BROWSER_OBSERVER_TOKEN> -- npx -y aether-browser
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent-browser": {
            "command": "npx",
            "args": [
                "-y",
                "aether-browser"
            ],
            "env": {
                "AGENT_BROWSER_URL": "<AGENT_BROWSER_URL>",
                "AGENT_BROWSER_CONTROLLER_TOKEN": "<AGENT_BROWSER_CONTROLLER_TOKEN>",
                "AGENT_BROWSER_OBSERVER_TOKEN": "<AGENT_BROWSER_OBSERVER_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent-browser": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "aether-browser"
            ],
            "env": {
                "AGENT_BROWSER_URL": "<AGENT_BROWSER_URL>",
                "AGENT_BROWSER_CONTROLLER_TOKEN": "<AGENT_BROWSER_CONTROLLER_TOKEN>",
                "AGENT_BROWSER_OBSERVER_TOKEN": "<AGENT_BROWSER_OBSERVER_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e AGENT_BROWSER_URL=<AGENT_BROWSER_URL> -e AGENT_BROWSER_CONTROLLER_TOKEN=<AGENT_BROWSER_CONTROLLER_TOKEN> -e AGENT_BROWSER_OBSERVER_TOKEN=<AGENT_BROWSER_OBSERVER_TOKEN> agent-browser npx -y aether-browser
```
Вместо <…> подставьте свои значения

## Когда брать
- запустить отдельную сессию Chrome для агента
- наблюдать действия агента через noVNC
- перехватить управление на экране 2FA
- читать страницу через MCP-инструменты
- закрыть браузерную сессию после работы

## Примеры запросов агенту
- Открой страницу и покажи её содержимое через agent-browser.
- Перейди на нужный URL, дождись загрузки и сообщи заголовок страницы.
- Остановись на запросе 2FA и попроси меня ввести код в окне браузера.

## Похожие
- [browser-screenshot](https://affpapa.org/nevibecode/skills/browser-screenshot.md) — скилл · 4100 установок
- [dev-browser](https://affpapa.org/nevibecode/skills/dev-browser.md) — скилл · 2500 установок
- [Oya Browser](https://affpapa.org/nevibecode/mcp/oya-browser.md) — MCP-сервер · ★ 352
- [opencli-browser](https://affpapa.org/nevibecode/skills/opencli-browser.md) — скилл · 20200 установок
- [browser](https://affpapa.org/nevibecode/skills/browser.md) — скилл · 5900 установок
- [browser-harness](https://affpapa.org/nevibecode/plugins/browser-harness.md) — плагин · ★ 18639

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