Añade solvethree MCP a Codex

1. 1.

   Asegúrate de que Node.js 22 y npx estén disponibles

   Deben estar disponibles para el proceso que ejecuta Codex. Instalarlos en un entorno separado al que Codex no pueda acceder no le permitirá iniciar el servidor.

2. 2.

   Establece las variables de entorno del host

   Establece SOLVETHREE_API_KEY con la clave de API de tu espacio de trabajo y SOLVETHREE_PROXY con la URL del proxy. Inicia Codex con esas variables disponibles. Para la integración con el IDE, asegúrate de que el proceso del IDE también las herede. No incluyas la clave de API en los prompts ni en el control de versiones.

3. 3.

   Activa el perfil del sitio de reCAPTCHA

   En Perfiles de sitios, añade la URL HTTPS de la página, selecciona el tipo de reCAPTCHA y proporciona la acción de captura. Espera hasta que el perfil esté activo. Configura el nombre de host, la acción de captura y el tipo que necesitas; el sitio y la acción de una tarea no crean un perfil. Consulta la configuración de perfiles de sitios si es tu primer destino.

La CLI de Codex y el IDE comparten ~/.codex/config.toml. También puedes utilizar .codex/config.toml de un proyecto de confianza. Añade 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

La entrada ejecuta el ejecutable solvethree-mcp del SDK oficial mediante npx. env_vars reenvía las variables existentes del host; no les asigna valores. No hay ningún endpoint MCP alojado que introducir ni inicio de sesión con OAuth para este servidor local.

startup_timeout_sec permite 60 segundos para el inicio del servidor. tool_timeout_sec permite 100 segundos para una llamada a una herramienta. Ninguno de estos ajustes significa que el sitio web de destino haya aceptado una solución.

Ejecuta codex mcp list, o abre /mcp en la TUI de Codex, para inspeccionar el servidor configurado. Si no puede iniciarse, comprueba que Codex pueda encontrar npx y haya heredado ambas variables de entorno.

1. 1.

   Consulta las capacidades

   Haz que Codex llame a solvethree_capabilities antes de elegir la herramienta de resolución. Para reCAPTCHA, usa solvethree_create_recaptcha.

2. 2.

   Proporciona los datos de entrada de reCAPTCHA

   Proporciona site como nombre de host, action y un requestId. La herramienta también acepta recaptchaType y waitMs opcionales; el tipo predeterminado es enterprise-v3. Lee su único proxy de SOLVETHREE_PROXY, así que no lo trates como una configuración de proxy por llamada. No añadas campos type ni url a la solicitud de reCAPTCHA.

3. 3.

   Conserva el ID de la tarea y comprueba su estado

   Cada llamada de creación genera como máximo una tarea. Recupera esa tarea con solvethree_get_task usando el ID devuelto. Sigue consultándola mientras su estado sea pending o solving. Solo ready contiene una solución utilizable. Si pasa a failed, deja de consultar y examina errorCode y error antes de decidir qué cambiar.

El servidor MCP no controla un navegador, inspecciona su sesión actual ni rellena formularios. Tu aplicación debe tomar el resultado de reCAPTCHA listo y enviar solution.token al destino previsto.

Usa la identidad del navegador devuelta en userAgent y secChUa con el mismo proxy utilizado para la resolución. Si tu navegador o cliente HTTP usa un proxy diferente o una identidad de navegador que no corresponde, corrígelo antes del envío. Añadir el servidor MCP no configura esos ajustes por ti.

Codex recibe datos privados de la solución a través de la respuesta de la herramienta, así que no los incluyas en informes ni registros compartidos. Una tarea en estado ready significa que se ha generado una solución; comprueba por separado la respuesta del destino para determinar si ha aceptado la solicitud de la aplicación.