Use um resultado de CAPTCHA via MCP em um agente de navegador

1. 1.

   Configure o servidor MCP local

   Siga as instruções de configuração do MCP para iniciar solvethree-mcp por meio de npx. Ele é um servidor stdio local, não um endpoint hospedado. Forneça SOLVETHREE_API_KEY e SOLVETHREE_PROXY pelo ambiente do host; não coloque credenciais no prompt do agente.

2. 2.

   Verifique as ferramentas disponíveis e o perfil do site

   Chame solvethree_capabilities para inspecionar os recursos disponíveis. Para reCAPTCHA Enterprise, o workspace já deve ter um perfil ativo para o hostname, a ação de captura e o tipo de reCAPTCHA pretendidos. Passar site e action para uma ferramenta de criação não cria esse perfil. Use Perfis de sites se a configuração ainda for necessária.

3. 3.

   Confirme que o navegador consegue enviar a requisição correspondente

   O navegador deve oferecer suporte ao mesmo proxy fixado e aos valores retornados de userAgent e secChUa. Ele também deve manter os cookies, os campos CSRF e os requisitos de sessão da aplicação. Se a ferramenta de navegador não permitir configurar esses elementos, pare antes de pagar por uma resolução, em vez de substituir a sessão por outra sem relação.

Para a ferramenta MCP de reCAPTCHA, o único proxy vem de SOLVETHREE_PROXY, não dos argumentos da ferramenta. Mantenha esse proxy fixado para o envio pelo navegador. O host recebe dados privados da solução, portanto não inclua tokens nem credenciais de proxy nos relatórios rotineiros do agente.

Use esta instrução depois que o servidor MCP e o navegador estiverem configurados. Forneça o hostname de destino e a ação de execução da requisição da aplicação. solvethree_create_recaptcha usa Enterprise v3 por padrão; seus argumentos obrigatórios são site, action e requestId.

Use the already-configured solvethree MCP server for one reCAPTCHA Enterprise task.
The target hostname must have an active workspace profile before creation.
1. Keep one requestId for this logical task. Ask before starting another paid task.
2. Call solvethree_create_recaptcha with site, action and that requestId.
   The server reads its target proxy from SOLVETHREE_PROXY.
3. Save the returned id. Call solvethree_get_task for that id while pending/solving,
   stopping at ready, failed or the agreed deadline. Never poll by creating again.
4. If ready, submit solution.token using the application’s actual token parameter.
   Use the returned userAgent/secChUa and the same pinned proxy in the browser.
   Keep the application’s cookies, CSRF fields and session requirements.
5. Read the application response. Report task ID and outcome, not secret solution data.
If the browser tool cannot configure that proxy and identity, stop and explain the
missing capability instead of claiming it submitted an equivalent request.

O id da tarefa salvo serve para solvethree_get_task; ele não é o valor a ser enviado ao site. pending e solving significam que você deve continuar aguardando dentro do prazo acordado. Somente ready contém uma solução utilizável. Em caso de failed, leia errorCode e error e pare de consultar essa tarefa.

Não existe uma etapa universal de preenchimento automático. Identifique a requisição da aplicação que consome o resultado e use o campo correspondente da solução. Para cada resultado abaixo, use a identidade de navegador retornada e o proxy bem-sucedido para o destino pretendido.

Após o envio, inspecione a resposta da aplicação. Uma tarefa ready significa que uma solução foi gerada, não que o destino a aceitou. Se o destino a rejeitar, primeiro inspecione a requisição de saída: confirme que o token, o cookie ou os cabeçalhos reais foram enviados, junto com o proxy, a identidade e a sessão da aplicação correspondentes. Informe o ID da tarefa e o resultado na aplicação sem expor a solução.

Gere um requestId por tarefa lógica e guarde-o com as entradas originais. Ele deve conter de 1–64 letras ASCII, números, sublinhados ou hífens. Se a criação exceder o tempo limite antes de você receber um id, repita a mesma requisição de criação com o mesmo requestId e as entradas inalteradas para recuperar a tarefa existente. Se você já tiver o id da tarefa, use solvethree_get_task.

Não altere as entradas ao reutilizar esse ID: isso gera conflito. Não gere um novo ID apenas porque uma resposta foi perdida ou o prazo de consulta expirou. Nenhum desses eventos prova que a tarefa original falhou.

Cada chamada de criação MCP gera no máximo uma tarefa, mas isso não impõe um limite de gastos ao agente. Exija aprovação antes de iniciar outra tarefa lógica. Em caso de falha definitiva, inspecione errorCode e error antes de decidir se uma requisição corrigida se justifica; resoluções com falha são reembolsadas. Um erro de requisição é um problema diferente de uma tarefa com status failed.