Liga um assistente de IA através de MCP
O servidor MCP do Browser.lol permite que o teu assistente use um navegador na cloud. Este guia explica como ligar um cliente, usar as ferramentas e gerir as sessões e o acesso.
Adicionar o servidor ao teu cliente
Ligar Claude Code
Usa a versão atual de Claude Code com um modelo que suporte ferramentas.
Adicionar a ligação
Executa-o no terminal, escreve /mcp no Claude Code e escolhe browserlol para iniciares sessão.
Executar no terminal
claude mcp add --scope user --transport http browserlol https://api.browser.lol/mcpIniciar sessão e autorizar
O teu assistente abre Browser.lol. Inicia sessão com a conta que queres usar, autoriza o acesso e volta ao assistente.
/mcpbrowserlolAuthenticate
Experimentar numa nova conversa
Ativa o servidor e as ferramentas no teu assistente e envia o pedido abaixo.
/mcp
Abre example.com numa sessão do Browser.lol e diz-me o que está na página.
O que precisas
O MCP (Model Context Protocol) permite que um assistente use ferramentas externas. Ao ligares o teu ao Browser.lol, tens um navegador na cloud que ele controla como uma pessoa: entradas reais de rato e teclado com ritmo humano, para que os sites vejam uma pessoa, não uma automação. Pode abrir e ler páginas, interagir com elas, carregar ficheiros e capturar o ecrã inteiro. Os navegadores e locais de saída disponíveis dependem da tua conta.
O navegador corre na nossa infraestrutura, por isso não precisas de instalar um driver. O cliente MCP continua a correr onde o configuras. Nós alojamos a sessão e disponibilizamos uma vista em direto; o modelo do assistente continua associado ao teu cliente.
O que precisas
- Endpoint
- https://api.browser.lol/mcp
- Transporte
- Streamable HTTP, sem estado entre pedidos
- Autenticação
- Início de sessão OAuth no teu navegador ou, para automação, uma chave de API num cabeçalho
- Plano
- Uma conta com acesso programático, incluído no Premium
- Navegadores
- Imagens marcadas para uso programático e disponíveis na tua conta; Chrome por predefinição
Ferramentas disponíveis para o assistente
As ferramentas browser_* controlam o navegador como uma pessoa: cada clique, tecla e deslocamento é uma entrada real de rato ou teclado com ritmo humano, para que os sites vejam uma pessoa, não uma automação. O assistente pode começar por browser_navigate, que pode abrir uma sessão e devolver uma representação da página para tecnologias de acessibilidade; as referências dos elementos servem para as ferramentas de página. browser_screenshot captura sempre o ecrã inteiro, e os seus píxeis são as coordenadas x/y que browser_click, browser_hover, browser_drag e browser_scroll usam.
Sessões e conta
Iniciar sessões com tamanho de ecrã, idioma e disposição do teclado; listá-las, mudar-lhes o nome e fechá-las; mudar o local de saída; consultar ou ajustar a tua conta; e ler a caixa de email temporário para links e códigos de registo. Para um início de sessão ou um captcha, o assistente pede ajuda a quem está a ver com browser_ask_user.
- browser_session_create
- browser_session_list
- browser_session_update
- browser_session_close
- browser_account
- browser_account_update
- browser_mail
- browser_ask_user
Navegação
Abrir um URL, voltar atrás ou avançar, recarregar e trabalhar em vários separadores.
- browser_navigate
- browser_tabs
Ler a página
Consultar a estrutura acessível da página com os diálogos listados primeiro, pesquisar texto, esperar por um texto, um URL ou um tempo definido, inspecionar a consola e os pedidos de rede, ler cookies e armazenamento, e capturar o ecrã inteiro, incluindo a interface do navegador, os menus e os diálogos do sistema.
- browser_snapshot
- browser_find
- browser_screenshot
- browser_wait_for
- browser_devtools
Interação
Clica, escreve, preenche formulários, escolhe opções e faz scroll, por referência de elemento ou pelas coordenadas do ecrã de browser_screenshot. Sem referência, o texto escrito vai para onde está o foco do teclado, incluindo a barra de endereço; as teclas também respondem a um diálogo JavaScript com Enter ou Esc.
- browser_click
- browser_type
- browser_fill_form
- browser_select_option
- browser_press_key
- browser_scroll
- browser_hover
- browser_drag
Ficheiros
Carregar um ficheiro através de um campo da página ou obter um ficheiro transferido pela sessão.
- browser_file_upload
- browser_downloads
Como se comportam as sessões
- As ferramentas de página podem iniciar uma sessão. Se a tua conta não tiver nenhuma sessão em curso, uma ferramenta de página pode criar uma. Se houver várias sessões em curso, indica o ID da sessão para o servidor saber qual deve usar.
- As sessões têm limites de tempo. Uma sessão pode terminar ao atingir os limites de inatividade ou de duração máxima do teu plano. Também a podes fechar para libertar a vaga.
- Pessoas e assistentes partilham sessões. O teu assistente pode listar e usar sessões iniciadas na aplicação, incluindo sessões com perfis guardados. Podes acompanhar e gerir as sessões que ele iniciar. As alterações feitas num perfil guardado podem persistir.
- O acesso está limitado à tua conta. As ferramentas podem aceder às sessões da conta autenticada, de acordo com as permissões dessa conta.
- É necessário ter acesso programático. A conta precisa da funcionalidade de acesso programático. Sem ela, a verificação de acesso ao MCP devolve HTTP 403. O Premium inclui esta funcionalidade.
Segurança
- As apps ligadas e as chaves de API agem na tua conta como uma palavra-passe. Desliga uma app ou revoga uma chave na página Agentes assim que deixares de a usar.
- Envia a chave de API num cabeçalho Authorization ou x-api-key. Não aceitamos chaves no URL, porque os endereços acabam em registos e no histórico do navegador.
- As páginas carregam em contentores de navegador remotos. Um agente também pode usar uma sessão com um perfil guardado, onde as alterações podem ficar.
- O controlo é automático: as ações do teu assistente comandam o navegador enquanto acompanhas tudo na vista em direto. Assume o controlo com o botão que lá está: enquanto o tiveres, o assistente fica em pausa, as ações dele esperam e devolvem user_in_control com um tempo para tentar de novo, e a leitura continua a funcionar. Retoma assim que lhe devolveres o controlo.
Explora o acesso programático