La connexion générale ne nécessite pas de choisir une application au préalable. Ce tutoriel et les tutoriels « Codex : connecter une application spécifique » et « Claude Code : connecter une application spécifique » sont deux modes d’utilisation différents. La connexion à une application spécifique convient à une capacité claire, fixe et utilisée à long terme. La connexion générale convient aux besoins changeants ou aux cas où l’application n’est pas encore choisie.
Comprendre les deux méthodes de connexion
Les deux méthodes appellent les mêmes Data Apps sur Data Hub. La seule différence est l’endroit où vous choisissez l’application. Vous pouvez conserver les deux types de connexion, mais donnez-leur des noms reconnaissables pour que l’agent ne choisisse pas le mauvais outil.
Ce que vous pourrez faire ensuite
Après ce tutoriel, vous pourrez effectuer les opérations suivantes dans votre agent, dans l’ordre :- Chercher des Data Apps par mot-clé, plateforme ou scénario.
- Consulter l’objectif, les paramètres d’entrée, les champs de sortie et la facturation d’une application.
- Confirmer l’application et les paramètres, puis lancer une exécution.
- Vérifier le statut d’une tâche asynchrone et obtenir le résultat final.
Pour les paramètres complets et les règles de traitement de
search_data_apps, run_data_app, des vérifications de statut asynchrones et du handoff pour les résultats volumineux, consultez Capacités MCP de Data Hub. Cette page se concentre sur la connexion et la première utilisation.Avant de commencer
Préparez les éléments suivants :- Un compte Octoparse auquel vous pouvez vous connecter.
- Un client agent prenant en charge Streamable HTTP MCP, comme Claude Code, Codex ou Cursor.
- Si vous choisissez la méthode par clé API : créez une clé API Octoparse à l’avance.
- Une cible de données simple pour le test, par exemple « trouver une Data App capable d’enrichir des informations d’entreprise ».
Étape 1 : ouvrir la connexion MCP générale
1
Accéder à la Data Hub Open Platform
Connectez-vous au site Octoparse, ouvrez le menu Data Hub en haut, puis cliquez sur Data Hub Open Platform.
2
Ouvrir MCP connection
Dans la navigation de gauche de l’Open Platform, cliquez sur MCP connection pour ouvrir la page Data Hub MCP Server. L’ensemble d’outils par défaut affiché sur la page peut chercher et exécuter n’importe quelle Data App sur Data Hub. Vous n’avez pas besoin de choisir d’abord une application dans le catalogue.
Étape 2 : choisir une méthode d’authentification
La connexion générale prend en charge la clé API et OAuth. Le choix n’affecte que l’authentification. Il ne change pas la façon dont les Data Apps sont cherchées ou exécutées.Option 1 : clé API (recommandée)
Idéale pour une utilisation stable à long terme, les clients en ligne de commande et l’automatisation. La configuration générée par la page contient :Bearer est simplement le format d’en-tête utilisé pour transmettre la clé API. Utilisez une clé API Octoparse, et non un jeton d’accès temporaire issu d’une session de navigateur connectée.
Si vous n’avez pas encore de clé, créez-en une dans le centre de compte Octoparse. Une clé API n’est généralement affichée en entier qu’une seule fois, au moment de sa création. Conservez-la dans un gestionnaire de mots de passe de confiance.
Option 2 : connexion OAuth
Idéale pour les clients interactifs qui prennent en charge MCP OAuth. Lorsque vous choisissez OAuth, la configuration ne contient aucune clé API. Lors de la première connexion, le client ouvre un navigateur où vous vous connectez à Octoparse et confirmez l’autorisation. La session peut expirer, auquel cas vous autorisez à nouveau.Étape 3 : copier le prompt d’installation général
Sur la page MCP connection, choisissez votre client agent et la méthode d’authentification, puis cliquez sur Copy install prompt. Copy MCP URL ne donne que l’adresse du serveur. Copiez le contenu complet que la page génère à cet instant. Ne saisissez pas de mémoire l’adresse du serveur, le périmètre des outils ou les en-têtes.Étape 4 : laisser l’agent terminer la configuration
L’exemple ci-dessous utilise Claude Code. Codex et Cursor placent les boutons différemment, mais les étapes principales sont les mêmes : coller le prompt d’installation, choisir la méthode d’authentification, autoriser les modifications de la configuration MCP de l’utilisateur actuel, puis recharger le client.1
Envoyer le prompt d'installation à l'agent
Démarrez une nouvelle conversation et collez le prompt complet que vous avez copié. L’agent doit demander la méthode d’authentification avant d’écrire la configuration. S’il tente d’écrire des identifiants dans un fichier de projet, arrêtez-le et demandez plutôt la configuration MCP locale de l’utilisateur actuel.
2
Confirmer la méthode d'authentification
Si vous avez choisi la clé API, fournissez la clé de façon sécurisée lorsque l’agent la demande. Si vous avez choisi OAuth, ne fournissez aucune clé et laissez l’agent écrire une configuration sans identifiants.
3
Recharger le client
Après la configuration, rechargez les serveurs MCP ou redémarrez le client. Avec OAuth, la première connexion peut afficher « Authentification requise ». C’est normal.
Étape 5 : terminer l’autorisation OAuth (OAuth uniquement)
Si vous avez choisi la clé API, passez à l’étape suivante.1
Déclencher la connexion dans le client
Dans Claude Code, exécutez
/mcp et sélectionnez le serveur Data Hub que vous venez d’ajouter, nommé octoparse_datahub par défaut. Lorsqu’il indique qu’une authentification est nécessaire, choisissez de vous authentifier. Les autres clients affichent un bouton Connect ou similaire dans leurs paramètres MCP.2
Se connecter et autoriser dans le navigateur
Le navigateur ouvre la page d’identité Octoparse. Vérifiez le domaine et le compte actuel, lisez le périmètre demandé et confirmez. Suivez l’invite de la page pour revenir au client. Certains clients reviennent automatiquement.
3
Confirmer que le serveur est activé
De retour dans le client, vérifiez que l’état « Authentification requise » a disparu et que le serveur est activé. S’il apparaît encore comme non authentifié, rechargez le client et réessayez.
Étape 6 : chercher d’abord, ne pas exécuter tout de suite
La clé de la connexion générale est de laisser l’agent découvrir d’abord les Data Apps. Lors de la première utilisation, demandez-lui explicitement de seulement chercher et comparer, sans créer encore de tâche facturable. Par exemple :search_data_apps pour chercher dans le catalogue, puis get_data_app_details pour lire le contrat complet de chaque candidat.
Le nombre, les noms et la couverture de plateformes des applications trouvées par un agent changent en temps réel avec le catalogue Data Hub. Cette documentation ne fournit pas de liste fixe. Fiez-vous à ce que
search_data_apps retourne réellement.Étape 7 : confirmer l’application, puis exécuter
Choisissez une application parmi les candidates. Demandez à l’agent de reformuler les paramètres et les actions prévues, puis lancez un petit test :1
Vérifier les entrées et le coût
Confirmez les paramètres obligatoires, le périmètre des données, les champs retournés et l’unité de facturation. Si quelque chose n’est pas clair, demandez à l’agent d’appeler à nouveau l’outil de détails plutôt que de deviner les paramètres.
2
Lancer un petit test
Seulement après confirmation, laissez l’agent appeler
run_data_app. Une application synchrone retourne directement les résultats. Une application asynchrone nécessite des vérifications de statut ultérieures.3
Obtenir les résultats asynchrones
Pour les tâches asynchrones, demandez à l’agent d’utiliser les outils de statut et de résultat pour attendre la fin, puis de retourner les données finales. Ne considérez pas « tâche soumise » comme une extraction réussie.
4
Vérifier les résultats
Vérifiez le statut de la tâche, le nombre réel d’enregistrements et les champs clés. Un champ manquant dans un seul enregistrement peut refléter une différence dans les données source. Si la plupart des enregistrements ne correspondent pas aux attentes, changez d’application ou ajustez les paramètres.
FAQ
La connexion générale nécessite-t-elle de choisir d'abord une Data App ?
La connexion générale nécessite-t-elle de choisir d'abord une Data App ?
Non. La connexion générale fournit d’abord les outils de recherche et d’exécution. Après la connexion, l’agent utilise
search_data_apps pour trouver des capacités. Seule la connexion à une application spécifique nécessite de choisir d’abord une application dans le catalogue.Dois-je choisir la clé API ou OAuth ?
Dois-je choisir la clé API ou OAuth ?
Préférez la clé API pour une utilisation à long terme, les clients en ligne de commande et l’automatisation. Choisissez OAuth lorsque vous voulez vous connecter via le navigateur et que votre client prend explicitement en charge MCP OAuth. Les sessions OAuth peuvent expirer et nécessiter une nouvelle autorisation.
La configuration a réussi, mais il n'y a pas d'outil search_data_apps
La configuration a réussi, mais il n'y a pas d'outil search_data_apps
Vérifiez que vous avez utilisé la configuration générale de la page MCP connection de l’Open Platform, et non la configuration restreinte d’une application spécifique. Copiez à nouveau le prompt actuel et rechargez le client.
OAuth continue d'indiquer qu'une authentification est nécessaire
OAuth continue d'indiquer qu'une authentification est nécessaire
Déclenchez la connexion dans les paramètres MCP du client, terminez la connexion et l’autorisation dans le navigateur, puis revenez au client. Vérifiez si le navigateur a bloqué la redirection, et confirmez que la page d’autorisation appartient au service d’identité officiel d’Octoparse.
L'agent a trouvé une application et l'a exécutée immédiatement
L'agent a trouvé une application et l'a exécutée immédiatement
Écrivez explicitement « chercher et comparer seulement, ne pas exécuter pour le moment » dans le prompt. Lorsque des coûts ou de gros volumes de données sont en jeu, demandez à l’agent d’attendre la confirmation avant d’appeler
run_data_app.L'exécution n'a retourné qu'un identifiant de tâche et aucune donnée
L'exécution n'a retourné qu'un identifiant de tâche et aucune donnée
L’application est probablement asynchrone. Demandez à l’agent de continuer à vérifier le statut de la tâche et de récupérer les résultats à la fin. Ne soumettez pas à nouveau la même tâche.
Liste de contrôle
- Vous avez copié le prompt d’installation général depuis la page MCP connection de la Data Hub Open Platform.
- Vous avez choisi soit la clé API, soit OAuth, sans mélanger les deux identifiants.
- L’agent a chargé les outils généraux Data Hub et peut utiliser
search_data_apps. - Vous avez cherché et consulté les détails de l’application avant de confirmer une exécution.
- Vous avez effectué un vrai appel avec le plus petit volume de données et vérifié le résultat final.
Vous savez déjà quelle application utiliser ?
Si votre activité utilise une application fixe à long terme, vous pouvez réduire le périmètre de la connexion :Codex : connecter une application spécifique
Choisissez d’abord une application précise, puis ajoutez-la à Codex comme outil fixe.
Claude Code : connecter une application spécifique
Choisissez d’abord une application précise, puis ajoutez-la à Claude Code comme serveur MCP fixe.
Le nombre réel d’applications, leurs noms, éditeurs et prix retournés par une recherche changent avec le catalogue Data Hub. Fiez-vous à ce que l’outil retourne à chaque appel.