Herramientas MCP y API HTTP local

1. check_connection → list_profiles
2. open_profile con el exacto profile_id; retén el valor retornado browser_session_id.
3. browser_pages para seleccionar el exacto page_id.
4. browser_snapshot para obtener referencias frescas de elementos y un snapshot_id.
5. Usa referencias coincidentes de sesión, página, instantánea y elemento para las acciones. Toma una nueva instantánea después de cambios en la página.
6. release_browser cuando termines. Usa close_profile solo cuando se te pida cerrar el perfil.

Un perfil tiene un cliente controlador exclusivo a la vez. Los IDs son opacos y no se pueden reutilizar después de reiniciar el navegador. Elige visible modo cuando una persona necesite iniciar sesión o inspeccionar el trabajo; headless es para tareas en segundo plano compatibles.

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.

Habilitar API local solo si una integración local necesita HTTP. Copie el endpoint de bucle invertido actual y el token de acceso de API y 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 caracteres 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":…}}. Vea códigos de error comunes.

El oyente 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.