Connecter un assistant IA avec MCP
Le serveur MCP de Browser.lol permet à ton assistant d'utiliser un navigateur distant. Voici comment connecter un client, utiliser les outils et gérer l'accès aux sessions.
Ajouter le serveur à ton client
Connecter Claude Code
Utilise la version actuelle de Claude Code avec un modèle qui prend en charge les outils.
Ajouter la connexion
Lance la commande dans ton terminal, puis tape /mcp dans Claude Code et choisis browserlol pour te connecter.
Exécuter dans le terminal
claude mcp add --scope user --transport http browserlol https://api.browser.lol/mcpSe connecter et autoriser
Votre assistant ouvre Browser.lol. Connectez-vous au compte souhaité, autorisez l’accès puis revenez à votre assistant.
/mcpbrowserlolAuthenticate
Essayer dans une nouvelle discussion
Active le serveur et ses outils dans ton assistant, puis envoie la demande ci-dessous.
/mcp
Ouvre example.com dans une session Browser.lol et résume le contenu de la page.
Ce 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 une personne, pas une automatisation. 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 avec 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 une personne, pas une automatisation. 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 consulter, les renommer et les fermer ; changer le point de sortie ; consulter et modifier ton compte ; lire la boîte mail temporaire pour les liens et codes d'inscription. Pour une connexion ou un captcha, l'assistant demande de l'aide à la personne qui regarde avec browser_ask_user.
- browser_session_create
- browser_session_list
- browser_session_update
- browser_session_close
- browser_account
- browser_account_update
- 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, examiner la console et les requêtes réseau, lire les cookies et le stockage, 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
- browser_devtools
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
Fonctionnement des sessions
- Les outils de page peuvent créer une session. Un outil de page peut créer une session si ta clé n'en a aucune d'active. Si plusieurs sessions sont actives, indique session_id pour que le serveur sache laquelle utiliser.
- Les sessions ont des limites de durée. Une session peut se terminer après la période d'inactivité ou à la durée maximale prévue par son offre. Tu peux aussi la fermer pour libérer sa place.
- Tu partages les sessions avec ton assistant. Ton assistant peut lister et utiliser les sessions lancées dans l'application, 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