Adicione o MCP do solvethree ao VS Code

Crie ou atualize .vscode/mcp.json com a configuração abaixo. Se o arquivo já contiver outros servidores ou entradas, mescle estas entradas em vez de substituí-las. O VS Code precisa conseguir executar npx localmente.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "solvethree-key",
      "description": "solvethree workspace API key",
      "password": true
    },
    {
      "type": "promptString",
      "id": "solvethree-proxy",
      "description": "HTTP(S) target proxy URL",
      "password": true
    }
  ],
  "servers": {
    "solvethree": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "${input:solvethree-key}",
        "SOLVETHREE_PROXY": "${input:solvethree-proxy}"
      }
    }
  }
}

O comando executa solvethree-mcp a partir do download oficial do SDK. As duas solicitações de senha fornecem SOLVETHREE_API_KEY e SOLVETHREE_PROXY a esse processo. Insira a chave de API do seu workspace e a URL do proxy HTTP(S) nessas solicitações, não no chat nem em um arquivo de configuração versionado. A URL do proxy não deve conter caminho, query ou fragmento.

A estrutura da configuração está documentada na referência de configuração do MCP no VS Code. Este é um processo local, não um endpoint MCP hospedado.

Depois que o VS Code iniciar o servidor, peça ao agente para chamar solvethree_capabilities antes de solicitar uma resolução. O servidor expõe estas ferramentas:

• solvethree_capabilities — verifique os recursos do serviço.
• solvethree_create_recaptcha — crie uma tarefa reCAPTCHA.
• solvethree_create_kasada — crie uma tarefa Kasada independente; o suporte atual é limitado a destinos HTTPS em www.ticketmaster.com.
• solvethree_create_tmpt — crie uma tarefa Ticketmaster TMPT para Event ou Login.
• solvethree_get_task — consulte o status e o resultado de uma tarefa.

Se essas ferramentas não estiverem disponíveis, primeiro verifique se o processo local inicia e recebe ambas as variáveis de ambiente. Alterar o site de destino ou criar outra tarefa não resolve um problema de inicialização do servidor.

1. 1.

   Ative o perfil do site

   Configure o destino em Perfis de site com o hostname, a ação de captura e o tipo de reCAPTCHA corretos. Um perfil ativo deve estar disponível para seu workspace antes da resolução. Fornecer um hostname e uma ação à ferramenta não cria um perfil. Consulte a configuração do perfil de site se este for um novo destino.

2. 2.

   Crie uma tarefa

   Peça ao agente para usar solvethree_create_recaptcha com site definido como o hostname, a action necessária e um requestId único para esta resolução lógica. A ferramenta também aceita recaptchaType e waitMs opcionais; o tipo padrão é enterprise-v3. Ela lê seu único proxy de SOLVETHREE_PROXY, então não adicione uma lista de proxies candidatos, type ou url a essa chamada de ferramenta.

3. 3.

   Acompanhe a tarefa até um status final

   Cada chamada de criação gera no máximo uma tarefa. Se o status for pending ou solving, use solvethree_get_task para consultá-la novamente. Apenas ready contém uma solução utilizável. Em caso de failed, pare as consultas periódicas e verifique errorCode e error; resoluções com falha são reembolsadas. Não tente novamente com os mesmos dados de entrada inválidos.

Mantenha o requestId se a criação exceder o tempo limite. Ele deve conter de 1–64 letras ASCII, números, sublinhados ou hífens. Repetir a mesma solicitação de tarefa com o mesmo ID retorna a tarefa existente; alterar os dados de entrada reutilizando esse ID causa conflito. Recupere a tarefa existente antes de pedir uma nova resolução lógica.

Para reCAPTCHA, envie solution.token ao destino pretendido — não o ID da tarefa. Use os valores retornados de userAgent e secChUa com o mesmo proxy usado na resolução. Trocar de IP ou misturar cabeçalhos de um navegador sem relação com a resolução pode fazer o envio falhar.

As outras ferramentas retornam dados diferentes: Kasada retorna um objeto de cabeçalhos que devem ser aplicados juntos, enquanto TMPT retorna o valor bruto do cookie tmpt. Mantenha cada resultado junto da identidade de navegador, do proxy e do destino associados.

O host MCP recebe dados privados da solução, mas não os envia por você. Uma tarefa ready significa que a solução foi gerada, não que o site aceitou a requisição da sua aplicação. Se o destino a rejeitar, verifique essa requisição enviada antes de pagar por outra resolução.