Skip to main content
Cette page vous aide à diagnostiquer les problèmes courants lors de la configuration ou de l’utilisation du serveur MCP Octoparse.

​
Problèmes d’authentification

​
Clé API absente ou non valide

Une erreur d’authentification peut apparaître si le serveur MCP ne trouve pas de clé API Octoparse valide. Symptômes courants :
Vérifiez que votre clé API est valide et qu’elle n’a pas été supprimée ou régénérée. Si vous utilisez une variable d’environnement, vérifiez qu’elle est disponible dans le shell ou l’environnement d’exécution qui démarre le serveur MCP.
Si la sortie est vide, définissez de nouveau la clé API avant de démarrer le serveur.
Ne publiez jamais de clés API dans Git, des scripts, des captures d’écran, des journaux partagés ou des rapports de problème publics.

​
La clé API fonctionne dans un terminal, mais pas dans le client MCP

Certains clients MCP n’héritent pas des variables d’environnement de votre terminal interactif. Si le serveur MCP fonctionne lorsqu’il est démarré manuellement, mais échoue dans un client MCP, vérifiez la configuration du client et assurez-vous que la clé API est transmise au processus du serveur. Redémarrez le client MCP après avoir mis à jour les variables d’environnement.

​
Problèmes de démarrage du serveur

​
Le serveur MCP ne démarre pas

Si le serveur MCP ne démarre pas, vérifiez la commande, le répertoire de travail, la version de Node.js et les variables d’environnement. Exécutez d’abord la commande du serveur directement dans un terminal. Vous pourrez ainsi distinguer les problèmes de configuration du client MCP des problèmes d’exécution du serveur.
Assurez-vous que la commande utilisée par votre client MCP correspond à celle qui fonctionne dans votre terminal.

​
Commande introuvable

Si le client MCP indique que la commande du serveur est introuvable, utilisez un chemin absolu ou vérifiez que le package est installé. Une commande peut fonctionner dans votre shell, mais échouer dans le client MCP si celui-ci n’utilise pas le même PATH.

​
Problèmes d’accès aux tâches

​
Tâche introuvable

Une erreur signalant une tâche introuvable peut apparaître si l’ID de la tâche est incorrect ou si le compte authentifié n’a pas accès à cette tâche. Vérifiez les points suivants :
  • L’ID de la tâche a été copié correctement.
  • La tâche appartient au compte Octoparse authentifié.
  • La tâche n’a pas été supprimée.
  • La clé API appartient au bon espace de travail ou compte.

​
Aucune tâche accessible renvoyée

Si la recherche ne renvoie aucune tâche, vérifiez d’abord la clé API et les droits d’accès du compte. Essayez ensuite une requête de recherche plus large ou affichez les tâches sans filtre par mot-clé.

​
Problèmes d’exécution des tâches

​
La tâche ne démarre pas

Une tâche peut ne pas démarrer si sa définition n’est pas prise en charge, si elle est déjà en cours d’exécution ou si le compte n’est pas autorisé à l’exécuter. Vérifiez d’abord la tâche dans Octoparse, puis réessayez depuis le client MCP. Si la tâche a été créée avec un ancien Flux de travail, recréez-la ou mettez-la à jour dans la version actuelle de l’application Octoparse avant de l’exécuter par automatisation.

​
L’exécution démarre, mais aucune donnée n’est renvoyée

Si l’exécution réussit, mais que l’export ne renvoie aucune donnée, vérifiez que la tâche est terminée et que l’exécution ou le lot sélectionné contient des données. Causes courantes :
  • La tâche est toujours en cours d’exécution.
  • L’ID de lot sélectionné ne contient aucune donnée.
  • La tâche s’est terminée, mais n’a trouvé aucun enregistrement.
  • L’export a été demandé avant la fin de l’exécution.

​
Problèmes d’export

​
Échec de l’export

Si l’export échoue, vérifiez que la tâche est terminée et que le format d’export est pris en charge par l’outil utilisé. Si la commande ou l’outil d’export accepte un ID de lot, assurez-vous que cet ID appartient à la même tâche et au même historique d’exécution.

​
Fichier d’export vide

Un export vide signifie généralement que l’exécution sélectionnée ne contient aucun enregistrement extrait ou que l’export a été demandé avant la fin de l’extraction. Consultez d’abord l’historique de la tâche, puis relancez l’export avec l’exécution ou le lot approprié.

​
Limites de débit et échecs temporaires

Si une requête échoue par intermittence, réessayez après un court délai. Des problèmes de réseau, des délais dans la file d’attente des tâches ou des erreurs temporaires du service peuvent provoquer ces échecs. En cas d’échecs répétés, relevez les informations suivantes :
  • Nom et version du client MCP
  • Version du serveur MCP
  • Appel d’outil ou prompt exact
  • ID de la tâche
  • Message d’erreur
  • Fonctionnement ou non de la même tâche directement dans Octoparse
Supprimez les clés API, jetons d’accès, cookies et données personnelles avant de partager des journaux.

​
Informations à fournir pour signaler un problème

Incluez les informations suivantes :
  • Nom du client MCP
  • Version du serveur MCP
  • Système d’exploitation
  • Version de Node.js
  • Nom de l’outil ayant échoué
  • Message d’erreur exact
  • ID de la tâche ou exemple anonymisé
  • Fonctionnement ou non de la tâche dans Octoparse en dehors de MCP