Pular para o conteúdo
Browsa
  1. Guias
  2. Servidor MCP

Configure o servidor MCP da Browsa no Claude, Cursor e VS Code.

O servidor MCP da Browsa (@browsa/mcp) é um servidor Model Context Protocol que dá a um assistente de IA um navegador real na nuvem. Você pede em linguagem natural, um agente de navegador na Browsa faz o trabalho e o assistente recebe a resposta com um link para acompanhar o navegador ao vivo.

Tempo
Cerca de 2 minutos
Requisitos
Node.js 18 ou mais recente, uma chave de API da Browsa
Pacote
@browsa/mcp no npm, MIT

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_.

  1. 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.

  2. Adicione o servidor ao seu cliente

    Claude Desktop

    Abra o arquivo de configuração: ~/Library/Application Support/Claude/claude_desktop_config.json no macOS ou %APPDATA%\Claude\claude_desktop_config.json no Windows. Adicione o servidor, salve e reinicie o Claude Desktop.

    claude_desktop_config.json
    {
      "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.

    Terminal
    claude mcp add browsa -e BROWSA_API_KEY=agt_live_... -- npx -y @browsa/mcp

    Rode claude mcp list para verificar se ele conectou.

    Cursor

    Adicione o mesmo bloco em ~/.cursor/mcp.json para todos os projetos, ou em .cursor/mcp.json para um projeto só.

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

    VS Code

    O VS Code lê .vscode/mcp.json no seu workspace. O formato usa servers em vez de mcpServers. Esta versão pede a chave na primeira vez que o servidor inicia, então ela não fica salva no arquivo.

    .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 e outros clientes

    Qualquer cliente que inicie servidores MCP via stdio funciona. Aponte para npx -y @browsa/mcp e defina BROWSA_API_KEY no ambiente do servidor.

  3. 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 uma live_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:

  1. llm: "browsa" na chamadaModelo hospedado da Browsa, sem chave, 5 créditos extras por tarefa.
  2. BROWSA_LLM_API_KEYSua chave da Anthropic, OpenAI ou Google, enviada com cada tarefa, criptografada enquanto a tarefa roda e apagada quando ela termina.
  3. BROWSA_LLM_KEY_IDUma chave que você salvou no painel, pelo id.
  4. 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 modeloModelo hospedado da Browsa
10 passos4 créditos9 créditos
20 passos6 créditos11 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.

Próximos passos

Dê um navegador ao seu assistente.

100 créditos grátis. Sem cartão, sem assinatura.