Connecter un assistant IA via MCP

Browser.lol héberge un serveur MCP qui donne à un assistant IA un vrai navigateur dans notre cloud. Ce guide couvre la clé, la configuration du client, les outils dont dispose ton assistant et le comportement des sessions.

MCP (Model Context Protocol), c'est la façon dont un assistant accède à des outils qu'il n'embarque pas. Branche le tien sur Browser.lol et il peut ouvrir des pages, les lire, cliquer, taper, remplir des formulaires, envoyer des fichiers, exécuter du JavaScript et prendre des captures d'écran dans un navigateur cloud isolé, depuis l'emplacement de sortie que tu choisis.

Rien ne tourne sur ta machine : aucun navigateur local à installer, aucun pilote à tenir à jour et aucune clé de modèle à configurer ici. Nous fournissons le navigateur, le cycle de vie des sessions, la sortie réseau et une vue en direct que tu peux ouvrir et reprendre à tout moment ; le modèle, lui, reste chez ton client.

Ce qu'il te faut

Point de terminaison
https://api.browser.lol/mcp
Transport
Streamable HTTP, sans état à chaque requête
Authentification
Une clé API Browser.lol dans un en-tête de requête
Forfait
Premium, qui porte l'accès programmatique
Navigateurs
N'importe quelle image de la famille Chromium autorisée par ton forfait, Chrome par défaut

Créer une clé API

La clé est ce qui authentifie ton assistant, et elle porte le forfait et le compte qui sont derrière. Crées-en une dans ton tableau de bord : elle ne s'affiche qu'une seule fois, alors copie-la directement dans ton client.

Aller à tes clés API

Utilise une clé par client, machine ou pipeline. Supprimer une clé arrête ce client immédiatement et rien d'autre, y compris au milieu d'une conversation.

Ajouter le serveur à ton client

Choisis ton client, mets la configuration en place et remplace YOUR_API_KEY par la clé que tu viens de créer. La même clé fonctionne partout, donc une deuxième machine n'a besoin que de cette étape.

Claude Code

À lancer dans ton terminal.

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

Claude Desktop

À mettre dans claude_desktop_config.json.

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

Cursor

À mettre dans ~/.cursor/mcp.json.

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

Any other client

N'importe quel client qui parle MCP en HTTP et sait envoyer un en-tête de requête.

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

Redémarre ensuite le client pour qu'il prenne le nouveau serveur en compte. Rien d'autre n'est installé : le navigateur vit de notre côté.

Demande-lui quelque chose

Confie à ton assistant une tâche qui demande un navigateur. Il ouvre la session lui-même :

Ouvre example.com dans un navigateur Browser.lol et dis-moi ce que dit la page.

Les outils dont dispose ton assistant

Chaque outil s'appelle browser_* et répond avec des résultats structurés. Un assistant peut démarrer directement par browser_navigate : une session s'ouvre pour lui et il récupère un instantané d'accessibilité dont les identifiants ref servent de cible à tous les autres outils, ce qui coûte moins cher et reste bien plus précis que de travailler à partir de captures d'écran.

Sessions et cycle de vie

Démarrer un navigateur, lister ce qui tourne, en fermer un, et changer l'endroit par lequel son trafic sort sur Internet sans le redémarrer.

  • browser_session_create
  • browser_session_get
  • browser_session_list
  • browser_session_rename
  • browser_session_close
  • browser_set_location

Navigation

Ouvrir une URL, revenir en arrière, recharger, et travailler dans plusieurs onglets.

  • browser_navigate
  • browser_go_back
  • browser_go_forward
  • browser_reload
  • browser_tabs

Lire la page

L'instantané d'accessibilité sur lequel agissent les outils d'interaction, une recherche de texte, des captures d'écran, la sortie de la console et les requêtes envoyées par la page.

  • browser_snapshot
  • browser_find
  • browser_screenshot
  • browser_console_messages
  • browser_network_requests
  • browser_network_request

Interaction

Cliquer, taper, remplir un formulaire entier, choisir des options, appuyer sur des touches et exécuter du JavaScript. Chaque outil fait exactement ce qu'on lui demande : le serveur ne demande jamais rien à un modèle, le raisonnement reste donc dans ton propre assistant.

  • browser_click
  • browser_type
  • browser_fill_form
  • browser_select_option
  • browser_hover
  • browser_drag
  • browser_press_key
  • browser_scroll
  • browser_wait_for
  • browser_handle_dialog
  • browser_evaluate
  • browser_resize
  • browser_mouse

Fichiers

Donner un fichier à un champ de fichier, et récupérer ce que la session a téléchargé.

  • browser_file_upload
  • browser_downloads

Le comportement des sessions

  • Les sessions se créent toutes seules. Le premier outil de page en ouvre une quand ta clé n'en a aucune qui tourne. Si plusieurs tournent, un appel sans identifiant de session est refusé plutôt que deviné.
  • Les sessions se terminent toutes seules. Une session s'arrête d'elle-même dès que plus rien ne la pilote, et de toute façon au bout de sa durée maximale. La fermer toi-même libère la place immédiatement.
  • Les humains et les agents partagent un même compte. Ton assistant peut lister, piloter et fermer les sessions que tu as lancées dans l'application, et tu peux faire de même avec les siennes.
  • La portée s'arrête à ton compte. Chaque outil ne travaille que sur tes propres sessions. Les sessions de quelqu'un d'autre ne sont ni visibles ni accessibles via le serveur.
  • L'accès programmatique est une fonction de forfait. Sans Premium, chaque appel répond par un message de mise à niveau au lieu d'un résultat d'outil.

Sécurité

  • Une clé API est un identifiant : garde-la dans le coffre à secrets de ton client ou dans une variable d'environnement, jamais dans un fichier de configuration partagé ni dans un lien, et supprime-la dès qu'elle t'échappe.
  • La clé voyage dans un en-tête de requête. Garde-la hors des URL, où elle finirait dans l'historique du navigateur, les journaux de proxy et les outils d'analyse.
  • Les pages se chargent dans notre infrastructure, jamais sur la machine qui fait tourner l'assistant et jamais dans un de tes profils de navigateur : chaque session est un conteneur jetable.
  • La session d'un agent est aussi visible que la tienne : tu peux la regarder en direct et y mettre fin à la main à tout moment.

Prêt à en connecter un ?

L'accès MCP viendra avec Premium, bientôt disponible, avec les profils enregistrés, un quota de données résidentielles plus large et une deuxième session.

Voir les forfaits