Как подключить Browserbase к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Browserbase, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Browserbase + Gemini

Управляйте облачными браузерами Browserbase из своего ИИ: запускайте и завершайте сессии, получайте ссылки live view для отладки, читайте логи и записи сессий, проверяйте израсходованные браузерные минуты и загружайте страницы или ищите в интернете через Browserbase.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

BROWSERBASE_API_KEY

Шаг 1 — Получите учётные данные

1. Войдите на https://www.browserbase.com и откройте Settings в панели управления (https://www.browserbase.com/settings).
2. Скопируйте API key; он начинается с bb_live_. Указанный там Project ID не нужен: ключ уже привязан к проекту.
3. Вставьте ключ в BROWSERBASE_API_KEY и установите коннектор. Он отправляется только в Browserbase.
4. Проверьте настройку с помощью browserbase_list_projects: это бесплатно и показывает ваши проекты и сколько сессий каждый может запускать одновременно.

Что делает коннектор и что он оставляет вашим скриптам: он запускает, перечисляет, проверяет и завершает облачные браузерные сессии, выдаёт ссылки live view, читает логи и записи сессий, управляет контекстами (сохранёнными cookies и входами в аккаунты) и показывает расход. Он не кликает, не вводит текст и не переходит по страницам в браузере: это работа скрипта на Playwright, Puppeteer, Selenium или Stagehand, который подключается к сессии. Используйте коннектор, чтобы готовить и отлаживать сессии для таких скриптов, наблюдать за ними в реальном времени, выяснять, почему сессия упала, и следить за минутами. Чтобы прочитать публичную страницу, достаточно browserbase_fetch_page, сессия не нужна.

Сессии расходуют браузерные минуты, поэтому ИИ сначала спрашивает: Browserbase тарифицирует сессии поминутно (минимум одна минута на сессию, плюс трафик прокси, если прокси включены); тариф Free включает 1 браузерный час в месяц. Перед browserbase_create_session ИИ предупреждает, что сессия расходует минуты, и ждёт вашего «да». Сессия работает и тратит деньги, пока не истечёт её тайм-аут или её не завершат, поэтому ИИ завершает каждую запущенную им сессию через browserbase_release_session, как только она больше не нужна, и спрашивает, прежде чем завершить сессию, которой вы, возможно, ещё пользуетесь. browserbase_get_project_usage показывает браузерные минуты и байты прокси за текущий расчётный период.

Отладка скрипта: browserbase_list_sessions находит сессии по статусу (например RUNNING или ERROR) или по вашим собственным метаданным, а browserbase_get_session показывает одну сессию подробно. browserbase_get_live_urls возвращает ссылку live view работающей сессии, чтобы наблюдать за ней или взять управление в своём браузере. browserbase_get_session_logs перечисляет переходы, сетевые запросы и сообщения консоли, чтобы ИИ показал, где скрипт сломался. browserbase_get_session_replay даёт запись каждой страницы; browserbase_request_recording_downloads (сначала спрашивает) в фоне создаёт по одному MP4 на страницу, а browserbase_list_recording_downloads возвращает краткосрочные ссылки для скачивания.

Проекты, контексты и расширения: browserbase_get_project показывает лимит одновременных сессий и тайм-аут по умолчанию. Контекст сохраняет cookies и входы между сессиями, так что скрипт входит в аккаунт только один раз: browserbase_create_context (сначала спрашивает) и browserbase_get_context. browserbase_get_extension читает загруженное расширение Chrome по id.

Отключено при установке: browserbase_delete_context, потому что удалённый контекст вместе с входами восстановить нельзя. Администратор включает его осознанно; ИИ всё равно сначала спрашивает.

Fetch и поиск: browserbase_fetch_page получает одну страницу без браузера (без JavaScript, до 5 МБ) в исходном виде, в Markdown или в JSON, а browserbase_search_web возвращает до 25 результатов поиска. Оба расходуют месячную квоту тарифа (в тарифе Free по 1 000 вызовов каждый), а дальше оплачиваются за вызов; Markdown, JSON и прокси стоят дороже. Перед множеством вызовов подряд ИИ спрашивает.

Держите ссылки в секрете: ссылка подключения новой сессии содержит ключ подписи, а ссылки live view дают управление браузером. ИИ передаёт их только вам для вашего собственного скрипта и завершает сессию, когда вы закончили.

Недоверенный контент: загруженные страницы, результаты поиска и логи приходят со сторонних сайтов. ИИ воспринимает инструкции в них как данные, а не как команды.

Частые ошибки: 401: API-ключ неверный, отозван или отсутствует; скопируйте его заново в настройках. 402 или сообщение о тарифе: лимиты или кредит тарифа исчерпаны. 404: сессии, контекста или расширения нет в этом проекте, или данные сессии удалены. 429: слишком много одновременных сессий (3 в тарифе Free), слишком много запусков в минуту или слишком много вызовов Fetch или поиска в секунду; завершите неиспользуемые сессии, подождите и повторите. Сессия, завершившаяся со статусом TIMED_OUT, достигла своего тайм-аута; при создании попросите более длинный (от 60 до 21 600 секунд).

Коннектор не управляет браузером, не загружает файлы в сессии, не скачивает файловый архив сессии и не загружает расширения; Browserbase Agents и Functions, вебхуки и сертификаты он не охватывает.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Browserbase.

Доступные инструменты

Примеры запросов

• «Сколько браузерных минут израсходовал наш проект Browserbase в этом расчётном периоде и какие сессии ещё работают?»
• «Почему упала наша последняя сессия с ошибкой? Прочитай её логи и покажи последние открытые страницы и ошибки консоли.»
• «Запусти сессию Browserbase в eu-central-1 с тайм-аутом десять минут для моего скрипта на Playwright и дай ссылку live view. Спроси меня перед запуском.»
• «Сделай MP4-записи вчерашней тестовой сессии оформления заказа и дай ссылки для скачивания.»
• «Загрузи страницу с ценами example.com в Markdown и сведи тарифы в таблицу.»
• «Найди в интернете сравнения сервисов headless-браузеров за этот год и перечисли десять самых релевантных результатов.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT