O que é um servidor MCP de navegador?
MCP é um protocolo aberto que permite a um app de IA chamar ferramentas de fora do modelo. Um servidor MCP de navegador adiciona ferramentas que abrem páginas, clicam, digitam e leem, para o assistente usar sites que não têm API. O servidor da Browsa executa esses passos em um navegador na nuvem, não na sua máquina: seu navegador, seus cookies e suas senhas nunca são tocados, e o trabalho continua mesmo se a página for lenta.
O servidor em si é um pequeno processo Node.js que seu cliente MCP inicia com npx. Cada requisição que ele envia vai para a API da Browsa com sua chave agt_live_.
-
Obter chave de API
Crie sua conta e copie sua chave em Keys no painel. Você ganha 100 créditos grátis assim que confirmar seu e-mail, sem cartão.
-
Adicione o servidor ao seu cliente
Claude Desktop
Abra o arquivo de configuração:
~/Library/Application Support/Claude/claude_desktop_config.jsonno macOS ou%APPDATA%\Claude\claude_desktop_config.jsonno Windows. Adicione o servidor, salve e reinicie o Claude Desktop.{ "mcpServers": { "browsa": { "command": "npx", "args": ["-y", "@browsa/mcp"], "env": { "BROWSA_API_KEY": "agt_live_..." } } } }Claude Code
Adicione pelo terminal. Coloque o nome do servidor antes de
-e; tudo depois de--é o comando que o Claude Code executa.claude mcp add browsa -e BROWSA_API_KEY=agt_live_... -- npx -y @browsa/mcpRode
claude mcp listpara verificar se ele conectou.Cursor
Adicione o mesmo bloco em
~/.cursor/mcp.jsonpara todos os projetos, ou em.cursor/mcp.jsonpara um projeto só.{ "mcpServers": { "browsa": { "command": "npx", "args": ["-y", "@browsa/mcp"], "env": { "BROWSA_API_KEY": "agt_live_..." } } } }VS Code
O VS Code lê
.vscode/mcp.jsonno seu workspace. O formato usaserversem vez demcpServers. Esta versão pede a chave na primeira vez que o servidor inicia, então ela não fica salva no arquivo.{ "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 e outros clientes
Qualquer cliente que inicie servidores MCP via stdio funciona. Aponte para
npx -y @browsa/mcpe definaBROWSA_API_KEYno ambiente do servidor. -
Experimente
Peça ao seu assistente algo que precise de uma página da web ao vivo, por exemplo:
- "Vá até news.ycombinator.com e me diga a principal notícia."
- "Abra books.toscrape.com e liste os cinco primeiros livros com os preços."
- "Toda manhã, confira o preço nesta página de produto e envie o resultado para o meu webhook."
O assistente chama
run_task. O resultado vem com umalive_url: abra para acompanhar o navegador e use o mouse e o teclado se uma página precisar de uma pessoa.
Qual modelo executa a tarefa no navegador?
O agente de navegador precisa de um modelo de linguagem. Você não precisa colocar uma chave de modelo na configuração. Em cada chamada, vale a primeira opção que se aplicar:
llm: "browsa"na chamadaModelo hospedado da Browsa, sem chave, 5 créditos extras por tarefa.BROWSA_LLM_API_KEYSua chave da Anthropic, OpenAI ou Google, enviada com cada tarefa, criptografada enquanto a tarefa roda e apagada quando ela termina.BROWSA_LLM_KEY_IDUma chave que você salvou no painel, pelo id.- Nada definidoA chave salva padrão do workspace. Sem chave salva e sem modelo indicado, a tarefa roda no modelo hospedado da Browsa e o resultado informa isso.
BROWSA_LLM define um modelo padrão, por exemplo anthropic:claude-sonnet-5-5. Se você indicar um modelo e não houver chave disponível, a ferramenta retorna LLM_KEY_REQUIRED em vez de usar o modelo hospedado.
Quais ferramentas o assistente recebe?
run_task- Executa uma tarefa no navegador descrita em linguagem natural e retorna o resultado e um link de visualização ao vivo.
get_job- Acompanha uma tarefa longa, podendo esperar no servidor.
cancel_job- Cancela uma tarefa em execução.
respond_to_job- Responde a uma tarefa que parou para pedir informações.
list_job_files- Lista os arquivos que uma tarefa gerou, como relatórios baixados.
create_schedule,list_schedules- Tarefas recorrentes, de a cada hora até a cada 30 dias.
list_webhooks,create_webhook,delete_webhook- Para onde os resultados são enviados, como webhooks assinados com HMAC.
list_identities- Identidades persistentes cujos logins salvos uma tarefa pode reaproveitar.
list_llm_keys- Chaves de modelo salvas, mascaradas. Nunca retorna um segredo.
credits- Saldo de créditos e pacotes.
Quanto custa?
O servidor MCP é grátis. Cada run_task é uma tarefa de agente, cobrada em créditos: o tempo do navegador (1 crédito a cada 12 minutos iniciados), mais 1 crédito, mais 1 crédito a cada 5 passos. O modelo hospedado da Browsa soma 5 créditos.
| Tarefa (termina em até 12 minutos) | Sua própria chave de modelo | Modelo hospedado da Browsa |
|---|---|---|
| 10 passos | 4 créditos | 9 créditos |
| 20 passos | 6 créditos | 11 créditos |
Uma tarefa que falha recebe de volta a cobrança do navegador e não paga pelos passos. Com sua própria chave, o provedor do modelo cobra os tokens de você; a Browsa não cobra nada a mais. Um crédito custa $0.10 no pacote Starter de $20. Preços completos.
Solução de problemas
O servidor não aparece
Reinicie o cliente depois de editar a configuração, confira se o JSON é válido e rode node --version em um terminal: o servidor precisa do Node.js 18 ou mais recente e do npx no path usado pelo cliente.
LLM_KEY_REQUIRED
Você indicou um modelo, mas não há chave disponível para ele. Salve uma chave em dashboard/llm-keys, defina BROWSA_LLM_API_KEY ou peça llm: "browsa".
402 INSUFFICIENT_CREDIT ou BUDGET_REACHED
O saldo está baixo demais, ou seu limite mensal de gastos foi atingido. Peça ao assistente para rodar a ferramenta credits, ou confira a página Créditos no painel.
Perguntas
O navegador roda no meu computador?
Não. O servidor MCP é um pequeno processo Node.js na sua máquina que chama a API da Browsa. O navegador roda na nuvem da Browsa, então não é preciso instalar mais nada e seu navegador nunca é tocado.
Preciso de uma chave da Anthropic ou da OpenAI?
Não. Só com BROWSA_API_KEY definida e sem chave salva, as tarefas rodam no modelo hospedado da Browsa por 5 créditos extras cada, e o servidor informa isso no resultado. Para usar seu próprio modelo, salve uma chave da Anthropic, OpenAI ou Google no painel, ou defina BROWSA_LLM_API_KEY.
Quanto custa cada requisição?
Cada chamada run_task é uma tarefa de agente: o tempo do navegador (1 crédito a cada 12 minutos iniciados), mais 1 crédito, mais 1 crédito a cada 5 passos. Uma tarefa de 10 passos que termina em até 12 minutos custa 4 créditos com sua própria chave e 9 no modelo hospedado da Browsa. O servidor MCP em si é grátis.
Com quais clientes MCP ele funciona?
Qualquer cliente que consiga iniciar um servidor MCP local via stdio, como Claude Desktop, Claude Code, Cursor, VS Code, Cline, Continue e Zed. O servidor precisa do Node.js 18 ou mais recente para o npx.