Ajouter solvethree MCP à Claude Desktop

Installez Node.js 22 sur la machine qui exécute Claude Desktop. Préparez la clé API de votre espace de travail et une URL de proxy HTTP ou HTTPS. Le serveur MCP utilise un seul proxy fourni via SOLVETHREE_PROXY ; l’outil reCAPTCHA n’accepte pas d’argument de proxy.

Pour reCAPTCHA, créez d’abord un profil actif dans Profils de site. Configurez le nom d’hôte cible, l’action de capture et le type de reCAPTCHA nécessaires. Fournir un nom d’hôte et une action à Claude ne crée pas ce profil. Consultez la configuration des profils de site s’il n’est pas encore actif.

1. 1.

   Ouvrir le fichier de configuration local

   Sur macOS, utilisez ~/Library/Application Support/Claude/claude_desktop_config.json. Sur Windows, utilisez %APPDATA%/Claude/claude_desktop_config.json.

2. 2.

   Ajouter le serveur solvethree

   Utilisez la configuration ci-dessous. Si le fichier contient déjà mcpServers, ajoutez-y l’entrée solvethree plutôt que de remplacer vos autres serveurs. Remplacez les deux valeurs de substitution des variables d’environnement sans les divulguer.

3. 3.

   Redémarrer Claude Desktop

   Redémarrez après l’enregistrement pour que l’hôte lance le serveur avec la nouvelle configuration.

{
  "mcpServers": {
    "solvethree": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "REPLACE_WITH_YOUR_WORKSPACE_KEY",
        "SOLVETHREE_PROXY": "http://USER:PASSWORD@YOUR_PROXY:PORT"
      }
    }
  }
}

Les args téléchargent l’archive officielle du SDK et lancent son exécutable solvethree-mcp comme serveur stdio local. Il n’y a aucun point de terminaison MCP hébergé à saisir.

Commencez par solvethree_capabilities. Utilisez solvethree_get_task pour récupérer une tâche existante. Aucune de ces opérations ne demande la création d’une nouvelle résolution.

• solvethree_create_recaptcha accepte site sous forme de nom d’hôte, action et requestId, ainsi que les paramètres facultatifs recaptchaType et waitMs. Le type par défaut est enterprise-v3 ; v3 est également accepté.
• solvethree_create_kasada crée une tâche Kasada. Kasada en mode autonome prend actuellement en charge les cibles HTTPS sur www.ticketmaster.com, et non des sites web quelconques.
• solvethree_create_tmpt crée une tâche TMPT. Les tâches d’événement utilisent l’URL de l’événement ; les tâches de connexion utilisent l’URL du point d’entrée de connexion.

Autorisez explicitement Claude à créer une seule tâche pour la cible et l’action convenues. Exigez une nouvelle approbation avant qu’il ne lance une autre tâche payante, y compris une tâche de remplacement après un échec ou un rejet par la cible. L’autorisation d’inspecter une tâche ou d’interroger son statut ne doit pas être considérée comme une autorisation d’en créer une autre.

Chaque outil de création exige requestId et crée au plus une tâche. Conservez cet ID avec les paramètres d’origine. Si la création expire, récupérez la tâche en répétant la même requête avec le même ID, ou récupérez-la directement si vous avez déjà son ID de tâche. Une expiration ne prouve pas que la création a échoué. Modifier les paramètres tout en réutilisant l’ID provoque un conflit ; utiliser un nouvel ID peut créer une autre tâche.

Pour pending ou solving, continuez à récupérer la tâche existante. 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 soumettez pas automatiquement les mêmes données invalides.

Claude reçoit les données privées de la solution via l’hôte MCP. Faites utiliser le résultat par votre application pour la cible prévue, avec le proxy ayant permis la résolution et les valeurs userAgent et secChUa renvoyées. N’effectuez pas la résolution via le proxy configuré pour ensuite soumettre la solution depuis une autre IP ou avec une identité de navigateur sans rapport.

Une tâche au statut ready signifie qu’une solution a été générée, pas que le site web a accepté votre requête ultérieure. Si la cible la rejette, examinez le jeton, le cookie ou les en-têtes envoyés, le proxy, l’identité du navigateur et l’URL cible avant d’autoriser une nouvelle résolution.