Ferramentas MCP & API HTTP local

1. check_connection → list_profiles
2. Chame open_profile com o profile_id correto e guarde o browser_session_id retornado.
3. Use browser_pages para selecionar o page_id correto.
4. Use browser_snapshot para obter referências atualizadas dos elementos e um snapshot_id.
5. Use as referências correspondentes de sessão, página, snapshot e elemento em cada ação. Gere um novo snapshot após alterações na página.
6. Chame release_browser ao terminar. Use close_profile apenas quando o fechamento do perfil for solicitado.

Apenas um cliente pode controlar cada perfil por vez. Os identificadores são opacos e não podem ser reutilizados após reiniciar o navegador. Escolha o modo visible quando alguém precisar fazer login ou conferir o trabalho; o modo headless serve para tarefas compatíveis executadas em segundo plano.

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.

Habilite Local API 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 os 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.