MCP-сервер, который даёт ассистентам ИИ возможность управлять веб-браузером.

---

Содержание

• Что это?
• Установка
• Веб-интерфейс
• Веб-панель управления
• Конфигурация
• Справочник CLI
• Инструменты MCP
• Глубокие исследования
• Наблюдаемость
• Система навыков
• Ссылка REST API
• Архитектура
• Лицензия

---

Что это?

Это объединяет использование браузера как MCP-сервер, позволяя Claude (или любому MCP-клиенту) автоматизировать реальный браузер — перемещать страницы, заполнять формы, нажимать кнопки, извлекать данные и многое другое.

Почему HTTP вместо stdio?

Задачи автоматизации браузера занимают 30-120+ секунд. Стандартный MCP stdio transport имеет проблемы с тайм-аутом при длительной работе — соединения обрываются во время задачи. HTTP-транспорт решает эту проблему, работая как постоянный демон, который надёжно обрабатывает запросы независимо от длительности.

---

Установка

Плагин Claude Code (Рекомендуем)

Установите плагин Claude Code для автоматической настройки:

Плагин автоматически:

• Устанавливает браузеры Playwright при первом запуске
• Запускает HTTP-демон при старте Claude Code
• Регистрирует MCP-сервер с Claude

Установите ключ API (агенту браузера нужна LLM для определения действий):

Вот и всё! Клод теперь может пользоваться инструментами автоматизации браузера.

mcp-server-browser-use

MCP server that gives AI assistants the power to control a web browser.

---

Table of Contents

• What is this?
• Installation
• Web UI
• Web Dashboard
• Configuration
• CLI Reference
• MCP Tools
• Deep Research
• Observability
• Skills System
• REST API Reference
• Architecture
• License

---

What is this?

This wraps browser-use as an MCP server, letting Claude (or any MCP client) automate a real browser—navigate pages, fill forms, click buttons, extract data, and more.

Why HTTP instead of stdio?

Browser automation tasks take 30-120+ seconds. The standard MCP stdio transport has timeout issues with long-running operations—connections drop mid-task. HTTP transport solves this by running as a persistent daemon that handles requests reliably regardless of duration.

---

Installation

Claude Code Plugin (Recommended)

Install as a Claude Code plugin for automatic setup:

# Install the plugin
/plugin install browser-use/mcp-browser-use

The plugin automatically:

• Installs Playwright browsers on first run
• Starts the HTTP daemon when Claude Code starts
• Registers the MCP server with Claude

Set your API key (the browser agent needs an LLM to decide actions):

# Set API key (environment variable - recommended)
export GEMINI_API_KEY=your-key-here

# Or use config file
mcp-server-browser-use config set -k llm.api_key -v your-key-here

That’s it! Claude can now use browser automation tools.

Manual Installation

For other MCP clients or standalone use:

# Clone and install
git clone https://github.com/Saik0s/mcp-browser-use.git
cd mcp-server-browser-use
uv sync

# Install browser
uv run playwright install chromium

# Start the server
uv run mcp-server-browser-use server

Add to Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "browser-use": {
      "type": "streamable-http",
      "url": "http://localhost:8383/mcp"
    }
  }
}

For MCP clients that don’t support HTTP transport, use mcp-remote as a proxy:

{
  "mcpServers": {
    "browser-use": {
      "command": "npx",
      "args": ["mcp-remote", "http://localhost:8383/mcp"]
    }
  }
}

---

Web UI

Access the task viewer at http://localhost:8383 when the daemon is running.

Features:

• Real-time task list with status and progress
• Task details with execution logs
• Server health status and uptime
• Running tasks monitoring

The web UI provides visibility into browser automation tasks without requiring CLI commands.

---

Web Dashboard