Liga um assistente de IA através de MCP
O servidor MCP do Browser.lol permite que o teu assistente use um navegador na nuvem. 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
Instala o Claude Code e inicia sessão. Usa Bash ou Zsh (macOS, Linux ou WSL) para o comando abaixo.
Adicionar a ligação
Executa o comando no terminal. Este adiciona o Browser.lol às tuas definições pessoais do Claude Code para todos os projetos.
Executar no terminal
claude mcp add --scope user --transport http browserlol https://api.browser.lol/mcpIniciar sessão e autorizar
No Claude Code, escreve /mcp, escolhe browserlol e inicia sessão na página do Browser.lol que se abre.
/mcpbrowserlolAuthenticate
Experimentar numa nova conversa
Confirma em /mcp que browserlol está ligado. Depois envia o pedido abaixo e aprova as ferramentas do navegador quando te for pedido.
/mcp
Abre example.com numa sessão do Browser.lol e diz-me o que está na página.
As ferramentas de automação, o teu próprio código e os clientes sem início de sessão usam antes uma chave de API num cabeçalho. A página Agentes cria uma para o cliente que escolheres; dá a cada cliente ou máquina a sua própria chave para poderes revogar os acessos em separado.
Abrir AgentesDo 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 nuvem 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 as localizações 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.
Do 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 a localização de saída; instalar e desinstalar apps; consultar a tua conta; ler o teu E-mail anónimo para obter links e códigos de registo; e pedir ajuda a quem está a ver para um início de sessão ou um captcha.
- browser_session_create
- browser_session_list
- browser_session_update
- browser_session_close
- browser_apps
- browser_account
- 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 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
Interação
Clicar, escrever, preencher formulários, escolher opções e deslocar a página, 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
Agent DevTools
Examinar o DOM, a rede, o armazenamento e o desempenho, executar scripts e enviar comandos das DevTools, para desenvolvimento web e depuração. O teu assistente instala sozinho a app Agent DevTools com browser_apps.
- browser_inspect
- browser_evaluate
- browser_cdp
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 agentes partilham sessões. O teu assistente pode listar e usar as sessões que tu próprio inicias, 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 dão acesso à tua conta tal 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 dele podem ficar guardadas.
- 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