Adicione resolução de CAPTCHA ao seu agente de IA com MCP

O download oficial de @solvethree/sdk inclui o executável solvethree-mcp. As configurações abaixo usam npx para executá-lo a partir da URL do pacote fornecida. Não há um endpoint MCP hospedado para informar.

• Disponibilize npx no ambiente em que seu host MCP é executado.
• Defina SOLVETHREE_API_KEY com a chave de API do seu workspace no ambiente do host. Mantenha-a fora do código do navegador e dos prompts.
• Defina SOLVETHREE_PROXY nesse ambiente. A ferramenta de reCAPTCHA lê seu único proxy dessa variável, não da requisição à ferramenta.

Para um host que aceita configuração MCP em JSON, adicione esta entrada de servidor:

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ]
    }
  }
}

Para o Codex, use esta configuração TOML. A entrada env_vars repassa as duas variáveis do ambiente do host; ela não define seus valores.

[mcp_servers.solvethree]
command = "npx"
args = ["--yes", "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz", "solvethree-mcp"]
env_vars = ["SOLVETHREE_API_KEY", "SOLVETHREE_PROXY"]
startup_timeout_sec = 60
tool_timeout_sec = 100

Inicie ou recarregue o host com essas variáveis de ambiente disponíveis. Verifique se ele expõe solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt e solvethree_get_task.

Antes de criar uma tarefa de reCAPTCHA, configure o perfil do site de destino e verifique se ele está ativo no seu workspace. Enviar um hostname e uma ação via MCP não cria esse perfil.

Use solvethree_capabilities para inspecionar os recursos disponíveis. Para reCAPTCHA v3 Enterprise, chame solvethree_create_recaptcha com esta requisição:

{
  "site": "accounts.example.com",
  "action": "login",
  "requestId": "agent-login-001",
  "waitMs": 0
}

Substitua accounts.example.com pelo seu site de destino e login pela ação de que sua aplicação precisa. Escolha um requestId para esta tarefa lógica e guarde-o junto com a requisição. Com waitMs definido como zero, consulte o resultado separadamente, em vez de esperar pela conclusão nesta chamada.

Cada chamada de criação via MCP exige um requestId, embora esse campo seja opcional na API de tarefas subjacente. Use de 1–64 letras ASCII, números, sublinhados ou hífens.

1. 1.

   Guarde o ID da tarefa retornado

   A criação da tarefa não é o resultado. Salve o ID da tarefa para que o agente possa consultar essa mesma tarefa.

2. 2.

   Chame solvethree_get_task

   Use o ID da tarefa retornado pela chamada de criação. Se o status for pending ou solving, consulte a tarefa novamente mais tarde. Nenhum desses status contém uma solução utilizável.

3. 3.

   Trate o status terminal

   Em ready, passe a solução para sua integração com o navegador ou a aplicação. Em failed, inspecione errorCode e error e pare de fazer polling dessa tarefa.

Para reCAPTCHA, envie solution.token pelo navegador ou pela requisição da aplicação. Defina os cabeçalhos User-Agent e sec-ch-ua com os valores retornados em userAgent e secChUa e reutilize o proxy configurado em SOLVETHREE_PROXY. Mantenha essa sessão de proxy fixa se seu provedor alternar as saídas.

Kasada retorna cabeçalhos e Ticketmaster TMPT retorna o valor bruto de um cookie. Aplique a saída correspondente à tarefa que você solicitou; esses resultados não são intercambiáveis.

O servidor MCP não controla um navegador nem preenche formulários. Seu host recebe dados privados da solução, e sua aplicação faz o envio. Verifique a resposta do destino separadamente: o status pronto significa que solvethree gerou uma solução, não que o destino a aceitou.

Um tempo limite de conexão não comprova que a criação da tarefa falhou. Se você recebeu um ID de tarefa, consulte a tarefa. Caso contrário, repita a mesma requisição de criação com o mesmo requestId e os mesmos dados de entrada da tarefa para recuperar a tarefa existente. Não gere um novo ID só porque a resposta se perdeu.

Reutilizar um ID de requisição com dados de entrada diferentes gera conflito. Se a própria tarefa falhou, leia o erro antes de decidir o que mudar; reenviar dados inválidos às cegas não vai corrigi-los. Para entender a diferença entre erros de requisição e falhas de tarefa, consulte Erros da API de CAPTCHA.