Ligar um assistente de IA através de MCP

O MCP (Model Context Protocol) é a forma de um assistente chegar a ferramentas que não traz de origem. Aponta o teu para o Browser.lol e ele pode abrir páginas, lê-las, clicar, escrever, preencher formulários, carregar ficheiros, correr JavaScript e tirar capturas de ecrã num navegador cloud isolado, a partir da localização de saída que escolheres.

Nada corre na tua máquina: não há navegador local para instalar, nem driver para manter atualizado, nem chave de modelo para configurar aqui. Damos-te o navegador, o ciclo de vida da sessão, a saída para a internet e uma vista em direto que podes abrir e assumir a qualquer momento; o modelo fica do lado do teu cliente.

Endpoint

https://api.browser.lol/mcp

Transporte

Streamable HTTP, sem estado a cada pedido

Autenticação

Uma chave de API do Browser.lol num cabeçalho do pedido

Plano

Premium, que traz o acesso programático

Navegadores

Qualquer imagem da família Chromium que o teu plano permita, Chrome por predefinição

A chave é o que autentica o teu assistente, e traz consigo o plano e a conta que estão por trás. Cria uma no teu painel: é mostrada uma única vez, por isso copia-a logo para o teu cliente.

Usa uma chave por cliente, máquina ou pipeline. Eliminar uma chave interrompe esse cliente de imediato e mais nenhum, mesmo a meio de uma conversa.

Escolhe o teu cliente, mete lá a configuração e troca YOUR_API_KEY pela chave que acabaste de criar. A mesma chave funciona em todo o lado, por isso uma segunda máquina só precisa deste passo.

claude mcp add --transport http browserlol https://api.browser.lol/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "browserlol": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://api.browser.lol/mcp",
        "--header", "Authorization:Bearer YOUR_API_KEY"
      ]
    }
  }
}

{
  "mcpServers": {
    "browserlol": {
      "url": "https://api.browser.lol/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "browserlol": {
      "type": "http",
      "url": "https://api.browser.lol/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Reinicia o cliente a seguir, para ele apanhar o novo servidor. Não se instala mais nada: o navegador vive do nosso lado.

Pedir alguma coisa

Dá ao teu assistente uma tarefa que precise de um navegador. A sessão é aberta por ele:

Abre o example.com num navegador Browser.lol e diz-me o que diz a página.

Todas as ferramentas se chamam browser_* e respondem com resultados estruturados. Um assistente pode começar logo pelo browser_navigate: abre-se uma sessão para ele e recebe de volta um instantâneo de acessibilidade cujos ref ids são a base de todas as outras ferramentas, o que fica mais barato e é bem mais preciso do que trabalhar a partir de capturas de ecrã.

Como se comportam as sessões

• As sessões criam-se sozinhas. A primeira ferramenta de página abre uma quando a tua chave não tem nenhuma a correr. Com mais do que uma a correr, uma chamada sem id de sessão é recusada em vez de adivinhada.
• As sessões terminam sozinhas. Uma sessão termina por si assim que nada a estiver a controlar e, de qualquer forma, quando atinge o tempo máximo de execução. Se a fechares tu, o lugar fica livre de imediato.
• Pessoas e agentes partilham uma conta. O teu assistente pode listar, conduzir e fechar as sessões que iniciaste na aplicação, e tu podes fazer o mesmo com as dele.
• O alcance acaba na tua conta. Todas as ferramentas funcionam apenas nas tuas próprias sessões. As sessões de outra pessoa não são visíveis nem alcançáveis através do servidor.
• O acesso programático é uma funcionalidade do plano. Sem o Premium, cada chamada responde com um aviso de upgrade em vez de um resultado da ferramenta.

• Uma chave de API é uma credencial: guarda-a no cofre de segredos do teu cliente ou numa variável de ambiente, nunca num ficheiro de configuração partilhado nem numa ligação, e elimina-a assim que ela escapar.
• A chave viaja num cabeçalho do pedido. Mantém-na fora dos URLs, onde acabaria no histórico do navegador, nos registos dos proxies e nas analytics.
• As páginas carregam na nossa infraestrutura, nunca na máquina que corre o assistente e nunca num perfil de navegador teu: cada sessão é um contentor descartável.
• A sessão de um agente é tão visível como a tua: podes acompanhá-la em direto e terminá-la à mão a qualquer momento.