Collegare un assistente AI tramite MCP

MCP (Model Context Protocol) è il modo in cui un assistente raggiunge strumenti che non ha già al suo interno. Punta il tuo su Browser.lol e può aprire pagine, leggerle, cliccare, scrivere, compilare moduli, caricare file, eseguire JavaScript e fare screenshot in un browser cloud isolato, dalla posizione di uscita che scegli tu.

Non gira nulla sulla tua macchina: non c'è nessun browser locale da installare, nessun driver da tenere aggiornato e nessuna chiave del modello da configurare qui. Ci mettiamo noi il browser, il ciclo di vita della sessione, l'uscita di rete e una vista dal vivo che puoi aprire e da cui puoi prendere il controllo in qualsiasi momento; il modello resta nel tuo client.

Endpoint

https://api.browser.lol/mcp

Trasporto

Streamable HTTP, stateless a ogni richiesta

Autenticazione

Una chiave API Browser.lol in un header della richiesta

Piano

Premium, che include l'accesso programmatico

Browser

Qualsiasi immagine della famiglia Chromium consentita dal tuo piano, Chrome di default

La chiave è ciò che autentica il tuo assistente e si porta dietro il piano e l'account a cui appartiene. Creane una nella tua dashboard: viene mostrata una volta sola, quindi copiala direttamente nel tuo client.

Usa una chiave per ogni client, macchina o pipeline. Se elimini una chiave, quel client si ferma subito e non succede nient'altro, anche nel bel mezzo di una conversazione.

Scegli il tuo client, inserisci la configurazione e sostituisci YOUR_API_KEY con la chiave che hai appena creato. La stessa chiave funziona ovunque, quindi su una seconda macchina serve solo questo passaggio.

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" }
    }
  }
}

Poi riavvia il client, così rileva il nuovo server. Non si installa nient'altro: il browser sta dalla nostra parte.

Chiedi qualcosa

Affida al tuo assistente un compito che richiede un browser. La sessione se la apre da solo:

Apri example.com in un browser Browser.lol e dimmi cosa c'è scritto nella pagina.

Ogni strumento si chiama browser_* e risponde con risultati strutturati. Un assistente può partire direttamente da browser_navigate: gli si apre una sessione e riceve uno snapshot di accessibilità i cui ref id sono ciò su cui agiscono tutti gli altri strumenti, il che costa meno ed è molto più preciso che lavorare sugli screenshot.

Come si comportano le sessioni

• Le sessioni si creano da sole. Il primo strumento di pagina ne apre una quando la tua chiave non ne ha nessuna attiva. Con più di una attiva, una chiamata senza id di sessione viene rifiutata invece di tirare a indovinare.
• Le sessioni si chiudono da sole. Una sessione finisce da sola quando non la guida più nessuno e, in ogni caso, al raggiungimento della durata massima. Se la chiudi tu, il posto si libera subito.
• Persone e agenti condividono un solo account. Il tuo assistente può elencare, guidare e chiudere le sessioni che hai avviato tu nell'app, e tu puoi fare lo stesso con le sue.
• La portata si ferma al tuo account. Ogni strumento lavora solo sulle tue sessioni. Le sessioni di altri non sono visibili né raggiungibili attraverso il server.
• L'accesso programmatico è una funzione del piano. Senza Premium ogni chiamata risponde con un avviso di upgrade invece che con il risultato dello strumento.

• Una chiave API è una credenziale: tienila nell'archivio segreti del tuo client o in una variabile d'ambiente, mai in un file di configurazione condiviso o in un link, ed eliminala nel momento stesso in cui ti sfugge.
• La chiave viaggia in un header della richiesta. Tienila fuori dagli URL, dove finirebbe nella cronologia del browser, nei log dei proxy e negli analytics.
• Le pagine si caricano nella nostra infrastruttura, mai sulla macchina che esegue l'assistente e mai in un tuo profilo del browser: ogni sessione è un container usa e getta.
• La sessione di un agente è visibile quanto la tua: puoi guardarla dal vivo e chiuderla a mano in qualsiasi momento.