solvethree MCP zu VS Code hinzufügen

Von solvethree4 Min. Lesezeit

Fügen Sie solvethree in .vscode/mcp.json als lokalen stdio-Server hinzu. VS Code startet die ausführbare Datei und stellt den API-Schlüssel Ihres Workspaces und Ihren Proxy bereit. Der Server erstellt Lösungsaufgaben und gibt deren Ergebnisse zurück; er steuert keinen Browser und füllt keine Formulare aus.

Auf dieser Seite

1. Lokale Serverkonfiguration hinzufügen

Erstellen oder aktualisieren Sie .vscode/mcp.json mit der folgenden Konfiguration. Wenn die Datei bereits andere Server oder Eingaben enthält, führen Sie diese Einträge zusammen, statt sie zu ersetzen. VS Code muss npx lokal ausführen können.

VS Code · stdio-Server für den lokalen Test-Harness
{
  "inputs": [
    {
      "type": "promptString",
      "id": "solvethree-key",
      "description": "solvethree workspace API key",
      "password": true
    },
    {
      "type": "promptString",
      "id": "solvethree-proxy",
      "description": "HTTP(S) target proxy URL",
      "password": true
    }
  ],
  "servers": {
    "solvethree": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "${input:solvethree-key}",
        "SOLVETHREE_PROXY": "${input:solvethree-proxy}"
      }
    }
  }
}

Der Befehl führt solvethree-mcp aus dem offiziellen SDK-Download aus. Die beiden Passwortabfragen stellen diesem Prozess SOLVETHREE_API_KEY und SOLVETHREE_PROXY bereit. Geben Sie den API-Schlüssel Ihres Workspaces und die HTTP(S)-Proxy-URL in diesen Abfragen ein, nicht im Chat oder in einer eingecheckten Konfigurationsdatei. Die Proxy-URL darf keinen Pfad, keine Abfrage und kein Fragment enthalten.

Die Konfigurationsstruktur ist in der Referenz zur MCP-Konfiguration von VS Code dokumentiert. Dies ist ein lokaler Prozess, kein gehosteter MCP-Endpunkt.

2. Verfügbare Tools prüfen

Sobald VS Code den Server gestartet hat, bitten Sie den Agenten, solvethree_capabilities aufzurufen, bevor Sie einen Lösungsversuch anfordern. Der Server stellt diese Tools bereit:

  • solvethree_capabilities — Funktionsumfang des Dienstes prüfen.
  • solvethree_create_recaptcha — eine reCAPTCHA-Aufgabe erstellen.
  • solvethree_create_kasada — eine eigenständige Kasada-Aufgabe erstellen; derzeit werden nur HTTPS-Ziele auf www.ticketmaster.com unterstützt.
  • solvethree_create_tmpt — eine Ticketmaster-TMPT-Aufgabe für Event oder Login erstellen.
  • solvethree_get_task — Status und Ergebnis einer Aufgabe abrufen.

Wenn diese Tools nicht verfügbar sind, prüfen Sie zunächst, ob der lokale Prozess startet und beide Umgebungsvariablen erhält. Ein Wechsel der Zielwebsite oder das Erstellen einer weiteren Aufgabe behebt kein Problem beim Serverstart.

3. reCAPTCHA-Lösung anfordern

  1. 1.

    Website-Profil aktivieren

    Richten Sie das Ziel unter Website-Profile mit dem richtigen Hostnamen, der Erfassungsaktion und dem reCAPTCHA-Typ ein. Vor dem Lösen muss Ihrem Workspace ein aktives Profil zur Verfügung stehen. Die Angabe eines Hostnamens und einer Aktion im Tool erstellt keines. Wenn dies ein neues Ziel ist, lesen Sie Website-Profil einrichten.

  2. 2.

    Eine Aufgabe erstellen

    Bitten Sie den Agenten, solvethree_create_recaptcha mit site als Hostnamen, der erforderlichen action und einer eindeutigen requestId für diesen logischen Lösungsversuch zu verwenden. Das Tool akzeptiert außerdem die optionalen Parameter recaptchaType und waitMs; der Typ ist standardmäßig enterprise-v3. Es liest seinen einzigen Proxy aus SOLVETHREE_PROXY. Fügen Sie diesem Tool-Aufruf daher keine Liste von Proxy-Kandidaten, type oder url hinzu.

  3. 3.

    Aufgabe bis zu einem Endstatus verfolgen

    Jeder Erstellungsaufruf erzeugt höchstens eine Aufgabe. Wenn ihr Status pending oder solving ist, rufen Sie sie mit solvethree_get_task erneut 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. Wiederholen Sie keine unveränderten ungültigen Eingaben.

Behalten Sie die requestId bei, wenn beim Erstellen eine Zeitüberschreitung auftritt. Sie muss aus 1–64 ASCII-Buchstaben, Ziffern, Unterstrichen oder Bindestrichen bestehen. Die Wiederholung derselben Aufgabenanfrage mit derselben ID gibt die bestehende Aufgabe zurück; geänderte Eingaben bei Wiederverwendung dieser ID führen zu einem Konflikt. Rufen Sie die bestehende Aufgabe wieder ab, bevor Sie einen neuen logischen Lösungsversuch anfordern.

4. Lösung aus Ihrer Anwendung übermitteln

Übermitteln Sie bei reCAPTCHA solution.token an das vorgesehene Ziel – nicht die Aufgaben-ID. Verwenden Sie die zurückgegebenen Werte für userAgent und secChUa mit demselben Proxy, der beim Lösungsversuch verwendet wurde. Ein Wechsel der IP oder das Beimischen nicht zugehöriger Browser-Header kann dazu führen, dass die Übermittlung fehlschlägt.

Die anderen Tools liefern andere Daten zurück: Kasada gibt ein Header-Objekt zurück, dessen Header gemeinsam anzuwenden sind, während TMPT den unverarbeiteten Wert des tmpt-Cookies zurückgibt. Halten Sie jedes Ergebnis mit seiner zugehörigen Browseridentität, seinem Proxy und seinem Ziel zusammen.

Der MCP-Host erhält private Lösungsdaten, übermittelt sie aber nicht für Sie. Eine Aufgabe mit dem Status ready bedeutet, dass die Lösung erzeugt wurde, nicht, dass die Website die Anfrage Ihrer Anwendung akzeptiert hat. Wenn das Ziel sie ablehnt, prüfen Sie diese ausgehende Anfrage, bevor Sie für einen weiteren Lösungsversuch bezahlen.

Führe deinen ersten Task aus.

Starte mit $5 Workspace-Guthaben.

Workspace erstellen
solvethree MCP zu VS Code hinzufügen · solvethree