Un parcours pratique pour connecter un MCP Server à un environnement d’automatisation du navigateur, depuis la vérification des versions et la gestion des identifiants jusqu’à l’enregistrement du service et au test de connectivité, avec un ordre de diagnostic pour les listes d’outils vides, les échecs d’authentification et les délais dépassés.
MCP (Model Context Protocol) permet à un assistant d’AI de piloter un navigateur sans vous obliger à coder manuellement chaque interaction. Il peut appeler les outils dans le bon ordre et exécuter la tâche lui-même.
En pratique, les blocages viennent généralement moins du protocole que de quatre questions : quoi installer, à quelle adresse se connecter, comment fournir les identifiants et comment vérifier que la connexion fonctionne. En suivant ces quatre points, la plupart des problèmes se révèlent dès la configuration.
Vérifier d’abord trois éléments
Premièrement, il faut un client d’environnement d’automatisation du navigateur qui expose une interface locale, avec une version prenant en charge une API locale. Sur une version trop ancienne, l’interface peut ne pas exister du tout, alors que le seul symptôme visible est une liste d’outils vide. Deuxièmement, il faut Node.js 18 ou une version ultérieure. La plupart des MCP Server sont réalisés en TypeScript et nécessitent un runtime Node. Troisièmement, il faut un outil d’AI compatible avec MCP.
La version du client est le premier point à contrôler. Une part importante des erreurs de connexion ou des listes d’outils vides vient simplement d’une version obsolète et non du serveur.
Où se connecter
Au démarrage, le client lance sur la machine un service d’API local qui écoute sur une adresse de bouclage. Le port est visible et modifiable dans les paramètres d’interface du client. S’il est déjà utilisé, choisissez-en un autre puis redémarrez le client.
Le MCP Server accède à l’environnement via cette adresse locale, sans passer par Internet public. La conséquence inverse est tout aussi importante : ce service doit rester local et ne doit pas être exposé à l’extérieur.
Comment transmettre les identifiants
Générez une API Key dans les paramètres du client. Certaines implémentations utilisent deux éléments, un ID et une Key. Ces identifiants donnent en pratique le contrôle de tous les environnements associés à votre compte ; une personne qui les obtient peut potentiellement démarrer, modifier ou supprimer vos environnements.
Ne négligez pas les mesures de base. Ne placez jamais les identifiants dans un dépôt de code. Utilisez des variables d’environnement ou un fichier de configuration local, et ajoutez ce fichier à la liste d’exclusion. Faites immédiatement tourner les identifiants quand la composition de l’équipe change. Si vous pouvez créer des identifiants séparés selon l’usage, faites-le : les incidents sont plus faciles à attribuer et chaque identifiant peut être révoqué indépendamment. Dans la configuration de l’outil d’AI, transmettez l’endpoint et les identifiants par variables d’environnement au lieu de les écrire en dur dans la ligne de commande.
Enregistrer le service
L’enregistrement consiste généralement à ajouter une définition de service dans le fichier de configuration de l’outil d’AI. Elle comporte trois éléments : la méthode de démarrage, c’est-à-dire une commande ou le chemin d’un fichier d’entrée ; des variables d’environnement contenant l’endpoint local et les identifiants ; et un identifiant de service, qui correspond au nom affiché dans la liste des outils.
Redémarrez l’outil d’AI après l’enregistrement. La plupart des outils ne lisent la configuration qu’une fois au démarrage ; modifier le fichier sans redémarrer revient donc pratiquement à ne rien modifier.
Vérifier que la connexion fonctionne réellement
Procédez en deux étapes et dans cet ordre.
Commencez par consulter la liste des outils. Des outils liés au navigateur doivent apparaître, ce qui confirme que le service a été reconnu. Donnez ensuite une tâche en lecture seule, par exemple lister tous les environnements actuels. Une opération en lecture seule n’a pas d’effet secondaire, mais elle valide en une fois l’authentification, le réseau et le service. Si cette étape échoue, inutile d’essayer les tâches suivantes.
Ce qui devient possible une fois connecté
Une fois le service opérationnel, un assistant d’AI peut généralement interroger et rechercher des environnements, créer des environnements et définir leurs paramètres de base, les démarrer et les arrêter, associer une sortie réseau à un environnement, puis effectuer des actions concrètes dans une page : navigation, clics, saisie et captures d’écran.
L’utilisation se fait en langage naturel : vous décrivez l’objectif, puis l’assistant décide quels outils appeler et dans quel ordre. Une distinction est facile à perdre de vue : l’AI décide quoi faire, tandis que la couche d’environnement détermine sous quelle identité l’action est réalisée. En séparant ces deux responsabilités, on sait beaucoup plus vite où chercher lorsqu’un problème survient.
Ordre de diagnostic en cas d’échec de connexion
Si la liste des outils est vide, vérifiez d’abord le chemin du fichier de configuration, puis assurez-vous d’avoir redémarré l’outil d’AI, et enfin essayez de lancer le service manuellement pour voir s’il peut démarrer seul. Si l’une de ces trois étapes échoue, il est encore trop tôt pour mettre le protocole en cause.
Les échecs d’authentification ont généralement deux causes : la Key a été copiée avec un caractère supplémentaire ou un saut de ligne, ou la variable d’environnement n’a pas été lue correctement. Recopier la Key est souvent plus rapide que modifier la configuration à répétition.
Les délais de connexion dépassés pointent le plus souvent vers le côté local. Vérifiez que le client fonctionne et que le port n’est ni occupé ni bloqué par un pare-feu. La plupart des MCP Server nécessitent que le client reste lancé ; une fois le client fermé, les outils ne peuvent plus être appelés.
Si le service est joignable mais que les opérations s’exécutent mal, le problème vient souvent du timing. Indiquez clairement dans l’instruction quel état doit être atteint avant de poursuivre, au lieu de laisser l’assistant deviner si la page a fini de charger.
Un autre problème est rarement anticipé : plusieurs tâches partagent le même environnement. Les sessions, Cookies et caches s’écrasent mutuellement, les tâches commencent à se perturber et le résultat ressemble à des échecs aléatoires plutôt qu’à une erreur explicite. Il est plus sûr d’attribuer un environnement indépendant à chaque tâche et de laisser la couche d’environnement gérer la création et la récupération en masse. L’isolation des environnements et la gestion centralisée de PurpleMark se situent précisément à ce niveau ; après la connexion de MCP, l’orchestration des tâches et la gestion des identités restent deux sujets distincts.
Deux pièges supplémentaires
Lorsqu’un framework d’automatisation prend le contrôle du navigateur, la version du driver doit correspondre à la version du moteur utilisée par le client. Le client renvoie généralement un chemin de driver exploitable, mais un décalage de versions reste possible. Un outil de gestion de versions qui synchronise automatiquement le driver est souvent plus simple, tandis que l’endpoint de la page peut continuer à utiliser la valeur renvoyée par le client ; les deux ne sont pas incompatibles.
La concurrence est l’autre point. Un seul processus de navigateur consomme environ 300 à 500MB de mémoire, et il est conseillé de ne pas lancer plus de 5 environnements en même temps sur une même machine. Au-delà, des échecs de démarrage ou même des plantages peuvent apparaître. Pour les opérations de page, évitez également les attentes fixes : réglez le délai de chargement sur 30 secondes et utilisez des attentes explicites pour les éléments, avec un maximum de 20 secondes. C’est plus fiable que sleep.
Une limite à garder en tête
MCP résout le problème technique de la manière dont l’AI pilote un navigateur ; il ne modifie les règles d’aucune plateforme. La tâche doit toujours respecter les conditions d’utilisation de la plateforme cible. Ce qui est techniquement possible et ce qui est autorisé par les règles sont deux évaluations distinctes.
Pour les détails du protocole et des interfaces, référez-vous à la documentation officielle. Avant de commencer, vérifiez que la tâche prévue est autorisée sur la plateforme cible.
