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:
UnauthorizedInvalid API keyAuthentication failed401 UnauthorizedMissing 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.
echo $OCTOPARSE_API_KEY
Wenn die Ausgabe leer ist, legen Sie den API-Schlüssel erneut fest, bevor Sie den Server starten.
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.
node --versionnpm --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
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Octoparse Docs","description":"Developer documentation for Octoparse MCP Server and OpenAPI integrations.","colors":{"primary":"#117CFF","light":"#117CFF","dark":"#117CFF"},"logo":{"light":"https://mintcdn.com/octoparse/Gvd6HefaOGSEtZAm/images/logo_octoparse.svg?fit=max\u0026auto=format\u0026n=Gvd6HefaOGSEtZAm\u0026q=85\u0026s=2442bfff45bdc256a531bbb3f0a6e07d","dark":"https://mintcdn.com/octoparse/Gvd6HefaOGSEtZAm/images/logo_octoparse.svg?fit=max\u0026auto=format\u0026n=Gvd6HefaOGSEtZAm\u0026q=85\u0026s=2442bfff45bdc256a531bbb3f0a6e07d","href":"https://www.octoparse.com"},"favicon":"https://mintcdn.com/octoparse/rEXwXcMDf83PhQtP/images/op-logo.svg?fit=max\u0026auto=format\u0026n=rEXwXcMDf83PhQtP\u0026q=85\u0026s=76cbf4eb19a67897dcbdcf6489472101","api":{},"background":{"color":{"dark":"#011229"}},"navbar":{"primary":{"type":"button","label":"Contact support","href":"mailto:support@octoparse.com"}},"seo":{"metatags":{"keywords":"Octoparse Docs, Octoparse MCP Server, Octoparse OpenAPI, web scraping API, MCP web scraping, cloud data extraction","twitter:site":"@Octoparse"},"indexing":"navigable"},"integrations":{"gtm":{"tagId":"GTM-WZ7K2D4"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"en/overview"},{"language":"es","href":"es/overview"},{"language":"fr","href":"fr/overview"},{"language":"de","href":"de/overview"},{"language":"it","href":"it/overview"},{"language":"ko","href":"ko/overview"},{"language":"ja","href":"jp/overview"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"octoparse","hasAudioNarration":false,"actualSubdomain":"octoparse","customDomains":["www.octoparse.com"],"gitSource":{"type":"github","owner":"octoparse","repo":"opdocs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af407c2d3a2c029a3cdb973","clientVersion":"0.0.4149","searchFilterCounts":[{"language":"en","tag":"Data Hub","count":66},{"language":"en","tag":"DATA HUB API","count":66},{"language":"ja","tag":"Data Hub","count":66},{"language":"ja","tag":"DATA HUB API","count":66},{"language":"ko","tag":"API 레퍼런스","count":48},{"language":"en","tag":"Publishing","count":36},{"language":"ja","tag":"公開","count":36},{"language":"en","tag":"Academy","count":35},{"language":"ja","tag":"アカデミー","count":34},{"language":"en","tag":"API Reference","count":30},{"language":"en","tag":"API REFERENCE","count":30},{"language":"ja","tag":"APIリファレンス","count":30},{"language":"ja","tag":"APIドキュメント","count":30},{"language":"de","tag":"API-Referenz","count":24},{"language":"de","tag":"API-REFERENZ","count":24},{"language":"es","tag":"Referencia de la API","count":24},{"language":"es","tag":"REFERENCIA DE API","count":24},{"language":"fr","tag":"Référence API","count":24},{"language":"fr","tag":"RÉFÉRENCE API","count":24},{"language":"it","tag":"Riferimento API","count":24},{"language":"it","tag":"RIFERIMENTO API","count":24},{"language":"en","tag":"GET STARTED","count":18},{"language":"en","tag":"CLI","count":15},{"language":"ja","tag":"CLI","count":15},{"language":"en","tag":"AI Assistant","count":14},{"language":"en","tag":"Desktop","count":14},{"language":"ja","tag":"AIアシスタント","count":14},{"language":"ja","tag":"スクレイパーの仕組み","count":13},{"language":"ja","tag":"はじめに","count":13},{"language":"de","tag":"Aufgabe","count":9},{"language":"es","tag":"Tarea","count":9},{"language":"fr","tag":"Tâche","count":9},{"language":"it","tag":"Attività","count":9},{"language":"ko","tag":"작업","count":9},{"language":"de","tag":"Cloud-Extraktion","count":7},{"language":"es","tag":"Extracción en la nube","count":7},{"language":"fr","tag":"Extraction dans le cloud","count":7},{"language":"it","tag":"Estrazione cloud","count":7},{"language":"ko","tag":"클라우드 추출","count":7},{"language":"de","tag":"Daten","count":5},{"language":"es","tag":"Datos","count":5},{"language":"fr","tag":"Données","count":5},{"language":"it","tag":"Dati","count":5},{"language":"ko","tag":"데이터","count":5},{"language":"de","tag":"Zugriffstoken","count":2},{"language":"es","tag":"Token de acceso","count":2},{"language":"fr","tag":"Jeton d’accès","count":2},{"language":"it","tag":"Token di accesso","count":2},{"language":"ko","tag":"액세스 토큰","count":2},{"language":"de","tag":"Aufgabengruppe","count":1},{"language":"es","tag":"Grupo de tareas","count":1},{"language":"fr","tag":"Groupe de tâches","count":1},{"language":"it","tag":"Gruppo di attività","count":1},{"language":"ko","tag":"작업 그룹","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"de/mcp/troubleshooting","slug":"/de/mcp/troubleshooting","pageMetadata":{"title":"Fehlerbehebung","sidebarTitle":"Fehlerbehebung","description":"Beheben Sie häufige Probleme bei Einrichtung, Authentifizierung, Aufgabenausführung und Export des Octoparse MCP-Servers.","keywords":"Octoparse MCP Fehlerbehebung, MCP Serverfehler, Octoparse API-Schlüssel, MCP Authentifizierung, Fehler bei der Aufgabenausführung","noindex":true,"href":"/de/mcp/troubleshooting"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Beheben Sie häufige Probleme bei Einrichtung, Authentifizierung, Aufgabenausführung und Export des Octoparse MCP-Servers.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Auf dieser Seite erfahren Sie, wie Sie häufige Probleme beim Einrichten oder Verwenden des Octoparse MCP-Servers diagnostizieren.`}),`\n`,_jsx(Heading,{level:`2`,id:`authentifizierungsprobleme`,children:`Authentifizierungsprobleme`}),`\n`,_jsx(Heading,{level:`3`,id:`fehlender-oder-ungültiger-api-schlüssel`,children:`Fehlender oder ungültiger API-Schlüssel`}),`\n`,_jsx(_components.p,{children:`Wenn der MCP-Server keinen gültigen Octoparse-API-Schlüssel findet, wird möglicherweise ein Authentifizierungsfehler angezeigt.`}),`\n`,_jsx(_components.p,{children:`Häufige Symptome:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Unauthorized`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Invalid API key`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Authentication failed`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`401 Unauthorized`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Missing API key`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Prüfen Sie, ob Ihr API-Schlüssel gültig ist und weder gelöscht noch neu generiert wurde.`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`echo`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` $OCTOPARSE_API_KEY`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Wenn die Ausgabe leer ist, legen Sie den API-Schlüssel erneut fest, bevor Sie den Server starten.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` OCTOPARSE_API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"your-api-key\"`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Übertragen Sie API-Schlüssel nicht in Git, Skripte, Screenshots, freigegebene Protokolle oder öffentliche Fehlerberichte.`})}),`\n`,_jsx(Heading,{level:`3`,id:`api-schlüssel-funktioniert-in-einem-terminal-aber-nicht-im-mcp-client`,children:`API-Schlüssel funktioniert in einem Terminal, aber nicht im MCP-Client`}),`\n`,_jsx(_components.p,{children:`Einige MCP-Clients übernehmen Umgebungsvariablen nicht aus Ihrem interaktiven Terminal.`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`Starten Sie den MCP-Client neu, nachdem Sie Umgebungsvariablen aktualisiert haben.`}),`\n`,_jsx(Heading,{level:`2`,id:`probleme-beim-serverstart`,children:`Probleme beim Serverstart`}),`\n`,_jsx(Heading,{level:`3`,id:`mcp-server-startet-nicht`,children:`MCP-Server startet nicht`}),`\n`,_jsx(_components.p,{children:`Wenn der MCP-Server nicht startet, prüfen Sie den Befehl, das Arbeitsverzeichnis, die Node.js-Version und die Umgebungsvariablen.`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`node`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --version`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --version`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Stellen Sie sicher, dass der von Ihrem MCP-Client verwendete Befehl mit dem in Ihrem Terminal funktionierenden Befehl übereinstimmt.`}),`\n`,_jsx(Heading,{level:`3`,id:`befehl-nicht-gefunden`,children:`Befehl nicht gefunden`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsxs(_components.p,{children:[`Ein Befehl kann in Ihrer Shell funktionieren, aber im MCP-Client fehlschlagen, wenn der Client nicht denselben `,_jsx(_components.code,{children:`PATH`}),` verwendet.`]}),`\n`,_jsx(Heading,{level:`2`,id:`probleme-beim-aufgabenzugriff`,children:`Probleme beim Aufgabenzugriff`}),`\n`,_jsx(Heading,{level:`3`,id:`aufgabe-nicht-gefunden`,children:`Aufgabe nicht gefunden`}),`\n`,_jsx(_components.p,{children:`Ein Fehler „Aufgabe nicht gefunden“ kann auftreten, wenn die Aufgaben-ID falsch ist oder das authentifizierte Konto keinen Zugriff auf die Aufgabe hat.`}),`\n`,_jsx(_components.p,{children:`Prüfen Sie Folgendes:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Die Aufgaben-ID wurde korrekt kopiert.`}),`\n`,_jsx(_components.li,{children:`Die Aufgabe gehört zum authentifizierten Octoparse-Konto.`}),`\n`,_jsx(_components.li,{children:`Die Aufgabe wurde nicht gelöscht.`}),`\n`,_jsx(_components.li,{children:`Der API-Schlüssel gehört zum richtigen Arbeitsbereich oder Konto.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`keine-zugänglichen-aufgaben-zurückgegeben`,children:`Keine zugänglichen Aufgaben zurückgegeben`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`2`,id:`probleme-bei-der-aufgabenausführung`,children:`Probleme bei der Aufgabenausführung`}),`\n`,_jsx(Heading,{level:`3`,id:`aufgabe-kann-nicht-gestartet-werden`,children:`Aufgabe kann nicht gestartet werden`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`Prüfen Sie die Aufgabe zuerst in Octoparse und versuchen Sie es anschließend erneut über den MCP-Client.`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`3`,id:`ausführung-startet-aber-es-werden-keine-daten-zurückgegeben`,children:`Ausführung startet, aber es werden keine Daten zurückgegeben`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`Häufige Ursachen:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Die Aufgabe wird noch ausgeführt.`}),`\n`,_jsx(_components.li,{children:`Die ausgewählte Los-ID enthält keine Daten.`}),`\n`,_jsx(_components.li,{children:`Die Aufgabe wurde abgeschlossen, hat aber keine Datensätze gefunden.`}),`\n`,_jsx(_components.li,{children:`Der Export wurde angefordert, bevor der Lauf abgeschlossen war.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`exportprobleme`,children:`Exportprobleme`}),`\n`,_jsx(Heading,{level:`3`,id:`export-schlägt-fehl`,children:`Export schlägt fehl`}),`\n`,_jsx(_components.p,{children:`Wenn der Export fehlschlägt, prüfen Sie, ob die Aufgabe abgeschlossen ist und ob das Exportformat vom verwendeten Tool unterstützt wird.`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`3`,id:`leere-exportdatei`,children:`Leere Exportdatei`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`Prüfen Sie zuerst den Aufgabenverlauf und exportieren Sie dann erneut mit dem richtigen Lauf oder Los.`}),`\n`,_jsx(Heading,{level:`2`,id:`ratenlimits-und-vorübergehende-fehler`,children:`Ratenlimits und vorübergehende Fehler`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(_components.p,{children:`Erfassen Sie bei wiederholten Fehlern:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Name und Version des MCP-Clients`}),`\n`,_jsx(_components.li,{children:`Version des MCP-Servers`}),`\n`,_jsx(_components.li,{children:`Den genauen Tool-Aufruf oder Prompt`}),`\n`,_jsx(_components.li,{children:`Die Aufgaben-ID`}),`\n`,_jsx(_components.li,{children:`Die Fehlermeldung`}),`\n`,_jsx(_components.li,{children:`Ob dieselbe Aufgabe direkt in Octoparse funktioniert`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Entfernen Sie API-Schlüssel, Zugriffstoken, Cookies und personenbezogene Daten, bevor Sie Protokolle weitergeben.`})}),`\n`,_jsx(Heading,{level:`2`,id:`angaben-für-einen-fehlerbericht`,children:`Angaben für einen Fehlerbericht`}),`\n`,_jsx(_components.p,{children:`Geben Sie die folgenden Informationen an:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Name des MCP-Clients`}),`\n`,_jsx(_components.li,{children:`Version des MCP-Servers`}),`\n`,_jsx(_components.li,{children:`Betriebssystem`}),`\n`,_jsx(_components.li,{children:`Node.js-Version`}),`\n`,_jsx(_components.li,{children:`Name des fehlgeschlagenen Tools`}),`\n`,_jsx(_components.li,{children:`Genaue Fehlermeldung`}),`\n`,_jsx(_components.li,{children:`Aufgaben-ID oder ein bereinigtes Beispiel`}),`\n`,_jsx(_components.li,{children:`Ob die Aufgabe außerhalb von MCP in Octoparse funktioniert`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Fehlerbehebung","sidebarTitle":"Fehlerbehebung","description":"Beheben Sie häufige Probleme bei Einrichtung, Authentifizierung, Aufgabenausführung und Export des Octoparse MCP-Servers.","keywords":"Octoparse MCP Fehlerbehebung, MCP Serverfehler, Octoparse API-Schlüssel, MCP Authentifizierung, Fehler bei der Aufgabenausführung","noindex":true,"href":"/de/mcp/troubleshooting"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authentifizierungsprobleme","slug":"authentifizierungsprobleme","depth":2,"children":[{"title":"Fehlender oder ungültiger API-Schlüssel","slug":"fehlender-oder-ungültiger-api-schlüssel","depth":3,"children":[]},{"title":"API-Schlüssel funktioniert in einem Terminal, aber nicht im MCP-Client","slug":"api-schlüssel-funktioniert-in-einem-terminal-aber-nicht-im-mcp-client","depth":3,"children":[]}]},{"title":"Probleme beim Serverstart","slug":"probleme-beim-serverstart","depth":2,"children":[{"title":"MCP-Server startet nicht","slug":"mcp-server-startet-nicht","depth":3,"children":[]},{"title":"Befehl nicht gefunden","slug":"befehl-nicht-gefunden","depth":3,"children":[]}]},{"title":"Probleme beim Aufgabenzugriff","slug":"probleme-beim-aufgabenzugriff","depth":2,"children":[{"title":"Aufgabe nicht gefunden","slug":"aufgabe-nicht-gefunden","depth":3,"children":[]},{"title":"Keine zugänglichen Aufgaben zurückgegeben","slug":"keine-zugänglichen-aufgaben-zurückgegeben","depth":3,"children":[]}]},{"title":"Probleme bei der Aufgabenausführung","slug":"probleme-bei-der-aufgabenausführung","depth":2,"children":[{"title":"Aufgabe kann nicht gestartet werden","slug":"aufgabe-kann-nicht-gestartet-werden","depth":3,"children":[]},{"title":"Ausführung startet, aber es werden keine Daten zurückgegeben","slug":"ausführung-startet-aber-es-werden-keine-daten-zurückgegeben","depth":3,"children":[]}]},{"title":"Exportprobleme","slug":"exportprobleme","depth":2,"children":[{"title":"Export schlägt fehl","slug":"export-schlägt-fehl","depth":3,"children":[]},{"title":"Leere Exportdatei","slug":"leere-exportdatei","depth":3,"children":[]}]},{"title":"Ratenlimits und vorübergehende Fehler","slug":"ratenlimits-und-vorübergehende-fehler","depth":2,"children":[]},{"title":"Angaben für einen Fehlerbericht","slug":"angaben-für-einen-fehlerbericht","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"octoparse","siteName":"Octoparse Docs","title":"Fehlerbehebung - Octoparse Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/mcp/troubleshooting","matchLevel":1},"es":{"href":"/es/mcp/troubleshooting","matchLevel":1,"noindex":true},"fr":{"href":"/fr/mcp/troubleshooting","matchLevel":1,"noindex":true},"de":{"href":"/de/mcp/troubleshooting","matchLevel":0},"it":{"href":"/it/mcp/troubleshooting","matchLevel":1,"noindex":true},"ko":{"href":"/ko/mcp/troubleshooting","matchLevel":1,"noindex":true},"ja":{"href":"/jp/mcp/troubleshooting","matchLevel":1}}},"lastModified":"2026-08-11T08:14:51.901Z","originalFileLocation":"de/mcp/troubleshooting.mdx","locale":"de"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Beheben Sie häufige Probleme bei Einrichtung, Authentifizierung, Aufgabenausführung und Export des Octoparse MCP-Servers.\">\u003cmeta data-mint-head name=\"keywords\" content=\"Octoparse MCP Fehlerbehebung, MCP Serverfehler, Octoparse API-Schlüssel, MCP Authentifizierung, Fehler bei der Aufgabenausführung\">\u003cmeta data-mint-head name=\"application-name\" content=\"Octoparse Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Fehlerbehebung - Octoparse Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Beheben Sie häufige Probleme bei Einrichtung, Authentifizierung, Aufgabenausführung und Export des Octoparse MCP-Servers.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Octoparse Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.octoparse.com/docs/de/mcp/troubleshooting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://octoparse.mintlify.site/docs/_mintlify/api/og/v2?division=ERSTE+SCHRITTE\u0026amp;title=Fehlerbehebung\u0026amp;description=Beheben+Sie+h%C3%A4ufige+Probleme+bei+Einrichtung%2C+Authentifizierung%2C+Aufgabenausf%C3%BChrung+und+Export+des+Octoparse+MCP-Servers.\u0026amp;theme=9934a710d60c4378e24fdaf5\u0026amp;signature=7a5e19a48e8c667243360ad608412012a97e040204c1f53d08e4c659ef0fbcee\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Fehlerbehebung - Octoparse Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Beheben Sie häufige Probleme bei Einrichtung, Authentifizierung, Aufgabenausführung und Export des Octoparse MCP-Servers.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://octoparse.mintlify.site/docs/_mintlify/api/og/v2?division=ERSTE+SCHRITTE\u0026amp;title=Fehlerbehebung\u0026amp;description=Beheben+Sie+h%C3%A4ufige+Probleme+bei+Einrichtung%2C+Authentifizierung%2C+Aufgabenausf%C3%BChrung+und+Export+des+Octoparse+MCP-Servers.\u0026amp;theme=9934a710d60c4378e24fdaf5\u0026amp;signature=7a5e19a48e8c667243360ad608412012a97e040204c1f53d08e4c659ef0fbcee\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/octoparse/YI11v1AlM7NoPqKl/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Octoparse Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#117CFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.octoparse.com/docs/de/mcp/troubleshooting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/de/mcp/troubleshooting.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Octoparse Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Octoparse Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/de/mcp/troubleshooting.md","siteName":"Octoparse Docs","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/en/mcp/troubleshooting"}]},{"language":"es","pages":[{"title":"es","href":"/es/mcp/troubleshooting"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/mcp/troubleshooting"}]},{"language":"de","tabs":[{"tab":"Startseite","pages":[{"title":"Startseite","href":"/de/overview"}]},{"tab":"Akademie","pages":[{"title":"Akademie","href":"/de/academy"}]},{"tab":"KI-Assistent","pages":[{"title":"KI-Assistent","href":"/de/ai-assistant"}]},{"tab":"Vorlagen","pages":[{"title":"Vorlagen","href":"/de/templates/overview"}]},{"tab":"Desktop","pages":[{"title":"Desktop","href":"/de/desktop/how-it-works"}]},{"tab":"Cloud","pages":[{"title":"Cloud","href":"/de/cloud/local-vs-cloud"}]},{"tab":"MCP","groups":[{"group":"ERSTE SCHRITTE","pages":[{"title":"Octoparse MCP Server","href":"/de/mcp"},{"title":"Ratenlimits","href":"/de/mcp/rate-limits"},{"title":"Beispiel-Workflow","description":"Ein vollständiges Beispiel – von der Vorlagensuche bis zum Export der Ergebnisse.","href":"/de/mcp/workflow"},{"title":"Fehlerbehebung","sidebarTitle":"Fehlerbehebung","href":"/de/mcp/troubleshooting"},{"title":"FAQ","description":"Häufige Fragen zu MCP-Tools, zur Aufgabenausführung und zu Kontolimits.","href":"/de/mcp/faq"}]},{"group":"TOOL-REFERENZ","pages":[{"title":"search_templates","href":"/de/mcp/search-templates"},{"title":"execute_task","href":"/de/mcp/execute-task"},{"title":"export_data","href":"/de/mcp/export-data"},{"title":"search_tasks","href":"/de/mcp/search-tasks"},{"title":"start_or_stop_task","href":"/de/mcp/start-or-stop-task"},{"title":"redeem_coupon_code","href":"/de/mcp/redeem-coupon-code"}]}]},{"tab":"API-Referenz","pages":[{"title":"API-Referenz","href":"/de/api-reference"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/de/cli"}]},{"tab":"Data Hub","pages":[{"title":"Data Hub","href":"/de/datahub"}]}]},{"language":"it","pages":[{"title":"it","href":"/it/mcp/troubleshooting"}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/mcp/troubleshooting"}]},{"language":"ja","pages":[{"title":"ja","href":"/jp/mcp/troubleshooting"}]}]},"basePath":"","title":"Fehlerbehebung - Octoparse Docs","buildId":"dpl_D8DZMbLzBJDPJxA2oBvSn4nDSCwT","deploymentId":"dpl_D8DZMbLzBJDPJxA2oBvSn4nDSCwT","dynamics":[],"chunks":[]}