Adicione o MCP do solvethree ao Claude Desktop

Instale o Node.js 22 na máquina que executa o Claude Desktop. Tenha em mãos a chave de API do seu espaço de trabalho e uma URL de proxy HTTP ou HTTPS. O servidor MCP usa um único proxy fornecido por SOLVETHREE_PROXY; a ferramenta de reCAPTCHA não aceita um argumento de proxy.

Para reCAPTCHA, primeiro crie um perfil ativo em Perfis de site. Configure o hostname de destino, a ação de captura e o tipo de reCAPTCHA necessários. Fornecer um hostname e uma ação ao Claude não cria esse perfil. Consulte configuração de perfil de site se ele ainda não estiver ativo.

1. 1.

   Abra o arquivo de configuração local

   No macOS, use ~/Library/Application Support/Claude/claude_desktop_config.json. No Windows, use %APPDATA%/Claude/claude_desktop_config.json.

2. 2.

   Adicione o servidor solvethree

   Use a configuração abaixo. Se o arquivo já contiver mcpServers, adicione a entrada solvethree dentro dele em vez de substituir seus outros servidores. Substitua os dois marcadores de variáveis de ambiente sem expor as credenciais.

3. 3.

   Reinicie o Claude Desktop

   Reinicie após salvar para que o aplicativo host inicie o servidor com a nova configuração.

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "REPLACE_WITH_YOUR_WORKSPACE_KEY",
        "SOLVETHREE_PROXY": "http://USER:PASSWORD@YOUR_PROXY:PORT"
      }
    }
  }
}

Os args baixam o arquivo do SDK oficial e iniciam seu executável solvethree-mcp como um servidor stdio local. Não há um endpoint MCP hospedado a ser informado.

Comece com solvethree_capabilities. Use solvethree_get_task para consultar uma tarefa existente. Nenhuma dessas operações é uma solicitação para criar uma nova resolução.

• solvethree_create_recaptcha aceita site como hostname, action e requestId, com recaptchaType e waitMs opcionais. O tipo padrão é enterprise-v3; v3 também é aceito.
• solvethree_create_kasada cria uma tarefa Kasada. Atualmente, o Kasada independente oferece suporte a destinos HTTPS em www.ticketmaster.com, não a sites arbitrários.
• solvethree_create_tmpt cria uma tarefa TMPT. Tarefas de evento usam a URL do evento; tarefas de login usam a URL de entrada para autenticação.

Dê ao Claude permissão explícita para criar uma tarefa para o destino e a ação acordados. Exija uma nova aprovação antes que ele inicie outra tarefa paga, incluindo uma substituição após falha ou rejeição pelo destino. A permissão para inspecionar ou consultar periodicamente uma tarefa não deve ser tratada como permissão para criar outra.

Toda ferramenta de criação exige requestId e cria no máximo uma tarefa. Mantenha esse ID junto das entradas originais. Se a criação exceder o tempo limite, recupere a tarefa repetindo a mesma requisição com o mesmo ID ou consulte-a se você já tiver o ID da tarefa. Um tempo limite não comprova que a criação falhou. Alterar as entradas reutilizando o ID gera conflito; usar um novo ID pode criar outra tarefa.

Para pending ou solving, continue consultando a tarefa existente. 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 reenvie automaticamente os mesmos dados de entrada inválidos.

Claude recebe dados privados da solução pelo host MCP. Faça sua aplicação usar o resultado no destino pretendido, com o proxy que funcionou e os valores retornados de userAgent e secChUa. Não resolva pelo proxy configurado para depois enviar por um IP diferente ou com uma identidade de navegador sem relação com a resolução.

Uma tarefa ready significa que uma solução foi gerada, não que o site aceitou sua requisição subsequente. Se o destino a rejeitar, verifique o token, cookie ou cabeçalhos enviados, o proxy, a identidade do navegador e a URL de destino antes de autorizar outra resolução.