Añade solvethree MCP a Cursor

1. 1.

   Configura las variables de entorno

   Establece SOLVETHREE_API_KEY con la clave de API de tu espacio de trabajo y SOLVETHREE_PROXY con el proxy que utilizarás para resolver y enviar la solución. Asegúrate de que ambas estén disponibles para el proceso que inicia Cursor. No incluyas credenciales literales en la configuración de un proyecto.

2. 2.

   Elige el archivo de configuración

   Utiliza .cursor/mcp.json para la configuración específica del proyecto o ~/.cursor/mcp.json para la configuración de todo el usuario. Una entrada de proyecto llamada solvethree prevalece sobre una entrada global con el mismo nombre.

3. 3.

   Añade la entrada del servidor

   Utiliza la configuración siguiente. Si el archivo ya contiene otros servidores, añade solvethree dentro del objeto mcpServers existente en lugar de sustituir el archivo.

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

Esto inicia solvethree-mcp desde la descarga oficial del SDK mediante npx. La configuración hereda el entorno de Cursor; no depende de la interpolación de variables de entorno dentro del JSON.

Cierra Cursor por completo y vuelve a iniciarlo desde un entorno que contenga ambas variables. Exportar variables en una terminal no actualiza una interfaz gráfica que ya está en ejecución.

Revisa las herramientas MCP de Cursor y la salida de los registros de MCP. El servidor expone solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt y solvethree_get_task. Llama primero a solvethree_capabilities para consultar las operaciones disponibles.

El servidor no se inicia.

Consulta los registros de MCP para ver el error de inicio.

Prueba esto: Si Cursor no encuentra npx, haz que esté disponible en el PATH de Cursor y reinicia Cursor.

El servidor indica que faltan variables de entorno.

Comprueba el entorno desde el que se inició realmente Cursor, no solo tu terminal actual.

Prueba esto: Establece allí ambas variables, cierra Cursor por completo y vuelve a iniciarlo.

Cursor utiliza una configuración inesperada.

Busca una entrada solvethree en ambos archivos de configuración.

Prueba esto: Actualiza o elimina la entrada del proyecto si querías utilizar la global.

Para conocer la interfaz de configuración de Cursor, consulta su documentación oficial de MCP.

1. 1.

   Confirma que el perfil del sitio está activo

   En Perfiles de sitios, configura el nombre de host previsto, la acción de captura y el tipo de reCAPTCHA. Confirma que el perfil está activo antes de solicitar una resolución. Pasar un nombre de host y una acción a la herramienta no crea un perfil. Consulta la configuración de perfiles de sitios para conocer el proceso de captura.

2. 2.

   Llama a la herramienta de reCAPTCHA

   Haz que Cursor llame a solvethree_create_recaptcha con site, action y un requestId único. site es el nombre de host, no la URL de una página. El valor predeterminado de recaptchaType es enterprise-v3; waitMs es opcional. La herramienta obtiene su único proxy de SOLVETHREE_PROXY, así que no añadas un argumento de proxy, type ni url.

3. 3.

   Sigue la tarea hasta que alcance un estado final

   Si la tarea está en estado pending o solving, utiliza solvethree_get_task para volver a consultarla. Solo ready contiene una solución utilizable. Si está en estado failed, deja de consultar y revisa errorCode y error antes de decidir qué cambiar.

Conserva el requestId si se agota el tiempo de espera de la creación. Cada llamada de creación genera como máximo una tarea, y repetir el mismo ID de solicitud con los mismos datos de entrada recupera la tarea existente. Cambiar los datos de entrada reutilizando ese ID genera un conflicto. No generes un ID nuevo solo porque se haya perdido la primera respuesta.

El trabajo del servidor MCP termina cuando la tarea está lista. Tu aplicación debe enviar el token de reCAPTCHA devuelto al destino previsto. Utiliza la identidad userAgent y secChUa devuelta con el mismo proxy configurado para la resolución. Cambiar de proxy o combinarla con una identidad de navegador distinta puede hacer que la solicitud falle.

Ten claro el tipo de solución si utilizas las otras herramientas: Kasada devuelve un objeto de cabeceras que deben aplicarse juntas, mientras que TMPT devuelve un valor sin procesar para la cookie tmpt. Ninguno de los dos es un token de reCAPTCHA.

Cursor recibe datos privados de la solución a través de la respuesta de la herramienta. Un resultado ready significa que se ha generado una solución, no que el destino haya aceptado la solicitud de tu aplicación. Si el envío falla, revisa el token o la cookie enviados, la identidad y el proxy antes de pagar por otra resolución.