Añade solvethree MCP a VS Code

Crea o actualiza .vscode/mcp.json con la configuración siguiente. Si el archivo ya contiene otros servidores o entradas, integra estas entradas en lugar de sustituir las existentes. VS Code debe poder ejecutar npx localmente.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "solvethree-key",
      "description": "solvethree workspace API key",
      "password": true
    },
    {
      "type": "promptString",
      "id": "solvethree-proxy",
      "description": "HTTP(S) target proxy URL",
      "password": true
    }
  ],
  "servers": {
    "solvethree": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "${input:solvethree-key}",
        "SOLVETHREE_PROXY": "${input:solvethree-proxy}"
      }
    }
  }
}

El comando ejecuta solvethree-mcp desde la descarga oficial del SDK. Las dos solicitudes de contraseña proporcionan SOLVETHREE_API_KEY y SOLVETHREE_PROXY a ese proceso. Introduce la clave de API de tu espacio de trabajo y la URL del proxy HTTP(S) en esas solicitudes, no en el chat ni en un archivo de configuración incluido en el control de versiones. La URL del proxy no debe contener una ruta, una consulta ni un fragmento.

La estructura de la configuración está documentada en la referencia de configuración de MCP de VS Code. Se trata de un proceso local, no de un endpoint MCP alojado.

Una vez que VS Code haya iniciado el servidor, pide al agente que llame a solvethree_capabilities antes de solicitar una resolución. El servidor expone estas herramientas:

• solvethree_capabilities — consulta las capacidades del servicio.
• solvethree_create_recaptcha — crea una tarea de reCAPTCHA.
• solvethree_create_kasada — crea una tarea independiente de Kasada; actualmente solo se admiten destinos HTTPS en www.ticketmaster.com.
• solvethree_create_tmpt — crea una tarea de Ticketmaster TMPT para Event o Login.
• solvethree_get_task — obtiene el estado y el resultado de una tarea.

Si esas herramientas no están disponibles, comprueba primero que el proceso local se inicia y recibe ambas variables de entorno. Cambiar el sitio de destino o crear otra tarea no solucionará un problema de inicio del servidor.

1. 1.

   Activa el perfil del sitio

   Configura el destino en Perfiles de sitios con el nombre de host, la acción de captura y el tipo de reCAPTCHA correctos. Tu espacio de trabajo debe disponer de un perfil activo antes de resolver. Proporcionar un nombre de host y una acción a la herramienta no crea uno. Consulta la configuración de perfiles de sitios si se trata de un destino nuevo.

2. 2.

   Crea una sola tarea

   Pide al agente que utilice solvethree_create_recaptcha con site como nombre de host, la action requerida y un requestId único para esta resolución lógica. La herramienta también acepta los parámetros opcionales recaptchaType y waitMs; el tipo predeterminado es enterprise-v3. Obtiene su único proxy de SOLVETHREE_PROXY, así que no añadas una lista de proxies candidatos, type ni url a esta llamada a la herramienta.

3. 3.

   Sigue la tarea hasta que alcance un estado final

   Cada llamada de creación genera como máximo una tarea. Si su estado es pending o solving, utiliza solvethree_get_task para volver a consultarla. Solo ready contiene una solución utilizable. Si el estado es failed, deja de consultar y revisa errorCode y error; las resoluciones fallidas se reembolsan. No vuelvas a intentarlo con los mismos datos de entrada no válidos.

Conserva el requestId si se agota el tiempo de espera de la creación. Debe contener entre 1–64 letras ASCII, números, guiones bajos o guiones. Repetir la misma solicitud de tarea con el mismo ID devuelve la tarea existente; cambiar los datos de entrada reutilizando ese ID genera un conflicto. Recupera la tarea existente antes de solicitar una nueva resolución lógica.

Para reCAPTCHA, envía solution.token al destino previsto, no el ID de la tarea. Utiliza los valores userAgent y secChUa devueltos con el mismo proxy utilizado para la resolución. Cambiar de IP o combinar cabeceras de un navegador distinto puede hacer que el envío falle.

Las otras herramientas devuelven datos distintos: Kasada devuelve un objeto de cabeceras que deben aplicarse juntas, mientras que TMPT devuelve el valor sin procesar de la cookie tmpt. Mantén cada resultado junto con su identidad de navegador, proxy y destino asociados.

El host MCP recibe datos privados de la solución, pero no los envía por ti. Una tarea en estado ready significa que se ha generado la solución, no que el sitio web haya aceptado la solicitud de tu aplicación. Si el destino la rechaza, revisa esa solicitud saliente antes de pagar por otra resolución.