Herramientas MCP y API HTTP local

1. check_connection → list_profiles
2. Ejecute open_profile con el profile_id correcto y conserve el browser_session_id devuelto.
3. Use browser_pages para seleccionar el page_id correcto.
4. Use browser_snapshot para obtener referencias actualizadas de los elementos y un snapshot_id.
5. Utilice las referencias correspondientes de sesión, página, instantánea y elemento en cada acción. Obtenga una nueva instantánea cuando cambie la página.
6. Ejecute release_browser al terminar. Use close_profile solo cuando se solicite cerrar el perfil.

Solo un cliente puede controlar cada perfil a la vez. Los identificadores son opacos y no pueden reutilizarse después de reiniciar el navegador. Elija el modo visible cuando una persona deba iniciar sesión o revisar el trabajo; el modo headless permite ejecutar tareas compatibles en segundo plano.

Perfiles y páginas

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

Navegación e interacción

• 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

Datos y archivos

• 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

Estos son nombres de herramientas, no esquemas completos de solicitud. El servidor MCP conectado anuncia los nombres de parámetros actuales y los campos requeridos al cliente de IA; utiliza ese esquema en lugar de adivinar argumentos. Las herramientas de cookie, almacenamiento, subida y JavaScript pueden acceder a datos sensibles.

Habilite Local API solo si una integración local necesita HTTP. Copie el endpoint de bucle local actual y el token de acceso de API & MCP; el puerto se asigna dinámicamente. MCP sigue disponible con HTTP deshabilitado.

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

Se requiere el token. Se recomienda el ID de cliente opcional y debe tener entre 1 y 64 letras ASCII, dígitos, guiones bajos o guiones. Los ejemplos usan solo marcadores de posición. Nunca publique su token real.

GET /v1/profiles lista perfiles; POST /v1/profiles/open abre uno. Las respuestas exitosas usan {"ok":true,"data":…}; los fallos usan {"ok":false,"error":{"code":…,"message":…}}. Consulte los códigos de error comunes.

El servicio de escucha HTTP se vincula a 127.0.0.1, valida los encabezados Host y no habilita CORS del navegador. No lo exponga a través de un proxy inverso público ni publique sus archivos de descubrimiento. La rotación de tokens invalida credenciales antiguas; actualice su integración local después.