MCP-Werkzeuge & lokale HTTP-API

1. check_connection → list_profiles
2. Rufen Sie open_profile mit der richtigen profile_id auf und bewahren Sie die zurückgegebene browser_session_id auf.
3. Wählen Sie mit browser_pages die richtige page_id aus.
4. Rufen Sie browser_snapshot auf, um aktuelle Elementreferenzen und eine snapshot_id zu erhalten.
5. Verwenden Sie bei jeder Aktion die passenden Referenzen für Sitzung, Seite, Snapshot und Element. Erstellen Sie nach Seitenänderungen einen neuen Snapshot.
6. Rufen Sie zum Abschluss release_browser auf. Verwenden Sie close_profile nur, wenn das Profil ausdrücklich geschlossen werden soll.

Ein Profil kann jeweils nur von einem Client gesteuert werden. IDs sind opake Kennungen und können nach einem Browserneustart nicht wiederverwendet werden. Wählen Sie den Modus visible, wenn sich eine Person anmelden oder die Arbeit überprüfen muss. Der Modus headless eignet sich für kompatible Hintergrundaufgaben.

Profile & Seiten

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

Navigation & Interaktion

• 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

Daten & Dateien

• 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

Dies sind Werkzeugnamen, keine vollständigen Anforderungsschemas. Der verbundene MCP-Server gibt aktuelle Parameternamen und erforderliche Felder an den KI-Client weiter; verwenden Sie dieses Schema anstatt Argumente zu erraten. Cookie-, Speicher-, Upload- und JavaScript-Tools können auf sensible Daten zugreifen.

Aktivieren Sie Local API nur wenn eine lokale Integration HTTP benötigt. Kopieren Sie den aktuellen Loopback-Endpunkt und Zugriffstoken von API & MCP; der Port wird dynamisch zugewiesen. MCP bleibt mit deaktiviertem HTTP verfügbar.

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

Das Token wird benötigt. Die optionale Client-ID wird empfohlen und muss 1–64 ASCII-Buchstaben, Ziffern, Unterstriche oder Bindestriche enthalten. Beispiele verwenden nur Platzhalter. Veröffentlichen Sie niemals Ihr echtes Token.

GET /v1/profiles listet Profile auf; POST /v1/profiles/open öffnet eines. Erfolgreiche Antworten verwenden {"ok":true,"data":…}; Fehler verwenden {"ok":false,"error":{"code":…,"message":…}}. Siehe allgemeine Fehlercodes.

Der HTTP-Listener bindet an 127.0.0.1, prüft Host-Header und aktiviert kein Browser-CORS. Stellen Sie ihn nicht über einen öffentlichen Reverse-Proxy bereit und veröffentlichen Sie keine Dateien mit seinen Verbindungsinformationen. Die Token-Rotation macht alte Anmeldeinformationen ungültig; aktualisieren Sie danach Ihre lokale Integration.