Puppeteer MCP: три сервера для управления Chrome из Claude и Cursor

jaenster/puppeteer-mcp-claude· Проверено 12.11.2026· 48на GitHub

Даёт агенту браузер Chrome на Puppeteer: открыть страницу, кликать и вводить текст, выполнить JavaScript, снять скриншот, забрать текст или сохранить статью в Markdown.

3 реализации:

Классический набор Puppeteer: вкладки, клики, ввод, JavaScript в странице, скриншоты прямо в ответ, cookies, перехват запросов; подключается к уже открытому Chrome.

Как подключить

Что сделать до подключения

Node.js 18 или новее

npm install -g puppeteer-mcp-claude; при установке Puppeteer скачает Chromium, около 170 МБ

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio puppeteer \
  -- npx -y puppeteer-mcp-claude serve

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.puppeteer]
command = "npx"
args = ["-y", "puppeteer-mcp-claude", "serve"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "puppeteer-mcp-claude", "serve"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "puppeteer": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "puppeteer-mcp-claude", "serve"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "puppeteer-mcp-claude", "serve"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "puppeteer-mcp-claude", "serve"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "puppeteer": {
        "type": "local",
        "command": ["npx", "-y", "puppeteer-mcp-claude", "serve"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "puppeteer-mcp-claude", "serve"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "puppeteer-mcp-claude", "serve"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

puppeteer_launchзапускает браузер или подключается к Chrome

puppeteer_new_pageоткрывает вкладку

puppeteer_navigateоткрывает адрес

puppeteer_clickкликает по селектору

puppeteer_typeвводит текст в поле

puppeteer_get_textчитает текст элемента

puppeteer_screenshotснимает скриншот

puppeteer_evaluateвыполняет JavaScript на странице

puppeteer_wait_for_selectorждёт появления элемента

puppeteer_close_pageзакрывает вкладку

puppeteer_close_browserзакрывает браузер

puppeteer_set_cookiesставит cookies

puppeteer_get_cookiesчитает cookies

puppeteer_delete_cookiesудаляет cookies

puppeteer_set_request_interceptionблокирует ресурсы и меняет заголовки

Видимый Chrome на rebrowser-puppeteer-core с настройками против детекта, прокси и отдельным профилем; запрещает клики вслепую, пока агент не прочитал страницу.

Как подключить

Что сделать до подключения

Node.js 18 или новее с npx

Google Chrome или Chromium; если сервер его не нашёл, задайте CHROME_PATH

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio puppeteer-real-browser-mcp-server \
  -- npx -y puppeteer-real-browser-mcp-server@latest

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.puppeteer-real-browser-mcp-server]
command = "npx"
args = ["-y", "puppeteer-real-browser-mcp-server@latest"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "puppeteer-real-browser-mcp-server": {
      "command": "npx",
      "args": ["-y", "puppeteer-real-browser-mcp-server@latest"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "puppeteer-real-browser-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "puppeteer-real-browser-mcp-server@latest"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "puppeteer-real-browser-mcp-server": {
      "command": "npx",
      "args": ["-y", "puppeteer-real-browser-mcp-server@latest"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "puppeteer-real-browser-mcp-server": {
      "command": "npx",
      "args": ["-y", "puppeteer-real-browser-mcp-server@latest"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "puppeteer-real-browser-mcp-server": {
        "type": "local",
        "command": ["npx", "-y", "puppeteer-real-browser-mcp-server@latest"]
      }
    }
  }
}

{
  "mcpServers": {
    "puppeteer-real-browser-mcp-server": {
      "command": "npx",
      "args": ["-y", "puppeteer-real-browser-mcp-server@latest"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "puppeteer-real-browser-mcp-server": {
      "command": "npx",
      "args": ["-y", "puppeteer-real-browser-mcp-server@latest"]
    }
  }
}

Инструменты сервера

browser_initзапускает управляемый Chrome

navigateоткрывает адрес

get_contentчитает HTML или текст страницы

find_selectorнаходит селектор по тексту

clickкликает по элементу

typeвводит текст

waitждёт элемент или загрузку

random_scrollпрокручивает страницу

solve_captchaзаглушка для капчи

save_content_as_markdownсохраняет в .md, пока заблокирован

browser_closeзакрывает браузер

Один инструмент: скачивает страницу, через модель со зрением закрывает баннеры cookies и всплывающие окна, вынимает текст Readability и отдаёт Markdown; нужен ключ OpenAI или совместимого API.

Как подключить

Что сделать до подключения

Node.js и npm

Ключ API модели со зрением; по умолчанию gpt-4.1, другой провайдер задаётся через API_BASE_URL и VISION_MODEL

OPENAI_API_KEY

ключ OpenAI или другого провайдера с OpenAI-совместимым API (Together.ai, Groq и др.)

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'OPENAI_API_KEY=<ключ OpenAI или совместимого API>' --transport stdio puppeteer-vision-mcp \
  -- npx -y puppeteer-vision-mcp-server

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.puppeteer-vision-mcp]
command = "npx"
args = ["-y", "puppeteer-vision-mcp-server"]

[mcp_servers.puppeteer-vision-mcp.env]
OPENAI_API_KEY = "<ключ OpenAI или совместимого API>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "puppeteer-vision-mcp": {
      "command": "npx",
      "args": ["-y", "puppeteer-vision-mcp-server"],
      "env": {
        "OPENAI_API_KEY": "<ключ OpenAI или совместимого API>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "puppeteer-vision-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "puppeteer-vision-mcp-server"],
      "env": {
        "OPENAI_API_KEY": "<ключ OpenAI или совместимого API>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "puppeteer-vision-mcp": {
      "command": "npx",
      "args": ["-y", "puppeteer-vision-mcp-server"],
      "env": {
        "OPENAI_API_KEY": "<ключ OpenAI или совместимого API>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "puppeteer-vision-mcp": {
      "command": "npx",
      "args": ["-y", "puppeteer-vision-mcp-server"],
      "env": {
        "OPENAI_API_KEY": "<ключ OpenAI или совместимого API>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "puppeteer-vision-mcp": {
        "type": "local",
        "command": ["npx", "-y", "puppeteer-vision-mcp-server"],
        "environment": {
          "OPENAI_API_KEY": "<ключ OpenAI или совместимого API>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "puppeteer-vision-mcp": {
      "command": "npx",
      "args": ["-y", "puppeteer-vision-mcp-server"],
      "env": {
        "OPENAI_API_KEY": "<ключ OpenAI или совместимого API>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "puppeteer-vision-mcp": {
      "command": "npx",
      "args": ["-y", "puppeteer-vision-mcp-server"],
      "env": {
        "OPENAI_API_KEY": "<ключ OpenAI или совместимого API>"
      }
    }
  }
}

Инструменты сервера

scrape-webpageскачивает страницу в Markdown

Что попросить агента

«Сделай скриншот news.ycombinator.com»puppeteer-mcp-claude вызовет puppeteer_navigate и puppeteer_screenshot с fullPage

«Дай заголовки 10 верхних новостей Hacker News списком»Агент откроет страницу через puppeteer_navigate и соберёт заголовки через puppeteer_evaluate

«На <сайт> введи «<запрос>» в поиск и отправь»Агент вызовет puppeteer_type, puppeteer_click, puppeteer_wait_for_selector и puppeteer_get_text

«Запусти браузер, открой <адрес>, прочитай текст и закрой браузер»Real Browser вызовет browser_init, navigate, get_content и browser_close

«Сохрани статью <адрес> в Markdown»Puppeteer vision вызовет scrape-webpage

Для каких задач

Снять скриншот страницы целиком и показать его агенту

Собрать заголовки статей со страницы в список Markdown

Заполнить форму поиска, отправить и прочитать результат

Подключиться к своему Chrome с выполненным входом и поработать в личном кабинете

Ускорить сбор текста, отключив загрузку картинок, шрифтов и стилей

Сохранить основной текст статьи в Markdown

Ограничения

Все три сервера сторонние, не от команды Puppeteer; у каждого меньше 50 звёзд: 48, 26 и 48

Puppeteer vision MCP Server не работает без ключа API модели со зрением, и каждый запрос к странице тратит токены; репозиторий не обновлялся с февраля 2026

У Real Browser solve_captcha пока заглушка, save_content_as_markdown заблокирован, браузер один на сессию; автор пишет, что проект ещё меняется

Сайты всё равно могут распознать автоматизацию; запускайте её только там, где это разрешено

Если не работает

Сервер Real Browser не появляется в клиенте

Проверьте, что Node.js 18 или новее, а JSON без пропущенных запятых, и полностью перезапустите клиент. Если приложение не находит npx, укажите полный путь из which npx или where npx.

Chrome не найден

Задайте CHROME_PATH с путём к исполняемому файлу Chrome. Запускать клиент от администратора или ставить через sudo ради этого не нужно.

Real Browser отклоняет клик или ввод

Соблюдайте порядок: browser_init, navigate, get_content, find_selector, потом click или type. После перехода на новую страницу снова вызовите get_content.

Подключение к браузеру отваливается по таймауту

Проверьте путь к Chrome, закройте браузер через browser_close и запустите снова, увеличьте connectOption.timeout в browser_init; проверьте, не блокирует ли Chrome антивирус.

Сервер в терминале будто завис

Это нормально: stdio-сервер ждёт сообщений от клиента. Проверяйте его через MCP Inspector.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
puppeteer-mcp-claude	jaenster	48	локально	не нужен	15	15 мая 2026
Puppeteer Real Browser MCP Server	withLinda	26	локально	не нужен	11	10 июля 2026
Puppeteer vision MCP Server	djannot	48	локально	токен	1	10 февраля 2026

Частые вопросы

Какой Puppeteer MCP выбрать?

Для обычной автоматизации — puppeteer-mcp-claude: клики, ввод, JavaScript, скриншоты, cookies. Real Browser подходит, когда нужен видимый Chrome с прокси и отдельным профилем. Puppeteer vision нужен только для сбора статей в Markdown.

Можно ли работать в уже открытом Chrome со входом в аккаунт?

Да, у puppeteer-mcp-claude: запустите puppeteer-mcp-claude chrome 9222, войдите в нужный сайт и дайте агенту puppeteer_launch с browserWSEndpoint ws://localhost:9222. Real Browser так нарочно не умеет: он отклоняет подключение к чужому браузеру и личному профилю.

Видит ли агент скриншот?

Да, puppeteer_screenshot возвращает PNG прямо в ответе как картинку и по желанию сохраняет файл на диск.

Можно ли в Puppeteer vision подключить другую модель вместо OpenAI?

Да, через API_BASE_URL на любой OpenAI-совместимый API, например Together.ai или Groq, и VISION_MODEL с моделью, которая понимает картинки.

Как подключить Puppeteer MCP к Claude Code?

Для puppeteer-mcp-claude: npm install -g puppeteer-mcp-claude, затем claude mcp add puppeteer-mcp-claude -- npx -y puppeteer-mcp-claude serve. Для Real Browser: claude mcp add --transport stdio puppeteer-real-browser -- npx -y puppeteer-real-browser-mcp-server@latest.

Что такое puppeteer-real-browser MCP?

Это сервер withLinda: изначально он был построен на puppeteer-real-browser от ZFC Digital, теперь у него свой запускатель Chrome на chrome-launcher, rebrowser-puppeteer-core и ghost-cursor. Он открывает видимый Chrome с настройками против детекта.

Работает ли сервер из России?

Серверы запускают браузер на вашем компьютере; Puppeteer vision MCP Server ещё обращается к API выбранной модели, по умолчанию к OpenAI.

Puppeteer MCP: три сервера для управления Chrome из Claude и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы