AI 비서가 웹 브라우저를 제어할 수 있는 권한을 제공하는 MCP 서버입니다.

---

목차

• 이게 뭐야?
• 설치
• 웹 UI
• 웹 대시보드
• 구성
• CLI 참고
• MCP 도구
• 심층 연구
• 관측 가능성
• 기술 시스템
• REST API 참조
• 건축
• 면허

---

이게 뭐야?

이 기능은 브라우저 사용을 MCP 서버로 감싸 Claude(또는 다른 MCP 클라이언트)가 실제 브라우저를 자동화하여 페이지 탐색, 양식 작성, 버튼 클릭, 데이터 추출 등을 할 수 있게 합니다.

왜 stdio 대신 HTTP 사용하나요?

브라우저 자동화 작업은 30-120+초 정도 소요됩니다. 표준 MCP stdio 전송은 장시간 실행 작업에서 타임아웃 문제가 발생하여 작업 중 연결이 끊깁니다. **HTTP 전송은 지속 시간 상관없이 요청을 신뢰성 있게 처리하는 영구 데몬으로 실행되어 이를 해결합니다.

---

설치

클로드 코드 플러그인 (추천)

자동 설정용 Claude Code 플러그인으로 설치하세요:

플러그인은 자동으로 다음과 같습니다:

• 첫 실행 시 Playwright 브라우저 설치
• Claude 코드가 시작될 때 HTTP 데몬을 시작함
• Claude로 MCP 서버를 등록합니다.

API 키를 설정하세요 (브라우저 에이전트가 작업을 결정하려면 LLM이 필요합니다):

그게 전부입니다! 이제 Claude는 브라우저 자동화 도구를 사용할 수 있습니다.

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