Adicione o MCP do solvethree ao Cursor

1. 1.

   Defina as variáveis de ambiente

   Defina SOLVETHREE_API_KEY com a chave de API do seu workspace e SOLVETHREE_PROXY com o proxy que você usará para resolver e enviar. Disponibilize ambas para o processo que inicia o Cursor. Não coloque credenciais literais na configuração de um projeto.

2. 2.

   Escolha o arquivo de configuração

   Use .cursor/mcp.json para a configuração específica de um projeto ou ~/.cursor/mcp.json para a configuração de todo o usuário. Uma entrada de projeto chamada solvethree substitui uma entrada global com o mesmo nome.

3. 3.

   Adicione a entrada do servidor

   Use a configuração abaixo. Se o arquivo já contiver outros servidores, adicione solvethree dentro do objeto mcpServers existente em vez de substituir o arquivo.

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

Isso inicia solvethree-mcp a partir do download oficial do SDK usando npx. A configuração herda o ambiente do Cursor; ela não depende de interpolação de variáveis de ambiente dentro do JSON.

Encerre completamente o Cursor e abra-o novamente a partir de um ambiente que contenha ambas as variáveis. Exportar variáveis em um terminal não atualiza uma interface gráfica que já está em execução.

Verifique as ferramentas MCP do Cursor e a saída de MCP Logs. O servidor expõe solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt e solvethree_get_task. Chame solvethree_capabilities primeiro para verificar as operações disponíveis.

O servidor não inicia.

Leia MCP Logs para identificar o erro de inicialização.

Experimente: Se o Cursor não encontrar npx, disponibilize-o no PATH do Cursor e reinicie o Cursor.

O servidor informa que faltam variáveis de ambiente.

Verifique o ambiente que realmente iniciou o Cursor, não apenas seu terminal atual.

Experimente: Defina ambas as variáveis nesse ambiente, encerre completamente o Cursor e abra-o novamente.

O Cursor usa uma configuração inesperada.

Procure uma entrada solvethree nos dois arquivos de configuração.

Experimente: Atualize ou remova a entrada do projeto se sua intenção era usar a global.

Para saber sobre a interface de configuração do Cursor, consulte a documentação oficial de MCP.

1. 1.

   Confirme que o perfil do site está ativo

   Em Perfis de site, configure o hostname pretendido, a ação de captura e o tipo de reCAPTCHA. Confirme que o perfil está ativo antes de solicitar uma resolução. Passar um hostname e uma ação para a ferramenta não cria um perfil. Consulte a configuração do perfil de site para conhecer o processo de captura.

2. 2.

   Chame a ferramenta de reCAPTCHA

   Peça ao Cursor para chamar solvethree_create_recaptcha com site, action e um requestId único. site é o hostname, não a URL de uma página. O padrão de recaptchaType é enterprise-v3; waitMs é opcional. A ferramenta lê seu único proxy de SOLVETHREE_PROXY, então não adicione um argumento de proxy, type ou url.

3. 3.

   Acompanhe a tarefa até um status final

   Se a tarefa estiver em pending ou solving, use solvethree_get_task para consultá-la novamente. Apenas ready contém uma solução utilizável. Se estiver em failed, pare as consultas periódicas e verifique errorCode e error antes de decidir o que alterar.

Mantenha o requestId se a criação exceder o tempo limite. Cada chamada de criação gera no máximo uma tarefa, e repetir o mesmo ID de requisição com os mesmos dados de entrada recupera a tarefa existente. Alterar os dados de entrada reutilizando esse ID causa conflito. Não gere um novo ID apenas porque a primeira resposta se perdeu.

O trabalho do servidor MCP termina quando a tarefa está pronta. Sua aplicação deve enviar o token reCAPTCHA retornado ao destino pretendido. Use a identidade retornada em userAgent e secChUa com o mesmo proxy configurado para a resolução. Trocar de proxy ou usar uma identidade de navegador sem relação com a resolução pode fazer a requisição falhar.

Não confunda os tipos de solução ao usar as outras ferramentas: Kasada retorna um objeto de cabeçalhos que devem ser aplicados juntos, enquanto TMPT retorna um valor bruto de cookie tmpt. Nenhum deles é um token reCAPTCHA.

O Cursor recebe dados privados da solução pela resposta da ferramenta. Um resultado ready significa que uma solução foi gerada — não que o destino aceitou a requisição da sua aplicação. Se o envio falhar, verifique o token ou cookie enviado, a identidade e o proxy antes de pagar por outra resolução.