Risolvi i problemi comuni di configurazione, autenticazione, esecuzione delle attività ed esportazione del server MCP Octoparse.
Usa questa pagina per diagnosticare i problemi comuni durante la configurazione o l’uso del server MCP Octoparse.
Problemi di autenticazione
Chiave API mancante o non valida
Potresti visualizzare un errore di autenticazione se il server MCP non trova una chiave API Octoparse valida.Sintomi comuni:
UnauthorizedInvalid API keyAuthentication failed401 UnauthorizedMissing API key
Controlla che la chiave API sia valida e non sia stata eliminata o rigenerata.Se usi una variabile di ambiente, verifica che sia disponibile nella stessa shell o nello stesso runtime che avvia il server MCP.
echo $OCTOPARSE_API_KEY
Se l’output è vuoto, imposta nuovamente la chiave API prima di avviare il server.
export OCTOPARSE_API_KEY="your-api-key"
Non sottoporre a commit le chiavi API in Git, script, screenshot, log condivisi o segnalazioni pubbliche di problemi.
La chiave API funziona in un terminale ma non nel client MCP
Alcuni client MCP non ereditano le variabili di ambiente dal terminale interattivo.Se il server MCP funziona quando viene avviato manualmente ma non nel client MCP, controlla la configurazione del client e assicurati che la chiave API venga passata al processo del server.Riavvia il client MCP dopo aver aggiornato le variabili di ambiente.
Problemi di avvio del server
Il server MCP non si avvia
Se il server MCP non si avvia, controlla il comando, la directory di lavoro, la versione di Node.js e le variabili di ambiente.Esegui prima il comando del server direttamente in un terminale. In questo modo puoi distinguere i problemi di configurazione del client MCP da quelli del runtime del server.
node --versionnpm --version
Assicurati che il comando usato dal client MCP corrisponda a quello che funziona nel terminale.
Comando non trovato
Se il client MCP segnala che il comando del server non è stato trovato, usa un percorso assoluto o verifica che il pacchetto sia installato.Un comando può funzionare nella shell ma non nel client MCP se il client non usa lo stesso PATH.
Problemi di accesso alle attività
Attività non trovata
Potresti visualizzare un errore di attività non trovata se l’ID dell’attività non è corretto o se l’account autenticato non dispone dell’accesso all’attività.Controlla che:
La chiave API appartenga all’area di lavoro o all’account corretto.
Non viene restituita alcuna attività accessibile
Se la ricerca delle attività non restituisce risultati, verifica innanzitutto la chiave API e l’accesso all’account. Quindi prova una query di ricerca più ampia o elenca le attività senza un filtro per parola chiave.
Problemi di esecuzione delle attività
L’attività non si avvia
Un’attività potrebbe non avviarsi se la relativa definizione non è supportata, se è già in esecuzione o se l’account non dispone dell’autorizzazione necessaria.Controlla prima l’attività in Octoparse, quindi riprova dal client MCP.Se l’attività è stata creata con un flusso di lavoro precedente, ricreala o aggiornala nell’app Octoparse corrente prima di eseguirla tramite automazione.
L’esecuzione si avvia ma non vengono restituiti dati
Se l’esecuzione riesce ma l’esportazione non restituisce dati, controlla se l’attività è terminata e se l’esecuzione o il lotto selezionato contiene dati.Cause comuni:
L’attività è ancora in esecuzione.
L’ID lotto selezionato non contiene dati.
L’attività è stata completata ma non ha trovato record corrispondenti.
L’esportazione è stata richiesta prima del termine dell’esecuzione.
Problemi di esportazione
Esportazione non riuscita
Se l’esportazione non riesce, verifica che l’attività sia terminata e che il formato di esportazione sia supportato dallo strumento in uso.Se il comando o lo strumento di esportazione accetta un ID lotto, assicurati che questo appartenga alla stessa attività e cronologia di esecuzione.
File di esportazione vuoto
Un’esportazione vuota in genere indica che l’esecuzione selezionata non contiene record estratti o che l’esportazione è stata richiesta prima del termine dell’estrazione.Controlla prima la cronologia dell’attività, quindi esegui nuovamente l’esportazione usando l’esecuzione o il lotto corretto.
Limiti di frequenza ed errori transitori
Se una richiesta non riesce in modo intermittente, riprova dopo un breve intervallo. Problemi di rete, ritardi nella coda delle attività o errori temporanei del backend possono causare errori transitori.In caso di errori ripetuti, acquisisci:
Nome e versione del client MCP
Versione del server MCP
Chiamata allo strumento o prompt esatto
ID attività
Messaggio di errore
Se la stessa attività funziona direttamente in Octoparse
Rimuovi chiavi API, token di accesso, Cookie e dati personali prima di condividere i log.
Informazioni da fornire quando segnali un problema
Includi le seguenti informazioni:
Nome del client MCP
Versione del server MCP
Sistema operativo
Versione di Node.js
Nome dello strumento che non ha funzionato
Messaggio di errore esatto
ID attività o un esempio anonimizzato
Se l’attività funziona in Octoparse al di fuori di MCP
{"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.4167","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":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"it/mcp/troubleshooting","slug":"/it/mcp/troubleshooting","pageMetadata":{"title":"Risoluzione dei problemi","sidebarTitle":"Risoluzione dei problemi","description":"Risolvi i problemi comuni di configurazione, autenticazione, esecuzione delle attività ed esportazione del server MCP Octoparse.","keywords":"risoluzione problemi MCP Octoparse, errori server MCP, chiave API Octoparse, autenticazione MCP, errori esecuzione attività","noindex":true,"href":"/it/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: \"Risolvi i problemi comuni di configurazione, autenticazione, esecuzione delle attività ed esportazione del server MCP Octoparse.\"\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:`Usa questa pagina per diagnosticare i problemi comuni durante la configurazione o l’uso del server MCP Octoparse.`}),`\n`,_jsx(Heading,{level:`2`,id:`problemi-di-autenticazione`,children:`Problemi di autenticazione`}),`\n`,_jsx(Heading,{level:`3`,id:`chiave-api-mancante-o-non-valida`,children:`Chiave API mancante o non valida`}),`\n`,_jsx(_components.p,{children:`Potresti visualizzare un errore di autenticazione se il server MCP non trova una chiave API Octoparse valida.`}),`\n`,_jsx(_components.p,{children:`Sintomi comuni:`}),`\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:`Controlla che la chiave API sia valida e non sia stata eliminata o rigenerata.`}),`\n`,_jsx(_components.p,{children:`Se usi una variabile di ambiente, verifica che sia disponibile nella stessa shell o nello stesso runtime che avvia il server MCP.`}),`\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:`Se l’output è vuoto, imposta nuovamente la chiave API prima di avviare il server.`}),`\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:`Non sottoporre a commit le chiavi API in Git, script, screenshot, log condivisi o segnalazioni pubbliche di problemi.`})}),`\n`,_jsx(Heading,{level:`3`,id:`la-chiave-api-funziona-in-un-terminale-ma-non-nel-client-mcp`,children:`La chiave API funziona in un terminale ma non nel client MCP`}),`\n`,_jsx(_components.p,{children:`Alcuni client MCP non ereditano le variabili di ambiente dal terminale interattivo.`}),`\n`,_jsx(_components.p,{children:`Se il server MCP funziona quando viene avviato manualmente ma non nel client MCP, controlla la configurazione del client e assicurati che la chiave API venga passata al processo del server.`}),`\n`,_jsx(_components.p,{children:`Riavvia il client MCP dopo aver aggiornato le variabili di ambiente.`}),`\n`,_jsx(Heading,{level:`2`,id:`problemi-di-avvio-del-server`,children:`Problemi di avvio del server`}),`\n`,_jsx(Heading,{level:`3`,id:`il-server-mcp-non-si-avvia`,children:`Il server MCP non si avvia`}),`\n`,_jsx(_components.p,{children:`Se il server MCP non si avvia, controlla il comando, la directory di lavoro, la versione di Node.js e le variabili di ambiente.`}),`\n`,_jsx(_components.p,{children:`Esegui prima il comando del server direttamente in un terminale. In questo modo puoi distinguere i problemi di configurazione del client MCP da quelli del runtime del server.`}),`\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:`Assicurati che il comando usato dal client MCP corrisponda a quello che funziona nel terminale.`}),`\n`,_jsx(Heading,{level:`3`,id:`comando-non-trovato`,children:`Comando non trovato`}),`\n`,_jsx(_components.p,{children:`Se il client MCP segnala che il comando del server non è stato trovato, usa un percorso assoluto o verifica che il pacchetto sia installato.`}),`\n`,_jsxs(_components.p,{children:[`Un comando può funzionare nella shell ma non nel client MCP se il client non usa lo stesso `,_jsx(_components.code,{children:`PATH`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`problemi-di-accesso-alle-attività`,children:`Problemi di accesso alle attività`}),`\n`,_jsx(Heading,{level:`3`,id:`attività-non-trovata`,children:`Attività non trovata`}),`\n`,_jsx(_components.p,{children:`Potresti visualizzare un errore di attività non trovata se l’ID dell’attività non è corretto o se l’account autenticato non dispone dell’accesso all’attività.`}),`\n`,_jsx(_components.p,{children:`Controlla che:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`L’ID attività sia copiato correttamente.`}),`\n`,_jsx(_components.li,{children:`L’attività appartenga all’account Octoparse autenticato.`}),`\n`,_jsx(_components.li,{children:`L’attività non sia stata eliminata.`}),`\n`,_jsx(_components.li,{children:`La chiave API appartenga all’area di lavoro o all’account corretto.`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`non-viene-restituita-alcuna-attività-accessibile`,children:`Non viene restituita alcuna attività accessibile`}),`\n`,_jsx(_components.p,{children:`Se la ricerca delle attività non restituisce risultati, verifica innanzitutto la chiave API e l’accesso all’account. Quindi prova una query di ricerca più ampia o elenca le attività senza un filtro per parola chiave.`}),`\n`,_jsx(Heading,{level:`2`,id:`problemi-di-esecuzione-delle-attività`,children:`Problemi di esecuzione delle attività`}),`\n`,_jsx(Heading,{level:`3`,id:`l’attività-non-si-avvia`,children:`L’attività non si avvia`}),`\n`,_jsx(_components.p,{children:`Un’attività potrebbe non avviarsi se la relativa definizione non è supportata, se è già in esecuzione o se l’account non dispone dell’autorizzazione necessaria.`}),`\n`,_jsx(_components.p,{children:`Controlla prima l’attività in Octoparse, quindi riprova dal client MCP.`}),`\n`,_jsx(_components.p,{children:`Se l’attività è stata creata con un flusso di lavoro precedente, ricreala o aggiornala nell’app Octoparse corrente prima di eseguirla tramite automazione.`}),`\n`,_jsx(Heading,{level:`3`,id:`l’esecuzione-si-avvia-ma-non-vengono-restituiti-dati`,children:`L’esecuzione si avvia ma non vengono restituiti dati`}),`\n`,_jsx(_components.p,{children:`Se l’esecuzione riesce ma l’esportazione non restituisce dati, controlla se l’attività è terminata e se l’esecuzione o il lotto selezionato contiene dati.`}),`\n`,_jsx(_components.p,{children:`Cause comuni:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`L’attività è ancora in esecuzione.`}),`\n`,_jsx(_components.li,{children:`L’ID lotto selezionato non contiene dati.`}),`\n`,_jsx(_components.li,{children:`L’attività è stata completata ma non ha trovato record corrispondenti.`}),`\n`,_jsx(_components.li,{children:`L’esportazione è stata richiesta prima del termine dell’esecuzione.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`problemi-di-esportazione`,children:`Problemi di esportazione`}),`\n`,_jsx(Heading,{level:`3`,id:`esportazione-non-riuscita`,children:`Esportazione non riuscita`}),`\n`,_jsx(_components.p,{children:`Se l’esportazione non riesce, verifica che l’attività sia terminata e che il formato di esportazione sia supportato dallo strumento in uso.`}),`\n`,_jsx(_components.p,{children:`Se il comando o lo strumento di esportazione accetta un ID lotto, assicurati che questo appartenga alla stessa attività e cronologia di esecuzione.`}),`\n`,_jsx(Heading,{level:`3`,id:`file-di-esportazione-vuoto`,children:`File di esportazione vuoto`}),`\n`,_jsx(_components.p,{children:`Un’esportazione vuota in genere indica che l’esecuzione selezionata non contiene record estratti o che l’esportazione è stata richiesta prima del termine dell’estrazione.`}),`\n`,_jsx(_components.p,{children:`Controlla prima la cronologia dell’attività, quindi esegui nuovamente l’esportazione usando l’esecuzione o il lotto corretto.`}),`\n`,_jsx(Heading,{level:`2`,id:`limiti-di-frequenza-ed-errori-transitori`,children:`Limiti di frequenza ed errori transitori`}),`\n`,_jsx(_components.p,{children:`Se una richiesta non riesce in modo intermittente, riprova dopo un breve intervallo. Problemi di rete, ritardi nella coda delle attività o errori temporanei del backend possono causare errori transitori.`}),`\n`,_jsx(_components.p,{children:`In caso di errori ripetuti, acquisisci:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Nome e versione del client MCP`}),`\n`,_jsx(_components.li,{children:`Versione del server MCP`}),`\n`,_jsx(_components.li,{children:`Chiamata allo strumento o prompt esatto`}),`\n`,_jsx(_components.li,{children:`ID attività`}),`\n`,_jsx(_components.li,{children:`Messaggio di errore`}),`\n`,_jsx(_components.li,{children:`Se la stessa attività funziona direttamente in Octoparse`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Rimuovi chiavi API, token di accesso, Cookie e dati personali prima di condividere i log.`})}),`\n`,_jsx(Heading,{level:`2`,id:`informazioni-da-fornire-quando-segnali-un-problema`,children:`Informazioni da fornire quando segnali un problema`}),`\n`,_jsx(_components.p,{children:`Includi le seguenti informazioni:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Nome del client MCP`}),`\n`,_jsx(_components.li,{children:`Versione del server MCP`}),`\n`,_jsx(_components.li,{children:`Sistema operativo`}),`\n`,_jsx(_components.li,{children:`Versione di Node.js`}),`\n`,_jsx(_components.li,{children:`Nome dello strumento che non ha funzionato`}),`\n`,_jsx(_components.li,{children:`Messaggio di errore esatto`}),`\n`,_jsx(_components.li,{children:`ID attività o un esempio anonimizzato`}),`\n`,_jsx(_components.li,{children:`Se l’attività funziona in Octoparse al di fuori di MCP`}),`\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":"Risoluzione dei problemi","sidebarTitle":"Risoluzione dei problemi","description":"Risolvi i problemi comuni di configurazione, autenticazione, esecuzione delle attività ed esportazione del server MCP Octoparse.","keywords":"risoluzione problemi MCP Octoparse, errori server MCP, chiave API Octoparse, autenticazione MCP, errori esecuzione attività","noindex":true,"href":"/it/mcp/troubleshooting"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Problemi di autenticazione","slug":"problemi-di-autenticazione","depth":2,"children":[{"title":"Chiave API mancante o non valida","slug":"chiave-api-mancante-o-non-valida","depth":3,"children":[]},{"title":"La chiave API funziona in un terminale ma non nel client MCP","slug":"la-chiave-api-funziona-in-un-terminale-ma-non-nel-client-mcp","depth":3,"children":[]}]},{"title":"Problemi di avvio del server","slug":"problemi-di-avvio-del-server","depth":2,"children":[{"title":"Il server MCP non si avvia","slug":"il-server-mcp-non-si-avvia","depth":3,"children":[]},{"title":"Comando non trovato","slug":"comando-non-trovato","depth":3,"children":[]}]},{"title":"Problemi di accesso alle attività","slug":"problemi-di-accesso-alle-attività","depth":2,"children":[{"title":"Attività non trovata","slug":"attività-non-trovata","depth":3,"children":[]},{"title":"Non viene restituita alcuna attività accessibile","slug":"non-viene-restituita-alcuna-attività-accessibile","depth":3,"children":[]}]},{"title":"Problemi di esecuzione delle attività","slug":"problemi-di-esecuzione-delle-attività","depth":2,"children":[{"title":"L’attività non si avvia","slug":"l’attività-non-si-avvia","depth":3,"children":[]},{"title":"L’esecuzione si avvia ma non vengono restituiti dati","slug":"l’esecuzione-si-avvia-ma-non-vengono-restituiti-dati","depth":3,"children":[]}]},{"title":"Problemi di esportazione","slug":"problemi-di-esportazione","depth":2,"children":[{"title":"Esportazione non riuscita","slug":"esportazione-non-riuscita","depth":3,"children":[]},{"title":"File di esportazione vuoto","slug":"file-di-esportazione-vuoto","depth":3,"children":[]}]},{"title":"Limiti di frequenza ed errori transitori","slug":"limiti-di-frequenza-ed-errori-transitori","depth":2,"children":[]},{"title":"Informazioni da fornire quando segnali un problema","slug":"informazioni-da-fornire-quando-segnali-un-problema","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"octoparse","siteName":"Octoparse Docs","title":"Risoluzione dei problemi - 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":1,"noindex":true},"it":{"href":"/it/mcp/troubleshooting","matchLevel":0},"ko":{"href":"/ko/mcp/troubleshooting","matchLevel":1,"noindex":true},"ja":{"href":"/jp/mcp/troubleshooting","matchLevel":1}}},"lastModified":"2026-08-11T08:14:38.470Z","originalFileLocation":"it/mcp/troubleshooting.mdx","locale":"it"},"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=\"Risolvi i problemi comuni di configurazione, autenticazione, esecuzione delle attività ed esportazione del server MCP Octoparse.\">\u003cmeta data-mint-head name=\"keywords\" content=\"risoluzione problemi MCP Octoparse, errori server MCP, chiave API Octoparse, autenticazione MCP, errori esecuzione attività\">\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=\"Risoluzione dei problemi - Octoparse Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Risolvi i problemi comuni di configurazione, autenticazione, esecuzione delle attività ed esportazione del server MCP Octoparse.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Octoparse Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.octoparse.com/docs/it/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=PER+INIZIARE\u0026amp;title=Risoluzione+dei+problemi\u0026amp;description=Risolvi+i+problemi+comuni+di+configurazione%2C+autenticazione%2C+esecuzione+delle+attivit%C3%A0+ed+esportazione+del+server+MCP+Octoparse.\u0026amp;theme=9934a710d60c4378e24fdaf5\u0026amp;signature=2a90112ab93fae4770e72040f2541faa78f5997dc465f7eacbf835285944bd1e\">\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=\"Risoluzione dei problemi - Octoparse Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Risolvi i problemi comuni di configurazione, autenticazione, esecuzione delle attività ed esportazione del server MCP Octoparse.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://octoparse.mintlify.site/docs/_mintlify/api/og/v2?division=PER+INIZIARE\u0026amp;title=Risoluzione+dei+problemi\u0026amp;description=Risolvi+i+problemi+comuni+di+configurazione%2C+autenticazione%2C+esecuzione+delle+attivit%C3%A0+ed+esportazione+del+server+MCP+Octoparse.\u0026amp;theme=9934a710d60c4378e24fdaf5\u0026amp;signature=2a90112ab93fae4770e72040f2541faa78f5997dc465f7eacbf835285944bd1e\">\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/it/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/it/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/it/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","pages":[{"title":"de","href":"/de/mcp/troubleshooting"}]},{"language":"it","tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/it/overview"}]},{"tab":"Academy","pages":[{"title":"Academy","href":"/it/academy"}]},{"tab":"Assistente AI","pages":[{"title":"Assistente AI","href":"/it/ai-assistant"}]},{"tab":"Modelli","pages":[{"title":"Modelli","href":"/it/templates/overview"}]},{"tab":"Desktop","pages":[{"title":"Desktop","href":"/it/desktop/how-it-works"}]},{"tab":"Cloud","pages":[{"title":"Cloud","href":"/it/cloud/local-vs-cloud"}]},{"tab":"MCP","groups":[{"group":"PER INIZIARE","pages":[{"title":"Server MCP Octoparse","href":"/it/mcp"},{"title":"Limiti di frequenza","href":"/it/mcp/rate-limits"},{"title":"Esempio di flusso di lavoro","description":"Un esempio completo, dalla ricerca di un modello all’esportazione dei risultati.","href":"/it/mcp/workflow"},{"title":"Risoluzione dei problemi","sidebarTitle":"Risoluzione dei problemi","href":"/it/mcp/troubleshooting"},{"title":"FAQ","description":"Domande frequenti sugli strumenti MCP, l'esecuzione delle attività e i limiti dell'account.","href":"/it/mcp/faq"}]},{"group":"RIFERIMENTO DEGLI STRUMENTI","pages":[{"title":"search_templates","href":"/it/mcp/search-templates"},{"title":"execute_task","href":"/it/mcp/execute-task"},{"title":"export_data","href":"/it/mcp/export-data"},{"title":"search_tasks","href":"/it/mcp/search-tasks"},{"title":"start_or_stop_task","href":"/it/mcp/start-or-stop-task"},{"title":"redeem_coupon_code","href":"/it/mcp/redeem-coupon-code"}]}]},{"tab":"Riferimento API","pages":[{"title":"Riferimento API","href":"/it/api-reference"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/it/cli"}]},{"tab":"Data Hub","pages":[{"title":"Data Hub","href":"/it/datahub"}]}]},{"language":"ko","pages":[{"title":"ko","href":"/ko/mcp/troubleshooting"}]},{"language":"ja","pages":[{"title":"ja","href":"/jp/mcp/troubleshooting"}]}]},"basePath":"","title":"Risoluzione dei problemi - Octoparse Docs","buildId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","deploymentId":"dpl_H5KQTnCewfWWvJxA7c3bCm7MFbb6","dynamics":[],"chunks":[]}