> ## Documentation Index > Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Fehlerbehebung > Beheben Sie häufige Probleme bei Einrichtung, Authentifizierung, Aufgabenausführung und Export des Octoparse MCP-Servers. Auf dieser Seite erfahren Sie, wie Sie häufige Probleme beim Einrichten oder Verwenden des Octoparse MCP-Servers diagnostizieren. ## Authentifizierungsprobleme ### Fehlender oder ungültiger API-Schlüssel Wenn der MCP-Server keinen gültigen Octoparse-API-Schlüssel findet, wird möglicherweise ein Authentifizierungsfehler angezeigt. Häufige Symptome: ```text theme={null} Unauthorized Invalid API key Authentication failed 401 Unauthorized Missing API key ``` Prüfen Sie, ob Ihr API-Schlüssel gültig ist und weder gelöscht noch neu generiert wurde. Wenn Sie eine Umgebungsvariable verwenden, stellen Sie sicher, dass sie in derselben Shell oder Laufzeit verfügbar ist, in der der MCP-Server gestartet wird. ```bash theme={null} echo $OCTOPARSE_API_KEY ``` Wenn die Ausgabe leer ist, legen Sie den API-Schlüssel erneut fest, bevor Sie den Server starten. ```bash theme={null} export OCTOPARSE_API_KEY="your-api-key" ``` Übertragen Sie API-Schlüssel nicht in Git, Skripte, Screenshots, freigegebene Protokolle oder öffentliche Fehlerberichte. ### API-Schlüssel funktioniert in einem Terminal, aber nicht im MCP-Client Einige MCP-Clients übernehmen Umgebungsvariablen nicht aus Ihrem interaktiven Terminal. Wenn der MCP-Server beim manuellen Start funktioniert, aber in einem MCP-Client fehlschlägt, prüfen Sie die Client-Konfiguration und stellen Sie sicher, dass der API-Schlüssel an den Serverprozess übergeben wird. Starten Sie den MCP-Client neu, nachdem Sie Umgebungsvariablen aktualisiert haben. ## Probleme beim Serverstart ### MCP-Server startet nicht Wenn der MCP-Server nicht startet, prüfen Sie den Befehl, das Arbeitsverzeichnis, die Node.js-Version und die Umgebungsvariablen. Führen Sie den Serverbefehl zuerst direkt in einem Terminal aus. So können Sie Probleme mit der MCP-Client-Konfiguration von Problemen mit der Serverlaufzeit unterscheiden. ```bash theme={null} node --version npm --version ``` Stellen Sie sicher, dass der von Ihrem MCP-Client verwendete Befehl mit dem in Ihrem Terminal funktionierenden Befehl übereinstimmt. ### Befehl nicht gefunden Wenn der MCP-Client meldet, dass der Serverbefehl nicht gefunden wurde, verwenden Sie einen absoluten Pfad oder prüfen Sie, ob das Paket installiert ist. Ein Befehl kann in Ihrer Shell funktionieren, aber im MCP-Client fehlschlagen, wenn der Client nicht denselben `PATH` verwendet. ## Probleme beim Aufgabenzugriff ### Aufgabe nicht gefunden Ein Fehler „Aufgabe nicht gefunden“ kann auftreten, wenn die Aufgaben-ID falsch ist oder das authentifizierte Konto keinen Zugriff auf die Aufgabe hat. Prüfen Sie Folgendes: * Die Aufgaben-ID wurde korrekt kopiert. * Die Aufgabe gehört zum authentifizierten Octoparse-Konto. * Die Aufgabe wurde nicht gelöscht. * Der API-Schlüssel gehört zum richtigen Arbeitsbereich oder Konto. ### Keine zugänglichen Aufgaben zurückgegeben Wenn die Aufgabensuche keine Ergebnisse zurückgibt, prüfen Sie zuerst den API-Schlüssel und den Kontozugriff. Versuchen Sie anschließend eine allgemeinere Suchanfrage oder listen Sie Aufgaben ohne Schlüsselwortfilter auf. ## Probleme bei der Aufgabenausführung ### Aufgabe kann nicht gestartet werden Eine Aufgabe kann möglicherweise nicht gestartet werden, wenn ihre Definition nicht unterstützt wird, sie bereits läuft oder das Konto keine Berechtigung zur Ausführung hat. Prüfen Sie die Aufgabe zuerst in Octoparse und versuchen Sie es anschließend erneut über den MCP-Client. Wenn die Aufgabe mit einem älteren Workflow erstellt wurde, erstellen oder aktualisieren Sie sie in der aktuellen Octoparse-App, bevor Sie sie automatisiert ausführen. ### Ausführung startet, aber es werden keine Daten zurückgegeben Wenn die Ausführung erfolgreich ist, der Export jedoch keine Daten zurückgibt, prüfen Sie, ob die Aufgabe abgeschlossen ist und ob der ausgewählte Lauf bzw. das ausgewählte Los Daten enthält. Häufige Ursachen: * Die Aufgabe wird noch ausgeführt. * Die ausgewählte Los-ID enthält keine Daten. * Die Aufgabe wurde abgeschlossen, hat aber keine Datensätze gefunden. * Der Export wurde angefordert, bevor der Lauf abgeschlossen war. ## Exportprobleme ### Export schlägt fehl Wenn der Export fehlschlägt, prüfen Sie, ob die Aufgabe abgeschlossen ist und ob das Exportformat vom verwendeten Tool unterstützt wird. Wenn der Exportbefehl oder das Tool eine Los-ID akzeptiert, stellen Sie sicher, dass diese ID zur selben Aufgabe und zum selben Ausführungsverlauf gehört. ### Leere Exportdatei Eine leere Exportdatei bedeutet normalerweise, dass der ausgewählte Lauf keine extrahierten Datensätze enthält oder der Export vor Abschluss der Extraktion angefordert wurde. Prüfen Sie zuerst den Aufgabenverlauf und exportieren Sie dann erneut mit dem richtigen Lauf oder Los. ## Ratenlimits und vorübergehende Fehler Wenn eine Anfrage sporadisch fehlschlägt, versuchen Sie es nach einer kurzen Verzögerung erneut. Netzwerkprobleme, Verzögerungen in der Aufgabenwarteschlange oder vorübergehende Backend-Fehler können vorübergehende Ausfälle verursachen. Erfassen Sie bei wiederholten Fehlern: * Name und Version des MCP-Clients * Version des MCP-Servers * Den genauen Tool-Aufruf oder Prompt * Die Aufgaben-ID * Die Fehlermeldung * Ob dieselbe Aufgabe direkt in Octoparse funktioniert Entfernen Sie API-Schlüssel, Zugriffstoken, Cookies und personenbezogene Daten, bevor Sie Protokolle weitergeben. ## Angaben für einen Fehlerbericht Geben Sie die folgenden Informationen an: * Name des MCP-Clients * Version des MCP-Servers * Betriebssystem * Node.js-Version * Name des fehlgeschlagenen Tools * Genaue Fehlermeldung * Aufgaben-ID oder ein bereinigtes Beispiel * Ob die Aufgabe außerhalb von MCP in Octoparse funktioniert