solvethree MCP zu Codex hinzufügen

1. 1.

   Node.js 22 und npx bereitstellen

   Sie müssen dem Prozess zur Verfügung stehen, der Codex ausführt. Eine Installation in einer separaten Umgebung, auf die Codex nicht zugreifen kann, ermöglicht es nicht, den Server zu starten.

2. 2.

   Host-Umgebungsvariablen setzen

   Setzen Sie SOLVETHREE_API_KEY auf den API-Schlüssel Ihres Workspaces und SOLVETHREE_PROXY auf die Proxy-URL. Starten Sie Codex so, dass diese Variablen verfügbar sind. Stellen Sie bei der IDE-Integration sicher, dass auch der IDE-Prozess sie übernimmt. Halten Sie den API-Schlüssel aus Prompts und der Versionsverwaltung heraus.

3. 3.

   reCAPTCHA-Website-Profil aktivieren

   Fügen Sie unter Website-Profile die HTTPS-Seiten-URL hinzu, wählen Sie den reCAPTCHA-Typ und geben Sie die Erfassungsaktion an. Warten Sie, bis das Profil aktiv ist. Konfigurieren Sie den benötigten Hostnamen, die Erfassungsaktion und den Typ; die Website und die Aktion einer Aufgabe erstellen kein Profil. Wenn dies Ihr erstes Ziel ist, lesen Sie Website-Profil einrichten.

Codex CLI und IDE verwenden gemeinsam ~/.codex/config.toml. Sie können auch die .codex/config.toml eines vertrauenswürdigen Projekts verwenden. Fügen Sie diesen Servereintrag hinzu:

[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

Der Eintrag führt die ausführbare Datei solvethree-mcp des offiziellen SDK über npx aus. env_vars leitet vorhandene Host-Variablen weiter; es weist ihnen keine Werte zu. Für diesen lokalen Server gibt es weder einen gehosteten MCP-Endpunkt, den Sie eingeben müssen, noch eine OAuth-Anmeldung.

startup_timeout_sec lässt 60 Sekunden für den Serverstart zu. tool_timeout_sec lässt 100 Sekunden für einen Tool-Aufruf zu. Keine der beiden Einstellungen bedeutet, dass die Zielwebsite eine Lösung akzeptiert hat.

Führen Sie codex mcp list aus oder öffnen Sie /mcp in der Codex-TUI, um den konfigurierten Server zu prüfen. Falls er nicht startet, prüfen Sie, ob Codex npx findet und beide Umgebungsvariablen geerbt hat.

1. 1.

   Funktionen prüfen

   Lassen Sie Codex solvethree_capabilities aufrufen, bevor es das Tool zum Lösen auswählt. Verwenden Sie für reCAPTCHA solvethree_create_recaptcha.

2. 2.

   reCAPTCHA-Eingaben bereitstellen

   Geben Sie site als Hostnamen sowie action und eine requestId an. Das Tool akzeptiert außerdem optional recaptchaType und waitMs; der Standardtyp ist enterprise-v3. Es liest seinen einzigen Proxy aus SOLVETHREE_PROXY; behandeln Sie dies daher nicht als Proxy-Einstellung pro Aufruf. Fügen Sie der reCAPTCHA-Anfrage keine Felder namens type oder url hinzu.

3. 3.

   Task-ID speichern und Status prüfen

   Jeder Erstellungsaufruf erzeugt höchstens eine Aufgabe. Rufen Sie diese Aufgabe mit solvethree_get_task anhand der zurückgegebenen ID ab. Fragen Sie weiter ab, solange der Status pending oder solving ist. Nur ready enthält eine verwendbare Lösung. Wechselt der Status zu failed, beenden Sie die Abfragen und prüfen Sie errorCode und error, bevor Sie entscheiden, was geändert werden soll.

Der MCP-Server steuert keinen Browser, prüft dessen aktuelle Sitzung nicht und füllt keine Formulare aus. Ihre Anwendung muss das fertige reCAPTCHA-Ergebnis übernehmen und solution.token an das vorgesehene Ziel senden.

Verwenden Sie die zurückgegebene Browseridentität aus userAgent und secChUa mit demselben Proxy, der beim Lösen verwendet wurde. Falls Ihr Browser oder HTTP-Client einen anderen Proxy oder eine nicht zugehörige Browseridentität verwendet, korrigieren Sie dies vor dem Absenden. Das Hinzufügen des MCP-Servers konfiguriert diese Einstellungen nicht für Sie.

Codex erhält private Lösungsdaten über die Tool-Antwort. Halten Sie diese daher aus gemeinsam genutzten Berichten und Protokollen heraus. Eine Aufgabe mit dem Status ready bedeutet, dass eine Lösung erzeugt wurde; prüfen Sie die Antwort des Ziels separat, um festzustellen, ob es die Anfrage Ihrer Anwendung akzeptiert hat.