Ihren KI-Agenten über MCP um CAPTCHA-Lösung erweitern

Der offizielle Download von @solvethree/sdk enthält die ausführbare Datei solvethree-mcp. Die folgenden Konfigurationen verwenden npx, um sie über die angegebene Paket-URL auszuführen. Es gibt keinen gehosteten MCP-Endpunkt, den Sie eintragen müssen.

• Stellen Sie npx in der Umgebung bereit, in der Ihr MCP-Host ausgeführt wird.
• Setzen Sie SOLVETHREE_API_KEY in der Host-Umgebung auf Ihren Workspace-API-Schlüssel. Halten Sie ihn aus Browsercode und Prompts heraus.
• Setzen Sie SOLVETHREE_PROXY in dieser Umgebung. Das reCAPTCHA-Tool liest seinen einzelnen Proxy aus dieser Variablen, nicht aus der Tool-Anfrage.

Fügen Sie bei einem Host, der eine MCP-Konfiguration in JSON akzeptiert, diesen Servereintrag hinzu:

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

Verwenden Sie für Codex stattdessen diese TOML-Konfiguration. Ihr Eintrag env_vars reicht die beiden Variablen aus der Host-Umgebung weiter; er legt ihre Werte nicht fest.

[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

Starten Sie den Host oder laden Sie ihn neu, sodass diese Umgebungsvariablen verfügbar sind. Prüfen Sie, ob er solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt und solvethree_get_task bereitstellt.

Bevor Sie einen reCAPTCHA-Task erstellen, richten Sie das Profil der Zielwebsite ein und stellen Sie sicher, dass es für Ihren Workspace aktiv ist. Das Senden eines Hostnamens und einer Aktion über MCP erstellt dieses Profil nicht.

Verwenden Sie solvethree_capabilities, um die verfügbaren Funktionen zu prüfen. Rufen Sie für reCAPTCHA v3 Enterprise solvethree_create_recaptcha mit dieser Anfrage auf:

{
  "site": "accounts.example.com",
  "action": "login",
  "requestId": "agent-login-001",
  "waitMs": 0
}

Ersetzen Sie accounts.example.com durch Ihre Zielwebsite und login durch die Aktion, die Ihre Anwendung benötigt. Wählen Sie eine requestId für diesen logischen Task und bewahren Sie sie zusammen mit der Anfrage auf. Wenn waitMs auf null gesetzt ist, rufen Sie das Ergebnis separat ab, statt in diesem Aufruf auf den Abschluss zu warten.

Jeder MCP-Erstellungsaufruf erfordert eine requestId, obwohl dieses Feld in der zugrunde liegenden Task-API optional ist. Verwenden Sie 1–64 ASCII-Buchstaben, Ziffern, Unterstriche oder Bindestriche.

1. 1.

   Zurückgegebene Task-ID aufbewahren

   Die Task-Erstellung ist noch nicht das Ergebnis. Speichern Sie die Task-ID, damit der Agent denselben Task abrufen kann.

2. 2.

   solvethree_get_task aufrufen

   Verwenden Sie die Task-ID aus dem Erstellungsaufruf. Wenn der Status pending oder solving ist, rufen Sie den Task später erneut ab. Keiner der beiden Status enthält eine verwendbare Lösung.

3. 3.

   Endgültigen Status verarbeiten

   Übergeben Sie bei ready die Lösung an Ihre Browser- oder Anwendungsintegration. Prüfen Sie bei failed die Felder errorCode und error und beenden Sie das Polling für diesen Task.

Übermitteln Sie bei reCAPTCHA solution.token über Ihren Browser oder Ihre Anwendungsanfrage. Setzen Sie deren Header User-Agent und sec-ch-ua anhand der zurückgegebenen Werte userAgent und secChUa und verwenden Sie den in SOLVETHREE_PROXY konfigurierten Proxy erneut. Behalten Sie dieselbe Proxy-Sitzung bei, wenn Ihr Anbieter die Ausgangsverbindungen wechselt.

Kasada gibt Header zurück, Ticketmaster TMPT einen unverarbeiteten Cookie-Wert. Verwenden Sie die Ausgabe für den angeforderten Task; diese Ergebnisse sind nicht austauschbar.

Der MCP-Server steuert keinen Browser und füllt keine Formulare aus. Sein Host erhält private Lösungsdaten, und Ihre Anwendung übernimmt die Übermittlung. Prüfen Sie die Antwort des Ziels separat: Der Status ready bedeutet, dass solvethree eine Lösung generiert hat, nicht, dass das Ziel sie akzeptiert hat.

Ein Verbindungs-Timeout beweist nicht, dass die Task-Erstellung fehlgeschlagen ist. Wenn Sie eine Task-ID erhalten haben, rufen Sie den Task damit ab. Andernfalls wiederholen Sie dieselbe Erstellungsanfrage mit derselben requestId und unveränderten Task-Eingaben, um den bestehenden Task wiederherzustellen. Generieren Sie keine neue ID, nur weil die Antwort verloren gegangen ist.

Die Wiederverwendung einer Anfrage-ID mit anderen Task-Eingaben führt zu einem Konflikt. Wenn der Task selbst fehlgeschlagen ist, lesen Sie seinen Fehler, bevor Sie entscheiden, was Sie ändern; ungültige Eingaben werden durch blindes erneutes Senden nicht korrigiert. Den Unterschied zwischen Anfragefehlern und fehlgeschlagenen Tasks erläutert Fehler der CAPTCHA-API.