Añade resolución de CAPTCHA a tu agente de IA con MCP

La descarga oficial de @solvethree/sdk incluye el ejecutable solvethree-mcp. Las configuraciones siguientes usan npx para ejecutarlo desde la URL del paquete proporcionada. No hay ningún endpoint MCP alojado que debas introducir.

• Asegúrate de que npx esté disponible en el entorno donde se ejecuta tu host MCP.
• Establece SOLVETHREE_API_KEY con la clave de API de tu espacio de trabajo en el entorno del host. No la incluyas en el código del navegador ni en los prompts.
• Establece SOLVETHREE_PROXY en ese entorno. La herramienta de reCAPTCHA lee su único proxy de esta variable, no de la solicitud de la herramienta.

Para un host que admita configuración MCP en JSON, añade esta entrada de servidor:

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ]
    }
  }
}

Para Codex, usa esta configuración TOML en su lugar. Su entrada env_vars transmite las dos variables del entorno del host; no establece sus valores.

[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

Inicia o recarga el host con esas variables de entorno disponibles. Comprueba que exponga solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt y solvethree_get_task.

Antes de crear una tarea de reCAPTCHA, configura el perfil del sitio de destino y asegúrate de que esté activo para tu espacio de trabajo. Enviar un nombre de host y una acción mediante MCP no crea ese perfil.

Usa solvethree_capabilities para consultar las funciones disponibles. Para reCAPTCHA v3 Enterprise, llama a solvethree_create_recaptcha con esta solicitud:

{
  "site": "accounts.example.com",
  "action": "login",
  "requestId": "agent-login-001",
  "waitMs": 0
}

Sustituye accounts.example.com por tu sitio de destino y login por la acción que necesita tu aplicación. Elige un requestId para esta tarea lógica y guárdalo junto con la solicitud. Con waitMs establecido en cero, recupera el resultado por separado en lugar de esperar a que termine en esta llamada.

Cada creación mediante MCP requiere un requestId, aunque ese campo es opcional en la API de tareas subyacente. Usa entre 1–64 letras ASCII, números, guiones bajos o guiones.

1. 1.

   Conserva el identificador de tarea devuelto

   La creación de la tarea no es el resultado. Guarda el identificador de tarea para que el agente pueda recuperar esa misma tarea.

2. 2.

   Llama a solvethree_get_task

   Usa el identificador de tarea devuelto por la llamada de creación. Si el estado es pending o solving, vuelve a recuperar la tarea más tarde. Ninguno de esos estados contiene una solución utilizable.

3. 3.

   Gestiona el estado terminal

   En estado ready, pasa la solución a tu integración con el navegador o la aplicación. En estado failed, revisa errorCode y error y deja de consultar esa tarea.

Para reCAPTCHA, envía solution.token mediante tu navegador o la solicitud de tu aplicación. Establece sus cabeceras User-Agent y sec-ch-ua a partir de los valores devueltos de userAgent y secChUa, y reutiliza el proxy configurado en SOLVETHREE_PROXY. Mantén fija esa sesión de proxy si tu proveedor rota las salidas.

Kasada devuelve cabeceras y Ticketmaster TMPT devuelve el valor de una cookie sin procesar. Aplica la salida correspondiente a la tarea que solicitaste; estos resultados no son intercambiables.

El servidor MCP no controla un navegador ni rellena formularios. Su host recibe datos privados de la solución y tu aplicación realiza el envío. Comprueba por separado la respuesta del destino: el estado ready significa que solvethree generó una solución, no que el destino la haya aceptado.

Un tiempo de espera de conexión agotado no demuestra que la creación de la tarea haya fallado. Si recibiste un ID de tarea, consulta esa tarea. De lo contrario, repite la misma solicitud de creación con el mismo requestId y sin cambiar los datos de entrada de la tarea para recuperar la tarea existente. No generes un ID nuevo solo porque se perdió la respuesta.

Reutilizar un ID de solicitud con datos de entrada distintos para la tarea genera un conflicto. Si la tarea en sí falló, lee su error antes de decidir qué cambiar; reenviar a ciegas datos de entrada no válidos no los corregirá. Para conocer la diferencia entre errores de solicitud y fallos de tarea, consulta Errores de la API de CAPTCHA.