solvethree MCP zu Claude Desktop hinzufügen

Installieren Sie Node.js 22 auf dem Rechner, auf dem Claude Desktop läuft. Halten Sie den API-Schlüssel Ihres Arbeitsbereichs und eine HTTP- oder HTTPS-Proxy-URL bereit. Der MCP-Server verwendet einen über SOLVETHREE_PROXY bereitgestellten Proxy; das reCAPTCHA-Tool akzeptiert kein Proxy-Argument.

Erstellen Sie für reCAPTCHA zunächst ein aktives Profil unter Website-Profile. Konfigurieren Sie den benötigten Zielhostnamen, die Erfassungsaktion und den reCAPTCHA-Typ. Die Angabe eines Hostnamens und einer Aktion gegenüber Claude erstellt dieses Profil nicht. Siehe Einrichtung eines Website-Profils, falls es noch nicht aktiv ist.

1. 1.

   Lokale Konfigurationsdatei öffnen

   Verwenden Sie unter macOS ~/Library/Application Support/Claude/claude_desktop_config.json. Verwenden Sie unter Windows %APPDATA%/Claude/claude_desktop_config.json.

2. 2.

   solvethree-Server hinzufügen

   Verwenden Sie die folgende Konfiguration. Wenn die Datei bereits mcpServers enthält, fügen Sie darin den Eintrag solvethree hinzu, statt Ihre anderen Server zu ersetzen. Ersetzen Sie beide Umgebungsvariablen-Platzhalter, ohne die Werte offenzulegen.

3. 3.

   Claude Desktop neu starten

   Starten Sie nach dem Speichern neu, damit der Host den Server mit der neuen Konfiguration startet.

{
  "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"
      }
    }
  }
}

Die args laden das offizielle SDK-Archiv herunter und starten dessen ausführbare Datei solvethree-mcp als lokalen stdio-Server. Es gibt keinen gehosteten MCP-Endpunkt, den Sie eintragen müssten.

Beginnen Sie mit solvethree_capabilities. Verwenden Sie solvethree_get_task, um einen vorhandenen Task abzurufen. Keine dieser Operationen fordert die Erstellung einer neuen Lösung an.

• solvethree_create_recaptcha akzeptiert site als Hostnamen, action und requestId sowie optional recaptchaType und waitMs. Der Standardtyp ist enterprise-v3; v3 wird ebenfalls akzeptiert.
• solvethree_create_kasada erstellt einen Kasada-Task. Eigenständiges Kasada unterstützt derzeit HTTPS-Ziele auf www.ticketmaster.com, nicht beliebige Websites.
• solvethree_create_tmpt erstellt einen TMPT-Task. Event-Tasks verwenden die Event-URL; Login-Tasks verwenden die Einstiegs-URL der Anmeldung.

Erteilen Sie Claude ausdrücklich die Erlaubnis, einen Task für das vereinbarte Ziel und die vereinbarte Aktion zu erstellen. Verlangen Sie eine erneute Genehmigung, bevor ein weiterer kostenpflichtiger Task gestartet wird, auch als Ersatz nach einem Fehler oder einer Ablehnung durch das Ziel. Die Erlaubnis, einen Task zu prüfen oder seinen Status abzufragen, darf nicht als Erlaubnis gelten, einen weiteren zu erstellen.

Jedes Erstellungstool benötigt requestId und erstellt höchstens einen Task. Bewahren Sie diese ID zusammen mit den ursprünglichen Eingaben auf. Wenn bei der Erstellung ein Timeout auftritt, rufen Sie den Task wieder ab, indem Sie dieselbe Anfrage mit derselben ID wiederholen, oder rufen Sie ihn direkt ab, wenn Sie seine Task-ID bereits haben. Ein Timeout beweist nicht, dass die Erstellung fehlgeschlagen ist. Geänderte Eingaben bei Wiederverwendung der ID führen zu einem Konflikt; die Verwendung einer neuen ID kann einen weiteren Task erstellen.

Rufen Sie bei pending oder solving weiterhin die bestehende Aufgabe ab. Nur ready enthält eine verwendbare Lösung. Beenden Sie bei failed das Polling und prüfen Sie errorCode und error; fehlgeschlagene Lösungsversuche werden erstattet. Übermitteln Sie dieselben ungültigen Eingaben nicht automatisch erneut.

Claude erhält private Lösungsdaten über den MCP-Host. Lassen Sie Ihre Anwendung das Ergebnis für das vorgesehene Ziel verwenden, mit dem erfolgreichen Proxy sowie den zurückgegebenen Werten für userAgent und secChUa. Lassen Sie die Lösung nicht über den konfigurierten Proxy erzeugen, um sie dann über eine andere IP oder eine nicht zugehörige Browseridentität zu übermitteln.

Eine Aufgabe mit dem Status ready bedeutet, dass eine Lösung erzeugt wurde, nicht, dass die Website Ihre anschließende Anfrage akzeptiert hat. Wenn das Ziel sie ablehnt, prüfen Sie das ausgehende Token, Cookie oder die Header, den Proxy, die Browseridentität und die Ziel-URL, bevor Sie einen weiteren Lösungsversuch autorisieren.