Connecter un assistant IA avec MCP
Le serveur MCP de Browser.lol permet à ton assistant d'utiliser un navigateur dans le cloud. Voici comment connecter un client, utiliser les outils et gérer les sessions et les accès.
Ajouter le serveur à ton client
Connecter Claude Code
Installe Claude Code et connecte-toi. Utilise Bash ou Zsh (macOS, Linux ou WSL) pour la commande ci-dessous.
Ajouter la connexion
Lance la commande dans ton terminal. Elle ajoute Browser.lol à tes réglages Claude Code personnels, pour tous tes projets.
Exécuter dans le terminal
claude mcp add --scope user --transport http browserlol https://api.browser.lol/mcpSe connecter et autoriser l’accès
Dans Claude Code, tape /mcp, choisis browserlol et connecte-toi sur la page Browser.lol qui s’ouvre.
/mcpbrowserlolAuthenticate
Essayer dans une nouvelle discussion
Vérifie dans /mcp que browserlol est connecté. Envoie ensuite la demande ci-dessous et approuve les outils de navigation quand on te le demande.
/mcp
Ouvre example.com dans une session Browser.lol et résume le contenu de la page.
Les outils d'automatisation, ton propre code et les clients sans connexion utilisent plutôt une clé API dans un en-tête. La page Agents en crée une pour le client choisi ; donne à chaque client ou machine sa propre clé pour pouvoir révoquer les accès séparément.
Ouvrir AgentsCe qu'il te faut
MCP (Model Context Protocol) permet à un assistant d'utiliser des outils externes. En connectant le tien à Browser.lol, tu lui donnes accès à un navigateur dans le cloud qu'il pilote comme une personne : de vraies entrées souris et clavier, avec un rythme humain, pour que les sites voient un visiteur, pas un automate. Il peut ouvrir et lire des pages, interagir avec elles, envoyer des fichiers et capturer l'écran entier. Les navigateurs et points de sortie disponibles dépendent de ton compte.
Le navigateur tourne sur notre infrastructure : aucun pilote de navigateur à installer. Ton client MCP, lui, reste là où tu l'as configuré. Nous hébergeons la session et proposons une vue en direct ; le modèle de ton assistant reste du côté de son client.
Ce qu'il te faut
- Point de terminaison
- https://api.browser.lol/mcp
- Transport
- Streamable HTTP, sans état à chaque requête
- Authentification
- Connexion OAuth dans ton navigateur, ou clé API dans un en-tête pour l'automatisation
- Offre
- Un compte disposant de l'accès programmatique, inclus dans Premium
- Navigateurs
- Les images prévues pour l'usage programmatique et disponibles sur ton compte ; Chrome par défaut
Les outils disponibles
Les outils browser_* pilotent le navigateur comme une personne : chaque clic, chaque frappe et chaque défilement est une vraie entrée souris ou clavier avec un rythme humain, pour que les sites voient un visiteur, pas un automate. Ton assistant peut commencer par browser_navigate, qui peut ouvrir une session et renvoyer un instantané d'accessibilité ; ses références d'éléments servent aux outils qui agissent sur la page. browser_screenshot capture toujours l'écran entier, et ses pixels sont les coordonnées x/y qu'utilisent browser_click, browser_hover, browser_drag et browser_scroll.
Sessions et compte
Créer des sessions avec une taille d'écran, une langue et une disposition de clavier ; les lister, les renommer et les fermer ; changer le point de sortie ; installer et désinstaller des apps ; consulter ton compte ; lire ton Mail anonyme pour les liens et codes d'inscription ; et demander de l'aide à la personne qui regarde pour une connexion ou un captcha.
- browser_session_create
- browser_session_list
- browser_session_update
- browser_session_close
- browser_apps
- browser_account
- browser_mail
- browser_ask_user
Navigation
Ouvrir une URL, revenir en arrière ou avancer, recharger et gérer plusieurs onglets.
- browser_navigate
- browser_tabs
Lire la page
Lire les instantanés d'accessibilité, avec les boîtes de dialogue en premier, rechercher du texte, attendre un texte, une URL ou un délai et capturer tout l'écran, y compris la barre du navigateur, les menus et les boîtes de dialogue natives.
- browser_snapshot
- browser_find
- browser_screenshot
- browser_wait_for
Interaction
Cliquer, saisir du texte, remplir des formulaires, choisir des options et faire défiler, par référence d'élément ou par les coordonnées de l'écran issues de browser_screenshot. Sans référence, la saisie va là où se trouve le focus clavier, y compris dans la barre d'adresse ; les touches répondent aussi à une boîte de dialogue JavaScript avec Entrée ou Échap.
- browser_click
- browser_type
- browser_fill_form
- browser_select_option
- browser_press_key
- browser_scroll
- browser_hover
- browser_drag
Fichiers
Joindre un fichier à un formulaire et récupérer les fichiers téléchargés par la session.
- browser_file_upload
- browser_downloads
Agent DevTools
Inspecter le DOM, le réseau, le stockage et les performances, exécuter des scripts et envoyer des commandes DevTools, pour le développement web et le débogage. Ton assistant installe lui-même l'app Agent DevTools avec browser_apps.
- browser_inspect
- browser_evaluate
- browser_cdp
Fonctionnement des sessions
- Les outils de page peuvent créer une session. Si ton compte n'a aucune session active, un outil de page peut en créer une. Si plusieurs sessions sont actives, indique un identifiant de session (session_id) pour que le serveur sache laquelle utiliser.
- Les sessions ont des limites de durée. Une session peut se terminer une fois atteintes les limites d'inactivité ou de durée maximale de ton offre. Tu peux aussi la fermer toi-même pour libérer sa place.
- Tu partages les sessions avec ton assistant. Ton assistant peut lister et utiliser les sessions que tu lances toi-même, y compris celles qui utilisent un profil enregistré. Tu peux suivre et gérer les sessions qu'il ouvre. Les changements apportés à un profil enregistré peuvent être conservés.
- L'accès reste lié à ton compte. Les outils n'accèdent qu'aux sessions du compte authentifié, selon les droits de ce compte.
- Accès programmatique requis. Ton compte doit disposer de l'accès programmatique. Sans cette fonction, le contrôle d'accès MCP renvoie une erreur HTTP 403. Premium inclut cette fonction.
Sécurité
- Les applications connectées et les clés API ont sur ton compte le même pouvoir qu'un mot de passe. Déconnecte une application ou révoque une clé depuis la page Agents dès que tu ne t'en sers plus.
- Envoie ta clé API dans un en-tête Authorization ou x-api-key. Les clés dans l'URL sont refusées, car les adresses finissent dans les journaux et l'historique des navigateurs.
- Les pages se chargent dans des conteneurs de navigateur distants. Un agent peut aussi utiliser une session liée à un profil enregistré ; ses changements peuvent alors être conservés.
- Le contrôle est automatique : les actions de ton assistant pilotent le navigateur pendant que tu suis la session en direct. Tu peux prendre la main avec le bouton de la visionneuse : tant que tu as le contrôle, l'assistant est en pause, ses actions attendent et renvoient user_in_control avec un délai avant de réessayer, et la lecture reste possible. Il reprend dès que tu lui rends la main.
Découvrir l'accès programmatique