Ajouter solvethree MCP à Codex

1. 1.

   Rendez Node.js 22 et npx accessibles

   Ils doivent être accessibles au processus qui exécute Codex. Les installer dans un environnement distinct auquel Codex n’a pas accès ne lui permettra pas de démarrer le serveur.

2. 2.

   Définissez les variables d’environnement de l’hôte

   Définissez SOLVETHREE_API_KEY sur la clé API de votre espace de travail et SOLVETHREE_PROXY sur l’URL du proxy. Démarrez Codex avec ces variables accessibles. Pour l’intégration à l’IDE, assurez-vous que le processus de l’IDE en hérite également. Ne mettez pas la clé API dans les prompts ni dans le contrôle de version.

3. 3.

   Activez le profil de site reCAPTCHA

   Dans Profils de site, ajoutez l’URL HTTPS de la page, sélectionnez le type de reCAPTCHA et fournissez l’action de capture. Attendez que le profil soit actif. Configurez le nom d’hôte, l’action de capture et le type dont vous avez besoin ; le site et l’action d’une tâche ne créent pas de profil. Consultez la configuration d’un profil de site s’il s’agit de votre première cible.

Codex CLI et l’IDE partagent ~/.codex/config.toml. Vous pouvez aussi utiliser le fichier .codex/config.toml d’un projet de confiance. Ajoutez cette entrée de serveur :

[mcp_servers.solvethree]
command = "npx"
args = ["--yes", "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz", "solvethree-mcp"]
env_vars = ["SOLVETHREE_API_KEY", "SOLVETHREE_PROXY"]
startup_timeout_sec = 60
tool_timeout_sec = 100

Cette entrée lance l’exécutable solvethree-mcp du SDK officiel via npx. env_vars transmet les variables existantes de l’hôte ; il ne leur attribue pas de valeurs. Aucun point de terminaison MCP hébergé n’est à saisir et aucune connexion OAuth n’est nécessaire pour ce serveur local.

startup_timeout_sec accorde 60 secondes au démarrage du serveur. tool_timeout_sec accorde 100 secondes à un appel d’outil. Aucun de ces paramètres ne signifie que le site web cible a accepté une solution.

Exécutez codex mcp list, ou ouvrez /mcp dans l’interface TUI de Codex, pour inspecter le serveur configuré. S’il ne démarre pas, vérifiez que Codex trouve npx et a hérité des deux variables d’environnement.

1. 1.

   Examiner les capacités

   Demandez à Codex d’appeler solvethree_capabilities avant de choisir l’outil de résolution. Pour reCAPTCHA, utilisez solvethree_create_recaptcha.

2. 2.

   Fournir les paramètres reCAPTCHA

   Fournissez site comme nom d’hôte, ainsi que action et un requestId. L’outil accepte aussi les paramètres facultatifs recaptchaType et waitMs ; le type par défaut est enterprise-v3. Il lit son unique proxy depuis SOLVETHREE_PROXY : ne considérez donc pas cette variable comme un paramètre de proxy propre à chaque appel. N’ajoutez pas de champs type ou url à la requête reCAPTCHA.

3. 3.

   Conserver l’ID de tâche et vérifier son statut

   Chaque appel de création produit au plus une tâche. Récupérez cette tâche avec solvethree_get_task en utilisant l’ID renvoyé. Continuez les vérifications tant que son statut est pending ou solving. Seul le statut ready contient une solution utilisable. Si le statut devient failed, arrêtez les interrogations et examinez errorCode et error avant de décider quoi modifier.

Le serveur MCP ne pilote pas de navigateur, n’inspecte pas sa session en cours et ne remplit pas de formulaires. Votre application doit récupérer le résultat reCAPTCHA prêt et envoyer solution.token à la cible prévue.

Utilisez l’identité de navigateur renvoyée dans userAgent et secChUa avec le même proxy que celui utilisé pour la résolution. Si votre navigateur ou client HTTP utilise un autre proxy ou une identité de navigateur sans rapport, corrigez cela avant l’envoi. L’ajout du serveur MCP ne configure pas ces paramètres pour vous.

Codex reçoit des données de solution privées dans la réponse de l’outil : ne les incluez donc pas dans les rapports et journaux partagés. Une tâche ready signifie qu’une solution a été générée ; vérifiez séparément la réponse de la cible pour déterminer si elle a accepté la requête de l’application.