Ferramentas MCP & API HTTP local

1. check_connection → list_profiles
2. open_profile com o exato profile_id; retenha o retornado browser_session_id.
3. browser_pages para selecionar o exato page_id.
4. browser_snapshot para obter referências de elementos atualizadas e um snapshot_id.
5. Use referências de sessão, página, snapshot e elemento correspondentes para ações. Tire um novo snapshot após mudanças na página.
6. release_browser quando terminar. Use close_profile apenas quando solicitado a fechar o perfil.

Um perfil possui um cliente controlador exclusivo por vez. IDs são opacos e não podem ser reutilizados após reiniciar o navegador. Escolha visible modo quando uma pessoa precisar entrar ou inspecionar o trabalho; headless é para tarefas de fundo compatíveis.

Perfis e páginas

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

Navegação & interação

• 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

Dados e arquivos

• 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

Estes são nomes de ferramentas, não esquemas completos de solicitação. O servidor MCP conectado anuncia os nomes de parâmetros atuais e campos obrigatórios para o cliente de IA; use esse esquema em vez de adivinhar argumentos. Ferramentas de cookie, armazenamento, upload e JavaScript podem acessar dados sensíveis.

Habilitar API Local apenas se uma integração local precisar de HTTP. Copie o endpoint de loopback atual e o token de acesso de API & MCP; a porta é atribuída dinamicamente. MCP permanece disponível com HTTP desativado.

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

O token é necessário. O ID do cliente opcional é recomendado e deve conter de 1 a 64 letras ASCII, dígitos, sublinhados ou hífens. Os exemplos usam apenas marcadores de posição. Nunca publique seu token real.

GET /v1/profiles lista perfis; POST /v1/profiles/open abre um. Respostas bem-sucedidas usam {"ok":true,"data":…}; falhas usam {"ok":false,"error":{"code":…,"message":…}}. Veja códigos de erro comuns.

O listener HTTP se vincula ao 127.0.0.1, valida cabeçalhos Host e não habilita CORS no navegador. Não o exponha através de um proxy reverso público ou publique seus arquivos de descoberta. A rotação de tokens invalida credenciais antigas; atualize sua integração local posteriormente.