Ajouter solvethree MCP à VS Code

Créez ou modifiez .vscode/mcp.json avec la configuration ci-dessous. Si le fichier contient déjà d’autres serveurs ou entrées de saisie, fusionnez ces entrées au lieu de les remplacer. VS Code doit pouvoir exécuter npx localement.

{
  "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}"
      }
    }
  }
}

La commande exécute solvethree-mcp depuis le téléchargement officiel du SDK. Les deux invites de mot de passe fournissent SOLVETHREE_API_KEY et SOLVETHREE_PROXY à ce processus. Saisissez la clé API de votre espace de travail et l’URL du proxy HTTP(S) dans ces invites, pas dans le chat ni dans un fichier de configuration versionné. L’URL du proxy ne doit contenir ni chemin, ni chaîne de requête, ni fragment.

La structure de la configuration est décrite dans la référence de configuration MCP de VS Code. Il s’agit d’un processus local, pas d’un point de terminaison MCP hébergé.

Une fois que VS Code a démarré le serveur, demandez à l’agent d’appeler solvethree_capabilities avant de demander une résolution. Le serveur expose les outils suivants :

• solvethree_capabilities — examiner les capacités du service.
• solvethree_create_recaptcha — créer une tâche reCAPTCHA.
• solvethree_create_kasada — créer une tâche Kasada autonome ; la prise en charge actuelle se limite aux cibles HTTPS sur www.ticketmaster.com.
• solvethree_create_tmpt — créer une tâche Ticketmaster TMPT pour Event ou Login.
• solvethree_get_task — récupérer le statut et le résultat d’une tâche.

Si ces outils ne sont pas disponibles, vérifiez d’abord que le processus local démarre et reçoit les deux variables d’environnement. Changer le site cible ou créer une autre tâche ne résoudra pas un problème de démarrage du serveur.

1. 1.

   Activez le profil de site

   Configurez la cible dans Profils de site avec le bon nom d’hôte, l’action de capture et le type de reCAPTCHA. Un profil actif doit être disponible dans votre espace de travail avant la résolution. Fournir un nom d’hôte et une action à l’outil ne crée pas de profil. Consultez la configuration d’un profil de site s’il s’agit d’une nouvelle cible.

2. 2.

   Créez une seule tâche

   Demandez à l’agent d’utiliser solvethree_create_recaptcha avec site comme nom d’hôte, l’action requise et un requestId unique pour cette résolution logique. L’outil accepte aussi les paramètres facultatifs recaptchaType et waitMs ; le type vaut par défaut enterprise-v3. Il lit son unique proxy dans SOLVETHREE_PROXY ; n’ajoutez donc pas de liste de proxys candidats, de type ou d’url à cet appel d’outil.

3. 3.

   Suivez la tâche jusqu’à un statut final

   Chaque appel de création génère au plus une tâche. Si son statut est pending ou solving, utilisez solvethree_get_task pour la récupérer à nouveau. Seul ready contient une solution utilisable. En cas de statut failed, arrêtez l’interrogation et examinez errorCode et error ; les résolutions échouées sont remboursées. Ne réessayez pas avec les mêmes données invalides.

Conservez le requestId si la création dépasse le délai d’attente. Il doit contenir 1–64 lettres ASCII, chiffres, traits de soulignement ou traits d’union. Répéter la même demande de tâche avec le même ID renvoie la tâche existante ; modifier les données tout en réutilisant cet ID provoque un conflit. Récupérez la tâche existante avant de demander une nouvelle résolution logique.

Pour reCAPTCHA, soumettez solution.token à la cible prévue — pas l’ID de la tâche. Utilisez les valeurs userAgent et secChUa renvoyées avec le même proxy que celui utilisé pour la résolution. Changer d’IP ou combiner des en-têtes de navigateur sans rapport peut faire échouer la soumission.

Les autres outils renvoient des données différentes : Kasada renvoie un objet d’en-têtes à appliquer ensemble, tandis que TMPT renvoie la valeur brute du cookie tmpt. Conservez chaque résultat avec l’identité de navigateur, le proxy et la cible qui lui sont associés.

L’hôte MCP reçoit les données privées de la solution, mais ne les soumet pas à votre place. Une tâche au statut ready signifie que la solution a été générée, pas que le site web a accepté la requête de votre application. Si la cible la rejette, examinez cette requête sortante avant de payer pour une nouvelle résolution.