Что такое браузерный MCP-сервер?
MCP: открытый протокол, через который ИИ-приложение вызывает внешние инструменты. Браузерный MCP-сервер добавляет инструменты, которые открывают страницы, кликают, вводят текст и читают, так что ассистент может пользоваться сайтами без API. Сервер Browsa выполняет эти шаги в облачном браузере, а не на вашей машине: ваш собственный браузер, cookies и пароли не затрагиваются, а работа продолжается, даже если страница грузится медленно.
Сам сервер: небольшой процесс Node.js, который ваш MCP-клиент запускает через npx. Каждый его запрос идёт в API Browsa с вашим ключом agt_live_.
-
Получить API-ключ
Зарегистрируйтесь и скопируйте ключ в разделе Keys дашборда. После подтверждения email вы получите 100 бесплатных кредитов, без карты.
-
Добавьте сервер в клиент
Claude Desktop
Откройте файл конфигурации:
~/Library/Application Support/Claude/claude_desktop_config.jsonна macOS или%APPDATA%\Claude\claude_desktop_config.jsonна Windows. Добавьте сервер, сохраните файл и перезапустите Claude Desktop.{ "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для одного проекта.{ "mcpServers": { "browsa": { "command": "npx", "args": ["-y", "@browsa/mcp"], "env": { "BROWSA_API_KEY": "agt_live_..." } } } }VS Code
VS Code читает
.vscode/mcp.jsonв вашем рабочем пространстве. В его формате вместоmcpServersиспользуетсяservers. Этот вариант запрашивает ключ при первом запуске сервера, поэтому ключ не хранится в файле.{ "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в окружении сервера. -
Попробуйте
Попросите ассистента о том, для чего нужна живая веб-страница, например:
- «Зайди на news.ycombinator.com и назови главную новость.»
- «Открой books.toscrape.com и перечисли первые пять книг с ценами.»
- «Каждое утро проверяй цену на этой странице товара и отправляй результат на мой вебхук.»
Ассистент вызывает
run_task. Результат приходит сlive_url: откройте его, чтобы смотреть браузер, и пользуйтесь мышью и клавиатурой, если странице нужен человек.
Какая модель выполняет задачу в браузере?
Браузерному агенту нужна языковая модель. Ключ модели в конфигурацию добавлять не нужно. Для каждого вызова срабатывает первое совпадение:
llm: "browsa"в вызовеМодель Browsa, без ключа, +5 кредитов за задачу.BROWSA_LLM_API_KEYВаш ключ Anthropic, OpenAI или Google: передаётся с каждой задачей, хранится зашифрованным, пока задача работает, и удаляется по её завершении.BROWSA_LLM_KEY_IDКлюч, сохранённый в дашборде, по id.- Ничего не заданоСохранённый ключ рабочего пространства по умолчанию. Если сохранённого ключа нет и модель не указана, задача выполняется на модели 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 или новее.