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:
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.
Se l’output è vuoto, imposta nuovamente la chiave API prima di avviare il server.
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.
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:
- L’ID attività sia copiato correttamente.
- L’attività appartenga all’account Octoparse autenticato.
- L’attività non sia stata eliminata.
- 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.
- 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
