MCP-Werkzeuge & lokale HTTP-API

1. check_connection → list_profiles
2. open_profile mit genau dem profile_id; Behalten Sie die zurückgegebenen browser_session_id.
3. browser_pages um die genaue Auswahl auszuwählen page_id.
4. browser_snapshot um frische Element-Referenzen und eine snapshot_id.
5. Verwenden Sie für Aktionen passende Session-, Seiten-, Snapshot- und Elementreferenzen. Machen Sie nach Seitenänderungen einen neuen Snapshot.
6. release_browser wenn es fertig ist. Verwendung close_profile Nur wenn ich gebeten werde, das Profil zu schließen.

Ein Profil hat jeweils einen exklusiv steuernden Client. IDs sind undurchsichtig und können nach einem Neustart des Browsers nicht wiederverwendet werden. Wählen Sie visible -Modus, wenn eine Person sich anmelden oder das Werk inspizieren muss; headless ist 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 AI-Client weiter; verwenden Sie dieses Schema anstelle von raten Argumenten. Cookie-, Speicher-, Upload- und JavaScript-Tools können auf sensible Daten zugreifen.

Aktivieren Lokale API nur wenn eine lokale Integration HTTP benötigt. Kopiere 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öffentliche niemals dein 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. Setzen Sie ihn nicht über einen öffentlichen Reverse-Proxy aus und veröffentlichen Sie keine seiner Entdeckungsdateien. Die Token-Rotation macht alte Anmeldeinformationen ungültig; aktualisieren Sie danach Ihre lokale Integration.