Outils MCP et API HTTP locale

1. check_connection → list_profiles
2. Appelez open_profile avec le profile_id exact ; conservez le browser_session_id renvoyé.
3. Appelez browser_pages pour sélectionner le bon page_id.
4. Appelez browser_snapshot pour obtenir des références d’éléments à jour et un snapshot_id.
5. Utilisez les références correspondantes de session, de page, d’instantané et d’élément pour chaque action. Prenez un nouvel instantané après toute modification de la page.
6. Appelez release_browser une fois le travail terminé. Utilisez close_profile uniquement si la fermeture du profil a été demandée.

Un seul client peut contrôler un profil à la fois. Les identifiants sont opaques et ne peuvent pas être réutilisés après un redémarrage du navigateur. Choisissez le mode visible lorsqu’une personne doit se connecter ou vérifier le travail ; le mode headless convient aux tâches compatibles exécutées en arrière-plan.

Profils et pages

• check_connection
• list_profiles
• open_profile
• close_profile
• release_browser
• browser_pages
• browser_new_page
• browser_close_page
• browser_activate_page

Navigation et interaction

• browser_navigate
• browser_back
• browser_forward
• browser_reload
• browser_snapshot
• browser_click
• browser_click_coordinates
• browser_type
• browser_press
• browser_hover
• browser_select
• browser_scroll
• browser_drag
• browser_wait
• browser_handle_next_dialog

Données & fichiers

• browser_screenshot
• browser_upload_files
• browser_get_cookies
• browser_set_cookies
• browser_clear_cookies
• browser_storage_get
• browser_storage_set
• browser_storage_clear
• browser_grant_permissions
• browser_prepare_download
• browser_wait_download
• browser_evaluate

Ce sont des noms d'outils, pas des schémas de requête complets. Le serveur MCP connecté annonce les noms de paramètres actuels et les champs requis au client IA ; utilisez ce schéma au lieu de deviner les arguments. Les outils Cookie, stockage, téléversement et JavaScript peuvent accéder à des données sensibles.

Activez Local API uniquement si une intégration locale nécessite HTTP. Copiez le point de terminaison en boucle locale actuel et le jeton d'accès depuis API & MCP; le port est assigné dynamiquement. MCP reste disponible avec HTTP désactivé.

GET http://127.0.0.1:<port>/v1/status
Authorization: Bearer <access-token>
X-IFox9-Client-ID: my-integration

Le jeton est requis. L'ID client facultatif est recommandé et doit contenir 1 à 64 lettres ASCII, chiffres, tirets bas ou tirets. Les exemples n'utilisent que des espaces réservés. Ne publiez jamais votre vrai jeton.

GET /v1/profiles liste les profils ; POST /v1/profiles/open en ouvre un. Les réponses réussies utilisent {"ok":true,"data":…}; les échecs utilisent {"ok":false,"error":{"code":…,"message":…}}. Consultez les codes d'erreur courants.

L'écouteur HTTP se lie à 127.0.0.1, valide les en-têtes Host et n'active pas le CORS pour les navigateurs. Ne l'exposez pas via un proxy inverse public ni ne publiez ses fichiers de découverte. La rotation des jetons invalide les anciennes informations d'identification ; mettez à jour votre intégration locale ensuite.