
Яндекс Браузер MCP: агент кликает и читает ваши открытые вкладки
Даёт агенту ваш открытый Яндекс Браузер с текущими вкладками и входами: прочитать страницу, кликнуть, заполнить форму, снять скриншот. Отдельный профиль и чистый браузер не нужны.
Расширение для браузера и локальный сервер на Node.js: 29 браузерных команд и 7 команд Google Таблиц, ввод идёт через CDP как настоящий.
Как подключить
Что сделать до подключения
Node.js 22 или новее с npm и настольный Яндекс Браузер
Скачать ZIP из последнего релиза и запустить install.ps1 или собрать из исходников: git clone, npm ci, npm start; окно сервера держать открытым
В браузере открыть browser://extensions, включить режим разработчика и через «Загрузить распакованное расширение» выбрать папку extension
Проверить http://127.0.0.1:37891/health: при подключённом расширении там "connected":true
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --transport http yandex-browser http://127.0.0.1:37891/mcpПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.yandex-browser]
url = "http://127.0.0.1:37891/mcp"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"yandex-browser": {
"url": "http://127.0.0.1:37891/mcp"
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"yandex-browser": {
"type": "http",
"url": "http://127.0.0.1:37891/mcp"
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"yandex-browser": {
"httpUrl": "http://127.0.0.1:37891/mcp"
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"yandex-browser": {
"httpUrl": "http://127.0.0.1:37891/mcp"
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"yandex-browser": {
"type": "remote",
"url": "http://127.0.0.1:37891/mcp"
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://127.0.0.1:37891/mcpПроверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"yandex-browser": {
"url": "http://127.0.0.1:37891/mcp"
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
browser_tabsсписок вкладок и их IDbrowser_openоткрывает страницуbrowser_activateпереключает вкладку и окноbrowser_navigateпереходит по адресу во вкладкеbrowser_snapshotтекст и элементы с селекторамиbrowser_findищет элемент по названиюbrowser_clickкликает по селектору или точкеbrowser_typeвводит текстbrowser_pressнажимает клавишу или сочетаниеbrowser_scrollпрокручивает страницуbrowser_screenshotснимает видимую областьbrowser_read_tableчитает HTML-таблицуbrowser_fill_formзаполняет поля без отправкиbrowser_upload_fileприкрепляет локальный файлbrowser_waitждёт текст или элементbrowser_diffсравнивает состояние вкладкиbrowser_evaluateвыполняет JavaScriptbrowser_cdpшлёт команду Chrome DevTools Protocolsheets_readчитает диапазоны Google Таблицsheets_writeзаписывает ячейки Google ТаблицПоказано 20 из 36.
Без расширения: подключается к браузеру, запущенному с портом отладки 9222, и читает консоль страницы.
Как подключить
Что сделать до подключения
Node.js с npm: склонировать репозиторий и выполнить npm install и npm run build
Запустить Яндекс Браузер с флагом --remote-debugging-port=9222 или через start-yandex-debug.bat
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --transport stdio yandex-browser-mcp \
-- node '<путь к папке>/yandex-browser-mcp/build/index.js'Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.yandex-browser-mcp]
command = "node"
args = ["<путь к папке>/yandex-browser-mcp/build/index.js"]Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"yandex-browser-mcp": {
"command": "node",
"args": ["<путь к папке>/yandex-browser-mcp/build/index.js"]
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"yandex-browser-mcp": {
"type": "stdio",
"command": "node",
"args": ["<путь к папке>/yandex-browser-mcp/build/index.js"]
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"yandex-browser-mcp": {
"command": "node",
"args": ["<путь к папке>/yandex-browser-mcp/build/index.js"]
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"yandex-browser-mcp": {
"command": "node",
"args": ["<путь к папке>/yandex-browser-mcp/build/index.js"]
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"yandex-browser-mcp": {
"type": "local",
"command": ["node", "<путь к папке>/yandex-browser-mcp/build/index.js"]
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"yandex-browser-mcp": {
"command": "node",
"args": ["<путь к папке>/yandex-browser-mcp/build/index.js"]
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"yandex-browser-mcp": {
"command": "node",
"args": ["<путь к папке>/yandex-browser-mcp/build/index.js"]
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
connect_to_browserподключается к открытому браузеруlist_tabsсписок открытых вкладокnavigateпереходит по адресуclickкликает по элементуtypeвводит текст в полеhoverнаводит курсорkey_pressнажимает клавишу или сочетаниеscrollпрокручивает страницуget_textизвлекает текстget_htmlполучает HTMLget_attributesчитает атрибуты элементаget_page_infoадрес, заголовок и мета-тегиget_console_logsчитает консоль браузераfill_formзаполняет формуwait_for_elementждёт появления элементаscreenshotделает скриншотevaluateвыполняет JavaScriptПоказано 17 из 18.
Что попросить агента
Для каких задач
Ограничения
Оба сервера сторонние и молодые: у Yandex Browser MCP 0 звёзд на GitHub и первые коммиты в ноябре 2026 года, у Yandex Browser Tabs MCP Server 9 звёзд и последнее обновление в сентябре 2025 года
Установка и пути в обоих проектах описаны для Windows; совместимость со всеми сайтами и версиями Яндекс Браузера не подтверждена
Агент работает в вашем профиле с вашими входами и без подтверждения каждого действия; evaluate и CDP дают полный доступ к странице, и прочитанное уходит провайдеру модели
Удалённый облачный агент не видит 127.0.0.1 вашего компьютера: подключаются только клиенты, запущенные локально
Если не работает
Ошибка Browser extension is not connected
Сервер не стартует: порт занят
Ошибка debugger на некоторых вкладках
После ошибки или timeout непонятно, выполнилось ли действие
Облачный агент не подключается к серверу
Какую реализацию выбрать
| Реализация | Кто делает | Звёзды | Запуск | Ключ | Инструменты | Обновлён |
|---|---|---|---|---|---|---|
| Yandex Browser MCP | Dizory | 0 | HTTP | не нужен | 36 | 8 ноября 2026 |
| Yandex Browser Tabs MCP Server | T1Trit | 9 | локально | не нужен | 18 | 18 сентября 2025 |