solvethree MCP zu Cursor hinzufügen

1. 1.

   Umgebungsvariablen festlegen

   Setzen Sie SOLVETHREE_API_KEY auf den API-Schlüssel Ihres Workspaces und SOLVETHREE_PROXY auf den Proxy, den Sie für das Lösen und die Übermittlung verwenden werden. Stellen Sie beide dem Prozess zur Verfügung, der Cursor startet. Tragen Sie keine Zugangsdaten im Klartext in eine Projektkonfiguration ein.

2. 2.

   Konfigurationsdatei auswählen

   Verwenden Sie .cursor/mcp.json für die projektspezifische Einrichtung oder ~/.cursor/mcp.json für die benutzerweite Einrichtung. Ein Projekteintrag namens solvethree überschreibt einen globalen Eintrag mit demselben Namen.

3. 3.

   Servereintrag hinzufügen

   Verwenden Sie die folgende Konfiguration. Wenn die Datei bereits andere Server enthält, fügen Sie solvethree in das vorhandene mcpServers-Objekt ein, statt die Datei zu ersetzen.

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

Damit wird solvethree-mcp aus dem offiziellen SDK-Download mit npx gestartet. Die Konfiguration übernimmt die Umgebung von Cursor; sie ist nicht auf die Interpolation von Umgebungsvariablen innerhalb des JSON angewiesen.

Beenden Sie Cursor vollständig und starten Sie es dann aus einer Umgebung neu, die beide Variablen enthält. Das Exportieren von Variablen in einem Terminal aktualisiert keine bereits laufende grafische Anwendung.

Prüfen Sie die MCP-Tools von Cursor und die Ausgabe von MCP Logs. Der Server stellt solvethree_capabilities, solvethree_create_recaptcha, solvethree_create_kasada, solvethree_create_tmpt und solvethree_get_task bereit. Rufen Sie zuerst solvethree_capabilities auf, um die verfügbaren Operationen zu prüfen.

Der Server startet nicht.

Lesen Sie den Startfehler in MCP Logs nach.

Probiere Folgendes: Wenn Cursor npx nicht findet, machen Sie es über den PATH von Cursor verfügbar und starten Sie Cursor neu.

Der Server meldet fehlende Umgebungsvariablen.

Prüfen Sie die Umgebung, aus der Cursor tatsächlich gestartet wurde, nicht nur Ihr aktuelles Terminal.

Probiere Folgendes: Setzen Sie dort beide Variablen, beenden Sie Cursor vollständig und starten Sie es neu.

Cursor verwendet eine unerwartete Konfiguration.

Suchen Sie in beiden Konfigurationsdateien nach einem solvethree-Eintrag.

Probiere Folgendes: Aktualisieren oder entfernen Sie den Projekteintrag, wenn Sie den globalen Eintrag verwenden wollten.

Informationen zur Konfigurationsoberfläche von Cursor finden Sie in der offiziellen MCP-Dokumentation.

1. 1.

   Prüfen, ob das Website-Profil aktiv ist

   Konfigurieren Sie unter Website-Profile den vorgesehenen Hostnamen, die Erfassungsaktion und den reCAPTCHA-Typ. Vergewissern Sie sich, dass das Profil aktiv ist, bevor Sie einen Lösungsversuch anfordern. Die Übergabe eines Hostnamens und einer Aktion an das Tool erstellt kein Profil. Informationen zum Erfassungsprozess finden Sie unter Website-Profil einrichten.

2. 2.

   reCAPTCHA-Tool aufrufen

   Lassen Sie Cursor solvethree_create_recaptcha mit site, action und einer eindeutigen requestId aufrufen. site ist der Hostname, keine Seiten-URL. recaptchaType ist standardmäßig enterprise-v3; waitMs ist optional. Das Tool liest seinen einzigen Proxy aus SOLVETHREE_PROXY. Fügen Sie daher kein Proxy-Argument, type oder url hinzu.

3. 3.

   Aufgabe bis zu einem Endstatus verfolgen

   Wenn die Aufgabe den Status pending oder solving hat, prüfen Sie sie erneut mit solvethree_get_task. Nur ready enthält eine verwendbare Lösung. Beenden Sie bei failed das Polling und prüfen Sie errorCode und error, bevor Sie entscheiden, was Sie ändern.

Behalten Sie die requestId bei, wenn beim Erstellen eine Zeitüberschreitung auftritt. Jeder Erstellungsaufruf erzeugt höchstens eine Aufgabe. Die Wiederholung derselben Anfrage-ID mit denselben Eingaben ruft die bestehende Aufgabe wieder ab. Geänderte Eingaben bei Wiederverwendung dieser ID führen zu einem Konflikt. Erzeugen Sie nicht allein deshalb eine neue ID, weil die erste Antwort verloren gegangen ist.

Mit einer fertigen Aufgabe endet die Arbeit des MCP-Servers. Ihre Anwendung muss das zurückgegebene reCAPTCHA-Token an das vorgesehene Ziel übermitteln. Verwenden Sie die zurückgegebene Identität aus userAgent und secChUa mit demselben Proxy, der für den Lösungsversuch konfiguriert wurde. Ein Proxy-Wechsel oder das Beimischen einer nicht zugehörigen Browseridentität kann dazu führen, dass die Anfrage fehlschlägt.

Achten Sie bei Verwendung der anderen Tools auf den Lösungstyp: Kasada gibt ein Header-Objekt zurück, dessen Header gemeinsam anzuwenden sind, während TMPT einen unverarbeiteten Wert für das tmpt-Cookie zurückgibt. Beides ist kein reCAPTCHA-Token.

Cursor erhält private Lösungsdaten über die Tool-Antwort. Ein Ergebnis mit dem Status ready bedeutet, dass eine Lösung erzeugt wurde – nicht, dass das Ziel die Anfrage Ihrer Anwendung akzeptiert hat. Wenn die Übermittlung fehlschlägt, prüfen Sie das ausgehende Token oder Cookie, die Identität und den Proxy, bevor Sie für einen weiteren Lösungsversuch bezahlen.