agent-browser — MCP-сервер для Claude Code: установка
MCP-сервер подключает ИИ-агента к отдельной сессии Chrome, которую можно наблюдать и перехватывать вручную.
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Что делает 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 и удалённый хост в этот сценарий не входят.
Какие задачи решает
- запустить отдельную сессию Chrome для агента
- наблюдать действия агента через noVNC
- перехватить управление на экране 2FA
- читать страницу через MCP-инструменты
- закрыть браузерную сессию после работы
Примеры запросов агенту
- Открой страницу и покажи её содержимое через agent-browser.
- Перейди на нужный URL, дождись загрузки и сообщи заголовок страницы.
- Остановись на запросе 2FA и попроси меня ввести код в окне браузера.
Как установить agent-browser
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о agent-browser
Как установить agent-browser в Claude Code?
Выполните `claude mcp add agent-browser -e AGENT_BROWSER_CONTROLLER_TOKEN=<AGENT_BROWSER_CONTROLLER_TOKEN> -e AGENT_BROWSER_OBSERVER_TOKEN=<AGENT_BROWSER_OBSERVER_TOKEN> -- npx -y aether-browser`.
Что делает agent-browser?
Он даёт агенту MCP-инструменты для управления одной сессией Chrome, а человеку — её живой просмотр и возможность перехватить управление.
Можно ли вмешаться в работу агента на шаге 2FA?
Да. Сервер рассчитан на остановку перед входом, оплатой или 2FA, после чего человек вводит данные в отображаемой сессии.
