Browserbase MCP Server

Что умеет сервер

Сервер даёт любому MCP-клиенту облачный браузер Browserbase и управляет им через Stagehand, поэтому команды можно формулировать обычным языком вроде «нажми на кнопку входа» или «заполни форму обратной связи». Набор инструментов небольшой: start создаёт сессию Browserbase или подключается к существующей, navigate открывает адрес, act выполняет действие на странице, observe находит доступные элементы, extract достаёт данные, а end закрывает сессию.

Сессия сохраняет авторизацию и cookie между обращениями, а Browserbase хранит записи сессий для отладки. Среди параметров хостируемого сервера: keepAlive, proxies, verified и modelName. По умолчанию Stagehand использует модель google/gemini-2.5-flash-lite.

Когда использовать

Подходит для сбора данных с сайтов, заполнения форм, проверки пользовательских сценариев и повторяющихся административных задач в вебе, когда не хочется держать браузер у себя на машине. Основной вариант в документации хостируемый (Streamable HTTP), его и рекомендуют большинству пользователей. Локальный запуск через STDIO нужен, если клиент не умеет подключаться к удалённым серверам или нужны флаги вроде --contextId, --port и --browserWidth.

Если клиент не передаёт идентификатор MCP-сессии между вызовами (в документации в пример поставлен ChatGPT), в каждый вызов нужно добавлять sessionId, полученный от start, иначе будет ошибка No active session.

Ограничения и безопасность

Нужен ключ Browserbase. В хостируемой конфигурации из документации он указывается прямо в адресе, поэтому такой файл нельзя класть в общий репозиторий. Для модели, отличной от стандартной, потребуется отдельный modelApiKey, а булевы параметры в адресе принимаются только как строки "true" и "false". Флаг --verified локального запуска в документации помечен как доступный только на плане Scale.

Агент действует в настоящем браузере: всё, что он увидит или введёт на сайте, попадёт и к модели, поэтому не открывайте через него аккаунты без нужды. Прежний открытый репозиторий самостоятельно размещаемой версии сейчас в архиве, и разработчики не считают его отражением нынешних сервисов, поэтому ориентируйтесь на документацию Browserbase.

Claude Code

claude mcp add --transport http browserbase "https://mcp.browserbase.com/mcp?browserbaseApiKey=YOUR_BROWSERBASE_API_KEY"

Хостируемый сервер (рекомендуется)

Добавьте в конфигурацию MCP-клиента. Ключ API берётся в панели Browserbase:

{
  "mcpServers": {
    "browserbase": {
      "url": "https://mcp.browserbase.com/mcp?browserbaseApiKey=YOUR_BROWSERBASE_API_KEY"
    }
  }
}

Если нужна другая модель, добавьте modelName и modelApiKey:

{
  "mcpServers": {
    "browserbase": {
      "url": "https://mcp.browserbase.com/mcp?browserbaseApiKey=YOUR_BROWSERBASE_API_KEY&modelName=openai/gpt-4.1&modelApiKey=YOUR_MODEL_API_KEY"
    }
  }
}

Локально через npm (STDIO), конфигурация для Claude Desktop

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["@browserbasehq/mcp"],
      "env": {
        "BROWSERBASE_API_KEY": "your_api_key",
        "GEMINI_API_KEY": "your_gemini_api_key"
      }
    }
  }
}

После правки перезапустите клиент и попросите открыть любую страницу. Сессию можно увидеть в панели Browserbase.