Execute o servidor MCP do solvethree no Docker

Salve isto como Dockerfile. Ele instala o pacote oficial no Node 22, muda para o usuário node sem privilégios de root e inicia solvethree-mcp como ponto de entrada do contêiner. Os comandos de criação e execução estão incluídos abaixo.

FROM node:22.23.4-alpine
RUN npm install --global https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz
USER node
ENTRYPOINT ["solvethree-mcp"]

# Build: docker build -t solvethree-mcp-local .
# Forward variables already set in the host; do not add their values to this file.
# Run: docker run --rm -i -e SOLVETHREE_API_KEY -e SOLVETHREE_PROXY solvethree-mcp-local

Antes de executá-lo, defina SOLVETHREE_API_KEY com a chave de API do seu espaço de trabalho e SOLVETHREE_PROXY com seu proxy no ambiente que inicia o Docker. Cada -e NAME repassa uma variável existente; não fornece um valor. Mantenha as credenciais fora do Dockerfile e da imagem.

A imagem é criada localmente como solvethree-mcp-local; não é necessária uma conta no Docker Hub. Executá-la não cria um endpoint MCP hospedado nem adiciona automação de navegador.

Configure um servidor stdio no seu host MCP. Use Docker como comando, não solvethree-mcp: o ponto de entrada da imagem inicia o executável dentro do contêiner.

Não adicione -t. O host precisa de stdin e stdout do contêiner para JSON-RPC. --rm remove o contêiner quando ele encerra.

As duas variáveis de ambiente devem estar disponíveis para o processo do host MCP. Defini-las em um terminal não ajuda um host iniciado em outro lugar, a menos que ele as herde. Se o host restringir o repasse de variáveis de ambiente, permita os dois nomes.

Para uma configuração TOML no estilo do Codex, use a tabela mcp_servers.solvethree com o comando e os argumentos acima. Inclua os nomes das duas variáveis em env_vars, defina startup_timeout_sec como 60 e tool_timeout_sec como 100. Consulte a documentação de integração MCP para conhecer o contrato subjacente do servidor.

1. 1.

   Verifique as ferramentas disponíveis

   Chame solvethree_capabilities após se conectar. O servidor disponibiliza ferramentas de resolução e consulta de tarefas; ele não controla um navegador nem preenche formulários.

2. 2.

   Prepare o perfil do reCAPTCHA

   Para reCAPTCHA, configure um perfil ativo em Perfis de site antes de solicitar uma resolução. O nome do host, a ação de captura e o tipo de reCAPTCHA devem corresponder; não presuma que um perfil de domínio cobre todas as ações. Enviar uma tarefa não cria um perfil. O guia de configuração de perfil aborda esse pré-requisito.

3. 3.

   Crie uma única tarefa lógica

   Chame solvethree_create_recaptcha com site, action e um requestId; recaptchaType e waitMs são opcionais. Essa ferramenta lê seu único proxy de SOLVETHREE_PROXY. Cada chamada de criação gera no máximo uma tarefa. Se a criação exceder o tempo limite, reutilize o mesmo ID de solicitação sem alterar os dados de entrada para recuperar a tarefa existente, em vez de criar outra.

4. 4.

   Aguarde um resultado utilizável

   Se a tarefa estiver pending ou solving, consulte-a com solvethree_get_task. Apenas ready contém uma solução utilizável. Em caso de failed, pare de consultar e examine errorCode e error antes de decidir o que alterar.

5. 5.

   Envie pela sua aplicação

   Para reCAPTCHA, envie solution.token, não o ID da tarefa. Use a identidade retornada em userAgent e secChUa com o proxy que funcionou. Uma tarefa pronta significa que uma solução foi gerada, não que o destino aceitou a solicitação da sua aplicação.

O host MCP recebe dados privados da solução. Mantenha esses resultados fora de logs compartilhados; sua aplicação continua responsável por enviá-los ao destino pretendido.