Browser Use
Utilisez cette compétence pour les tâches de navigateur sur la session Chrome existante.
Les détails de réparation de la configuration se trouvent dans mcporter-config.md.
Route
- Si le plugin Codex
ChromeouChrome [Internal]est appelable dans la session en cours, utilisez sa compétence de contrôle Chrome intégrée. - Sinon, utilisez la route mcporter
chrome-devtoolsci-dessous.
Le fait d'être installé sur le disque ne signifie pas qu'il est disponible ; le plugin doit être appelable dans la session active. Les deux routes doivent utiliser le profil Chrome existant de l'utilisateur.
Pour le repli mcporter, utilisez cette cible :
mcporter call chrome-devtools.<tool>
La plupart des sites nécessitant une connexion échouent dans des profils isolés car les nouvelles sessions déclenchent des captchas, des vérifications d'appareil ou un état SSO/extension manquant. Préférez fortement le profil Chrome existant pour tout site web qui nécessite une connexion.
N'utilisez jamais chrome-isolated, Playwright, Puppeteer, le navigateur intégré de Codex, AppleScript, osascript, les scripts GUI, ou open macOS pour le contrôle du navigateur, sauf si l'utilisateur demande explicitement un navigateur isolé/nouveau.
Les bugs de capture d'écran/interface utilisateur en direct nécessitent ce chemin Chrome existant. curl, l'inspection de source, les tests Worker, ou Playwright local ne sont que des preuves de support ; ne les traitez pas comme équivalents lorsque l'utilisateur a montré un problème de rendu de navigateur ou que la page peut dépendre de l'état de connexion/profil.
Vérifier MCP
mcporter list chrome-devtools --schema
mcporter call chrome-devtools.list_pages --args '{}' --output text
list_pages doit afficher les onglets ouverts réels de l'utilisateur. Si elle affiche un Chrome isolé vide par défaut, arrêtez et dites que la reconnexion a échoué.
Si l'appel semble bloqué pendant que Chrome affiche une invite d'authentification/attachement/mise à jour, gérez l'alerte d'attachement avant de passer au repli. Préférez Peekaboo pour appuyer sur un bouton explicite Allow de Chrome lorsqu'il est visible ; sinon, attendez l'humain. Ne redémarrez pas les démons et ne tuez pas les processus MCP simplement parce que la première sortie est lente.
Récupération testée d'invite d'attachement :
PB="${PEEKABOO_BIN:-$HOME/bin/peekaboo}"
[ -x "$PB" ] || PB="$(command -v peekaboo)"
"$PB" permissions status --json
"$PB" see --app frontmost --path /tmp/chrome-attach.png --json --annotate
# Si l'interface montre Chrome "Allow remote debugging?", cliquez uniquement sur le bouton Allow visible.
"$PB" click --coords <allow_x>,<allow_y> --json
mcporter call chrome-devtools.list_pages --args '{}' --output text
Utilisez les coordonnées de l'instantané Peekaboo actuel, pas de notes obsolètes. Le succès signifie que list_pages renvoie les onglets Chrome réels de l'utilisateur.
Règle d'alerte d'attachement : lorsque l'instantané actuel montre clairement Chrome demandant l'autorisation de l'attachement DevTools/MCP/automatisation du navigateur, cliquez une fois sur le bouton Allow visible, puis réexécutez list_pages. Si le bouton n'est pas visible ou si l'invite est ambiguë, arrêtez et demandez ; ne passez pas silencieusement à Playwright/Puppeteer.
Si list_pages échoue avec DevToolsActivePort, demandez à l'utilisateur de redémarrer Chrome ou le pont DevTools, puis réessayez une fois :
mcporter daemon restart
mcporter call chrome-devtools.list_pages --args '{}' --output text
Si cela échoue encore, arrêtez et dites que Chrome DevTools MCP est indisponible. N'utilisez pas AppleScript.
Évitez les boucles de récupération bruyantes. Les redémarrages répétés de MCP/navigateur peuvent déclencher des invites de reconnexion/connexion et des alertes. Essayez une fois, puis faites une pause et choisissez un chemin plus silencieux.
Flux Typique
# sélectionner l'ID de page depuis list_pages
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
# inspecter la page
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
# naviguer vers la page sélectionnée
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
# cliquer sur un uid d'élément depuis le dernier instantané
mcporter call chrome-devtools.click --args '{"uid":"1_38","includeSnapshot":true}' --output text
# taper/remplir
mcporter call chrome-devtools.fill --args '{"uid":"1_13","value":"texte","includeSnapshot":true}' --output text
# exécuter JS, garder les secrets hors de la sortie
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.title"}' --output json
Utilisez take_snapshot avant les actions et n'utilisez que les valeurs actuelles de uid. Évitez take_screenshot sauf si la disposition visuelle est importante.
Preuve d'interface Utilisateur en Direct
Pour les régressions de capture d'écran, les vérifications de tableau de bord déployé, ou tout ce où le navigateur rendu est le bug :
mcporter call chrome-devtools.list_pages --args '{}' --output text
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.body.innerText"}' --output json
Utilisez l'ensemble d'onglets existant (connecté/porteur de profil). Si l'automatisation du navigateur est indisponible, signalez-le comme un écart de vérification au lieu de substituer un outil de navigateur isolé.
Gestion des Secrets
N'imprimez jamais les jetons/mots de passe depuis le DOM de la page, les journaux réseau, ou les entrées. Pour les vérifications de jetons, renvoyez uniquement la forme : présent/absent, longueur, code d'état, nom de compte/organisation.