Ajouter solvethree MCP à Cursor

1. 1.

   Définir les variables d’environnement

   Définissez SOLVETHREE_API_KEY sur la clé API de votre espace de travail et SOLVETHREE_PROXY sur le proxy que vous utiliserez pour la résolution et la soumission. Rendez ces deux variables accessibles au processus qui lance Cursor. N’inscrivez pas d’identifiants en clair dans la configuration d’un projet.

2. 2.

   Choisissez le fichier de configuration

   Utilisez .cursor/mcp.json pour une configuration propre au projet ou ~/.cursor/mcp.json pour une configuration commune à tous les projets de l’utilisateur. Une entrée de projet nommée solvethree remplace une entrée globale portant le même nom.

3. 3.

   Ajoutez l’entrée du serveur

   Utilisez la configuration ci-dessous. Si le fichier contient déjà d’autres serveurs, ajoutez solvethree dans son objet mcpServers existant plutôt que de remplacer le fichier.

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

Cette configuration lance solvethree-mcp depuis le téléchargement officiel du SDK à l’aide de npx. Elle hérite de l’environnement de Cursor ; elle ne dépend pas de l’interpolation de variables d’environnement dans le JSON.

Quittez complètement Cursor, puis relancez-le depuis un environnement contenant les deux variables. Exporter des variables dans un terminal ne met pas à jour une interface graphique déjà en cours d’exécution.

Examinez les outils MCP de Cursor et la sortie MCP Logs. Le serveur expose solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt et solvethree_get_task. Appelez d’abord solvethree_capabilities pour examiner les opérations disponibles.

Le serveur ne démarre pas.

Consultez MCP Logs pour connaître l’erreur de démarrage.

Essayez ceci : Si Cursor ne trouve pas npx, rendez-le accessible dans le PATH de Cursor, puis redémarrez Cursor.

Le serveur signale des variables d’environnement manquantes.

Vérifiez l’environnement qui a réellement lancé Cursor, pas seulement votre terminal actuel.

Essayez ceci : Définissez-y les deux variables, quittez complètement Cursor, puis relancez-le.

Cursor utilise une configuration inattendue.

Recherchez une entrée solvethree dans les deux fichiers de configuration.

Essayez ceci : Modifiez ou supprimez l’entrée du projet si vous souhaitiez utiliser l’entrée globale.

Pour l’interface de configuration de Cursor, consultez sa documentation MCP officielle.

1. 1.

   Vérifiez que le profil de site est actif

   Dans Profils de site, configurez le nom d’hôte prévu, l’action de capture et le type de reCAPTCHA. Vérifiez que le profil est actif avant de demander une résolution. Transmettre un nom d’hôte et une action à l’outil ne crée pas de profil. Consultez la configuration d’un profil de site pour connaître le processus de capture.

2. 2.

   Appelez l’outil reCAPTCHA

   Demandez à Cursor d’appeler solvethree_create_recaptcha avec site, action et un requestId unique. site correspond au nom d’hôte, pas à une URL de page. recaptchaType vaut par défaut enterprise-v3 ; waitMs est facultatif. L’outil lit son unique proxy dans SOLVETHREE_PROXY ; n’ajoutez donc pas d’argument de proxy, de type ou d’url.

3. 3.

   Suivez la tâche jusqu’à un statut final

   Si la tâche est au statut pending ou solving, utilisez solvethree_get_task pour la vérifier à nouveau. Seul ready contient une solution utilisable. Si elle est au statut failed, arrêtez l’interrogation et examinez errorCode et error avant de décider quoi modifier.

Conservez le requestId si la création dépasse le délai d’attente. Chaque appel de création génère au plus une tâche, et répéter le même ID de requête avec les mêmes données permet de récupérer la tâche existante. Modifier les données tout en réutilisant cet ID provoque un conflit. Ne générez pas de nouvel ID simplement parce que la première réponse a été perdue.

Le travail du serveur MCP s’arrête lorsque la tâche est prête. Votre application doit soumettre le jeton reCAPTCHA renvoyé à la cible prévue. Utilisez l’identité userAgent et secChUa renvoyée avec le même proxy que celui configuré pour la résolution. Changer de proxy ou utiliser une identité de navigateur sans rapport peut faire échouer la requête.

Si vous utilisez les autres outils, veillez à bien distinguer les types de solutions : Kasada renvoie un objet d’en-têtes à appliquer ensemble, tandis que TMPT renvoie la valeur brute d’un cookie tmpt. Aucun des deux n’est un jeton reCAPTCHA.

Cursor reçoit les données privées de la solution dans la réponse de l’outil. Un résultat ready signifie qu’une solution a été générée — pas que la cible a accepté la requête de votre application. Si la soumission échoue, examinez le jeton ou le cookie envoyé, l’identité et le proxy avant de payer pour une nouvelle résolution.