zen-mcp — MCP-сервер для Claude Code: что делает и как установить
Управляет браузером Zen через протокол WebDriver BiDi по WebSocket. Пригодится для чтения веб-страниц, кликов по кнопкам и автозаполнения форм прямо из чата с агентом.
claude mcp add --env ZEN_DEBUG_PORT=<ZEN_DEBUG_PORT> --transport stdio zen-mcp -- npx -y zen-mcpЧто делает zen-mcp
Сервер связывает ИИ-ассистента с Zen Browser напрямую через WebSocket. Вместо тяжёлых прослоек вроде Selenium или Playwright здесь используется стандарт WebDriver BiDi. Инструмент умеет открывать вкладки, снимать скриншоты, считывать текстовое содержимое и выполнять произвольный JavaScript. Заполнение полей эмулирует события input и change, поэтому формы на React или Vue реагируют без сбоев.
В набор входит 20 инструментов для навигации и проверки элементов DOM. Повторные попытки соединения срабатывают автоматически. Без запущенного Zen с параметром --remote-debugging-port 9222 сервер работать не сможет.
Для окружения требуется Node.js версии не ниже 20. Из-за особенностей текущей реализации BiDi в ядре Firefox тут нет перетаскивания элементов и загрузки локальных файлов. Если предыдущая сессия зависла, придётся перезапустить сам браузер через команду killall zen && zen.
Какие задачи решает
- передавать агенту снимки экрана и текст страниц из Zen Browser
- заполнять поля ввода и отправлять веб-формы без Selenium и Playwright
- переключать вкладки и переходить по ссылкам внутри активной сессии браузера
- запускать скрипты JavaScript на открытой странице
Примеры запросов агенту
- Открой новую вкладку в Zen Browser и покажи список интерактивных элементов на странице
- Сделай скриншот активной вкладки и извлеки из неё весь видимый текст
- Заполни форму авторизации на текущей странице и нажми кнопку подтверждения
Как установить zen-mcp
Командой платформы
claude mcp add --env ZEN_DEBUG_PORT=<ZEN_DEBUG_PORT> --transport stdio zen-mcp -- npx -y zen-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add zen-mcp --env ZEN_DEBUG_PORT=<ZEN_DEBUG_PORT> -- npx -y zen-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"zen-mcp": {
"command": "npx",
"args": [
"-y",
"zen-mcp"
],
"env": {
"ZEN_DEBUG_PORT": "<ZEN_DEBUG_PORT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"zen-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"zen-mcp"
],
"env": {
"ZEN_DEBUG_PORT": "<ZEN_DEBUG_PORT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ZEN_DEBUG_PORT=<ZEN_DEBUG_PORT> zen-mcp npx -y zen-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о zen-mcp
Как установить zen-mcp в Claude Code?
Выполните команду claude mcp add zen-mcp -- npx -y zen-mcp. Перед запуском сессии откройте Zen с флагом --remote-debugging-port 9222, чтобы сервер смог подключиться через WebSocket.
Что делает zen-mcp?
Сервер даёт агенту 20 инструментов для взаимодействия с Zen Browser по протоколу WebDriver BiDi. Он позволяет открывать страницы, читать разметку, делать скриншоты, нажимать кнопки и вводить текст в формы.
Что делать при ошибке подключения к Zen Browser?
Убедитесь, что браузер запущен с флагом --remote-debugging-port 9222. При зависшей сессии перезапустите браузер командой killall zen && zen, либо вызовите инструмент zen_reconnect.
