Outils MCP et API HTTP locale

1. check_connection → list_profiles
2. open_profile avec le exact profile_id; conserver le retour browser_session_id.
3. browser_pages pour sélectionner le exact page_id.
4. browser_snapshot pour obtenir de nouvelles références d’éléments et un snapshot_id.
5. Utilisez des références de session, de page, de capture instantanée et d’élément correspondantes pour les actions. Prenez une nouvelle capture après les changements de page.
6. release_browser une fois terminé. Utilisez close_profile uniquement lorsqu’on vous demande de fermer le profil.

Un profil a un seul client contrôlant exclusif à la fois. Les ID sont opaques et ne peuvent pas être réutilisés après un redémarrage du navigateur. Choisissez visible le mode lorsque quelqu’un doit se connecter ou inspecter le travail; headless est pour les tâches en arrière-plan compatibles.

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échargement et JavaScript peuvent accéder à des données sensibles.

Activer API locale uniquement si une intégration locale nécessite HTTP. Copiez le point de terminaison en boucle locale actuel et le jeton d'accès à partir de 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, underscores 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":…}}. Voir 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.