Adicione o MCP do solvethree ao Codex

1. 1.

   Disponibilize Node.js 22 e npx

   Eles devem estar disponíveis para o processo que executa o Codex. Instalá-los em um ambiente separado que o Codex não consegue acessar não permitirá que ele inicie o servidor.

2. 2.

   Defina as variáveis de ambiente do host

   Defina SOLVETHREE_API_KEY com a chave de API do seu workspace e SOLVETHREE_PROXY com a URL do proxy. Inicie o Codex com essas variáveis disponíveis. Para a integração com IDE, garanta que o processo da IDE também as herde. Mantenha a chave de API fora dos prompts e do controle de versão.

3. 3.

   Ative o perfil de site reCAPTCHA

   Em Perfis de site, adicione a URL HTTPS da página, selecione o tipo de reCAPTCHA e forneça a ação de captura. Aguarde até que o perfil esteja ativo. Configure o hostname, a ação de captura e o tipo necessários; o site e a ação de uma tarefa não criam um perfil. Consulte a configuração do perfil de site se este for seu primeiro destino.

A CLI do Codex e a IDE compartilham ~/.codex/config.toml. Você também pode usar o arquivo .codex/config.toml de um projeto confiável. Adicione esta entrada de servidor:

[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

A entrada executa o executável solvethree-mcp do SDK oficial por meio de npx. env_vars encaminha variáveis existentes do host; não atribui seus valores. Não há um endpoint MCP hospedado para informar nem login OAuth para este servidor local.

startup_timeout_sec permite 60 segundos para a inicialização do servidor. tool_timeout_sec permite 100 segundos para uma chamada de ferramenta. Nenhuma dessas configurações significa que o site de destino aceitou uma solução.

Execute codex mcp list, ou abra /mcp na TUI do Codex, para inspecionar o servidor configurado. Se ele não iniciar, verifique se o Codex consegue encontrar npx e herdou as duas variáveis de ambiente.

1. 1.

   Inspecione os recursos

   Peça ao Codex para chamar solvethree_capabilities antes de escolher a ferramenta de resolução. Para reCAPTCHA, use solvethree_create_recaptcha.

2. 2.

   Forneça os dados de entrada do reCAPTCHA

   Forneça site como nome do host, action e um requestId. A ferramenta também aceita recaptchaType e waitMs opcionais; o tipo padrão é enterprise-v3. Ela lê seu único proxy de SOLVETHREE_PROXY, portanto não trate essa variável como uma configuração de proxy por chamada. Não adicione os campos type ou url à solicitação de reCAPTCHA.

3. 3.

   Guarde o ID da tarefa e verifique seu status

   Cada chamada de criação gera no máximo uma tarefa. Consulte essa tarefa com solvethree_get_task usando o ID retornado. Continue consultando enquanto o status for pending ou solving. Apenas ready contém uma solução utilizável. Se o status mudar para failed, pare de consultar e examine errorCode e error antes de decidir o que alterar.

O servidor MCP não controla um navegador, não inspeciona sua sessão atual nem preenche formulários. Sua aplicação deve obter o resultado pronto do reCAPTCHA e enviar solution.token ao destino pretendido.

Use a identidade de navegador retornada em userAgent e secChUa com o mesmo proxy usado na resolução. Se seu navegador ou cliente HTTP usar outro proxy ou uma identidade de navegador sem relação com a retornada, corrija isso antes do envio. Adicionar o servidor MCP não define essas configurações para você.

O Codex recebe dados privados da solução pela resposta da ferramenta, portanto mantenha-os fora de relatórios e logs compartilhados. Uma tarefa ready significa que uma solução foi gerada; verifique separadamente a resposta do destino para determinar se ele aceitou a solicitação da aplicação.