Перейти к содержимому
Browsa
  1. Руководства
  2. MCP-сервер

Настройте MCP-сервер Browsa в Claude, Cursor и VS Code.

MCP-сервер Browsa (@browsa/mcp) работает по Model Context Protocol и даёт ИИ-ассистенту настоящий браузер в облаке. Вы просите обычными словами, браузерный агент Browsa выполняет работу, а ассистент получает ответ и ссылку, чтобы смотреть браузер вживую.

Время
Около 2 минут
Нужно
Node.js 18 или новее, API-ключ Browsa
Пакет
@browsa/mcp на npm, MIT

Что такое браузерный MCP-сервер?

MCP: открытый протокол, через который ИИ-приложение вызывает внешние инструменты. Браузерный MCP-сервер добавляет инструменты, которые открывают страницы, кликают, вводят текст и читают, так что ассистент может пользоваться сайтами без API. Сервер Browsa выполняет эти шаги в облачном браузере, а не на вашей машине: ваш собственный браузер, cookies и пароли не затрагиваются, а работа продолжается, даже если страница грузится медленно.

Сам сервер: небольшой процесс Node.js, который ваш MCP-клиент запускает через npx. Каждый его запрос идёт в API Browsa с вашим ключом agt_live_.

  1. Получить API-ключ

    Зарегистрируйтесь и скопируйте ключ в разделе Keys дашборда. После подтверждения email вы получите 100 бесплатных кредитов, без карты.

  2. Добавьте сервер в клиент

    Claude Desktop

    Откройте файл конфигурации: ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%\Claude\claude_desktop_config.json на Windows. Добавьте сервер, сохраните файл и перезапустите Claude Desktop.

    claude_desktop_config.json
    {
      "mcpServers": {
        "browsa": {
          "command": "npx",
          "args": ["-y", "@browsa/mcp"],
          "env": {
            "BROWSA_API_KEY": "agt_live_..."
          }
        }
      }
    }

    Claude Code

    Добавьте его из терминала. Имя сервера указывается перед -e, а всё после -- составляет команду, которую запускает Claude Code.

    Терминал
    claude mcp add browsa -e BROWSA_API_KEY=agt_live_... -- npx -y @browsa/mcp

    Выполните claude mcp list, чтобы проверить подключение.

    Cursor

    Добавьте тот же блок в ~/.cursor/mcp.json для всех проектов или в .cursor/mcp.json для одного проекта.

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "browsa": {
          "command": "npx",
          "args": ["-y", "@browsa/mcp"],
          "env": { "BROWSA_API_KEY": "agt_live_..." }
        }
      }
    }

    VS Code

    VS Code читает .vscode/mcp.json в вашем рабочем пространстве. В его формате вместо mcpServers используется servers. Этот вариант запрашивает ключ при первом запуске сервера, поэтому ключ не хранится в файле.

    .vscode/mcp.json
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "browsa-api-key",
          "description": "Browsa API key (agt_live_...)",
          "password": true
        }
      ],
      "servers": {
        "browsa": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@browsa/mcp"],
          "env": { "BROWSA_API_KEY": "${input:browsa-api-key}" }
        }
      }
    }

    Cline, Continue, Zed и другие клиенты

    Подойдёт любой клиент, который запускает MCP-серверы через stdio. Укажите команду npx -y @browsa/mcp и задайте BROWSA_API_KEY в окружении сервера.

  3. Попробуйте

    Попросите ассистента о том, для чего нужна живая веб-страница, например:

    • «Зайди на news.ycombinator.com и назови главную новость.»
    • «Открой books.toscrape.com и перечисли первые пять книг с ценами.»
    • «Каждое утро проверяй цену на этой странице товара и отправляй результат на мой вебхук.»

    Ассистент вызывает run_task. Результат приходит с live_url: откройте его, чтобы смотреть браузер, и пользуйтесь мышью и клавиатурой, если странице нужен человек.

Какая модель выполняет задачу в браузере?

Браузерному агенту нужна языковая модель. Ключ модели в конфигурацию добавлять не нужно. Для каждого вызова срабатывает первое совпадение:

  1. llm: "browsa" в вызовеМодель Browsa, без ключа, +5 кредитов за задачу.
  2. BROWSA_LLM_API_KEYВаш ключ Anthropic, OpenAI или Google: передаётся с каждой задачей, хранится зашифрованным, пока задача работает, и удаляется по её завершении.
  3. BROWSA_LLM_KEY_IDКлюч, сохранённый в дашборде, по id.
  4. Ничего не заданоСохранённый ключ рабочего пространства по умолчанию. Если сохранённого ключа нет и модель не указана, задача выполняется на модели Browsa, и результат об этом сообщает.

BROWSA_LLM задаёт модель по умолчанию, например anthropic:claude-sonnet-5-5. Если вы указали модель, а ключа для неё нет, инструмент возвращает LLM_KEY_REQUIRED и не переключается на другую модель.

Какие инструменты получает ассистент?

run_task
Запускает задачу в браузере, описанную обычными словами, и возвращает результат и ссылку на живой просмотр.
get_job
Проверяет долгую задачу, при желании дожидаясь результата на сервере.
cancel_job
Отменяет запущенную задачу.
respond_to_job
Отвечает задаче, которая остановилась и ждёт ввода.
list_job_files
Показывает файлы, записанные задачей, например скачанные отчёты.
create_schedule, list_schedules
Повторяющиеся задачи, от каждого часа до каждых 30 дней.
list_webhooks, create_webhook, delete_webhook
Куда доставляются результаты: вебхуки с подписью HMAC.
list_identities
Постоянные профили, сохранённые логины которых может использовать задача.
list_llm_keys
Сохранённые ключи моделей в замаскированном виде. Секреты не возвращаются.
credits
Баланс кредитов и пакеты.

Сколько это стоит?

MCP-сервер бесплатный. Каждый вызов run_task считается задачей агента и оплачивается кредитами: время её браузера (1 кредит за каждые начатые 12 минут), плюс 1 кредит, плюс 1 кредит за каждые 5 шагов. Модель Browsa добавляет 5 кредитов.

Задача (укладывается в 12 минут)Ваш ключ моделиМодель Browsa
10 шагов4 кредита9 кредитов
20 шагов6 кредитов11 кредитов

Упавшей задаче возвращается плата за браузер, шаги не списываются. С вашим ключом провайдер модели выставляет счёт за токены, Browsa не добавляет наценку. Один кредит стоит $0.10 в пакете Starter за $20. Все цены.

Решение проблем

Сервер не появляется

Перезапустите клиент после правки конфигурации, проверьте, что JSON корректный, и выполните node --version в терминале: серверу нужен Node.js 18 или новее и npx в PATH, который использует клиент.

LLM_KEY_REQUIRED

Вы указали модель, но ключа для неё нет. Сохраните ключ в dashboard/llm-keys, задайте BROWSA_LLM_API_KEY или запросите llm: "browsa".

402 INSUFFICIENT_CREDIT или BUDGET_REACHED

Не хватает баланса, или достигнут месячный лимит расходов. Попросите ассистента вызвать инструмент credits или откройте страницу Credits в дашборде.

Вопросы

Браузер работает на моём компьютере?

Нет. MCP-сервер: небольшой процесс Node.js на вашей машине, который вызывает API Browsa. Браузер работает в облаке Browsa, так что больше ничего устанавливать не нужно, а ваш собственный браузер не затрагивается.

Нужен ли ключ Anthropic или OpenAI?

Нет. Если задан только BROWSA_API_KEY и нет сохранённого ключа, задачи выполняются на модели Browsa за 5 дополнительных кредитов каждая, и сервер сообщает об этом в результате. Чтобы использовать свою модель, сохраните ключ Anthropic, OpenAI или Google в дашборде или задайте BROWSA_LLM_API_KEY.

Сколько стоит каждый запрос?

Каждый вызов run_task считается задачей агента: время её браузера (1 кредит за каждые начатые 12 минут), плюс 1 кредит, плюс 1 кредит за каждые 5 шагов. Задача на 10 шагов, которая укладывается в 12 минут, стоит 4 кредита с вашим ключом и 9 на модели Browsa. Сам MCP-сервер бесплатный.

С какими MCP-клиентами он работает?

С любым клиентом, который умеет запускать локальный MCP-сервер через stdio, включая Claude Desktop, Claude Code, Cursor, VS Code, Cline, Continue и Zed. Для npx серверу нужен Node.js 18 или новее.

Что дальше

Дайте ассистенту браузер.

100 бесплатных кредитов. Без карты и подписки.