Ce tutoriel s’adresse aux utilisateurs qui savent déjà quelle Data App utiliser. Vous choisissez et testez d’abord l’application dans le catalogue, puis vous copiez le prompt d’installation de cette application et l’ajoutez à Claude Code comme serveur MCP fixe.
Claude Code et Codex utilisent les mêmes capacités MCP de Data Hub. La différence tient uniquement à la façon dont chaque client stocke sa configuration MCP et affiche l’état du serveur. La Data App elle-même ne change pas.
Ce que vous pourrez faire ensuite
Après ce tutoriel, vous pourrez décrire un besoin de données directement dans Claude Code et lui faire appeler la Data App sur Data Hub pour obtenir des données structurées. Cette page couvre aussi la connexion d’une seule Data App et de plusieurs Data Apps.
Avant de commencer
Préparez les éléments suivants :
- Un compte Octoparse auquel vous pouvez vous connecter.
- Claude Code installé et connecté.
- Une cible de test claire et réduite, par exemple une plateforme cible, un mot-clé et un nombre d’enregistrements.
Une clé API est un identifiant de compte. Ne placez jamais une vraie clé dans des fichiers de projet, des dépôts de code, des captures d’écran publiques ou des discussions de groupe. Fournissez-la uniquement lorsque Claude Code demande explicitement un identifiant.
Étape 1 : choisir et tester la Data App
Vérifiez d’abord les entrées et sorties de l’application dans le navigateur, puis connectez Claude Code. Si un problème survient plus tard, vous pourrez rapidement déterminer si les paramètres sont incorrects ou si le serveur n’est pas correctement configuré.
Ouvrir Octoparse Data Hub et se connecter
Rendez-vous sur la Octoparse Data Hub et connectez-vous via l’accès au compte en haut à droite. Choisir la Data App cible
Utilisez la recherche ou les catégories pour trouver l’application cible. Sur la page de détail, lisez attentivement la description de la capacité, les paramètres obligatoires, les champs retournés et le prix, et confirmez qu’elle convient à la tâche.
Exécuter une fois en ligne
Cliquez sur Try It Now et remplissez les paramètres selon les instructions de la page. Ne demandez qu’une petite quantité de données la première fois. À la fin de l’exécution, vérifiez le statut, le nombre d’enregistrements et les champs clés.
Si l’exécution dans le navigateur ne retourne aucun résultat, ajustez d’abord les paramètres ou passez à une autre Data App. Ne continuez avec Claude Code qu’une fois l’exécution dans le navigateur réussie.
Étape 2 : copier le prompt d’installation Claude Code
Sur la page de détail de la Data App, ouvrez Integration, choisissez MCP et cliquez sur Copy install prompt. Copy MCP URL ne donne que l’adresse du serveur, ce qui suffit si vous préférez exécuter claude mcp add à la main. Vous pouvez aussi y accéder rapidement via le lien MCP de la barre latérale de la page de détail.
Pour une première connexion, choisissez une seule Data App. Moins il y a d’outils, plus Claude Code choisit facilement la bonne capacité, et plus le dépannage est simple.
Étape 3 : créer une clé API Octoparse
Ouvrir la page des clés API
Conserver la clé API en sécurité
Une clé n’est généralement affichée en entier qu’au moment de sa création. Conservez-la temporairement dans un gestionnaire de mots de passe de confiance. Ne l’enregistrez pas dans le répertoire du projet ni dans un document partagé.
La configuration pour une application spécifique générée sur la page de détail de la Data App utilise une clé API. La ligne Authorization: Bearer <API_KEY> de la configuration est le format d’en-tête de la clé API. La connexion générale prend aussi en charge OAuth. Ne mélangez pas les extraits de configuration des deux tutoriels.
Étape 4 : ajouter le serveur dans Claude Code
Envoyer le prompt d'installation à Claude Code
Démarrez une nouvelle session Claude Code, collez le prompt d’installation complet que vous avez copié et envoyez-le. Claude Code lit l’adresse du serveur et les exigences de configuration, et demande la clé API lorsqu’il en a besoin.
Fournir la clé API lorsqu'elle est demandée
Fournissez la clé uniquement lorsque Claude Code la demande explicitement. Vérifiez que l’adresse du serveur provient de la section Integration actuelle de l’application, et n’utilisez pas d’adresse d’origine inconnue.
Confirmer la configuration au niveau utilisateur
Claude Code ajoute normalement le serveur, nommé octoparse_datahub par défaut, avec claude mcp add au niveau utilisateur, pour qu’il soit disponible dans tous les projets. S’il propose plutôt un fichier .mcp.json au niveau projet, demandez le niveau utilisateur afin que la clé ne soit pas commitée avec le projet.
Recharger le serveur
Si les outils n’apparaissent pas immédiatement, exécutez /mcp dans Claude Code pour vérifier l’état du serveur, ou démarrez une nouvelle session. Si le serveur manque toujours, fermez et rouvrez Claude Code.
Étape 5 : effectuer le premier vrai appel
Formulez la demande en langage naturel clair et précis, idéalement avec la plateforme, les filtres et la quantité. Par exemple :
Confirmer que Claude Code a appelé le serveur
Observez les appels d’outils dans la conversation. Ce n’est que lorsqu’un appel d’outil Data Hub apparaît que Claude Code a réellement accédé à la Data App.
Vérifier les résultats de données
Vérifiez si le nombre d’enregistrements, les champs principaux et le contenu répondent aux attentes. Si vous n’obtenez qu’une explication en texte brut, demandez explicitement d’« appeler l’outil Data Hub que tu viens de connecter ».
Optionnel : laisser Claude Code utiliser plusieurs Data Apps
Lorsqu’un flux de travail a réellement besoin de plusieurs capacités, créez un ensemble d’outils personnalisé qui regroupe plusieurs Data Apps dans une seule connexion MCP.
Ouvrir MCP connection dans l'Open Platform
Depuis Data Hub, ouvrez l’Open Platform, cliquez sur MCP connection, puis ouvrez la section des ensembles d’outils personnalisés.
Ajouter les Data Apps nécessaires
Choisissez uniquement les applications dont le flux actuel a réellement besoin. Trop d’outils augmentent le risque que Claude Code choisisse le mauvais.
Copier le prompt d'installation multi-applications
Enregistrez l’ensemble d’outils, puis copiez le prompt d’installation complet que la page génère actuellement.
L'envoyer à Claude Code et recharger
Envoyez le prompt d’installation multi-applications à Claude Code, mettez à jour le serveur comme indiqué et rechargez. Demandez ensuite à Claude Code de lister d’abord les capacités disponibles, puis testez chaque application sélectionnée une à la fois.
FAQ
Le serveur a été ajouté, mais aucun outil n'apparaît
Exécutez /mcp pour vérifier si le serveur est connecté, puis démarrez une nouvelle session ou redémarrez Claude Code. Si les outils n’apparaissent toujours pas, exécutez claude mcp list et comparez l’adresse du serveur et les en-têtes avec le prompt d’installation.
Non autorisé ou clé API invalide
Assurez-vous que la clé n’a pas de caractères manquants, d’espaces ou de sauts de ligne, et qu’elle est toujours valide. Cette page utilise la configuration par clé API générée sur la page de l’application spécifique. Si vous avez besoin d’OAuth, utilisez plutôt la configuration générée sur la page de connexion générale.
Claude Code n'a pas appelé l'outil et a répondu en texte brut
Écrivez explicitement « utilise l’outil Data Hub que tu viens de connecter » dans la demande, et donnez les paramètres pris en charge par l’application. Vous pouvez aussi demander à Claude Code de lister d’abord les outils disponibles pour confirmer que le serveur est chargé.
Le navigateur retourne des résultats, mais l'appel Claude Code échoue
Comparez avec les paramètres qui ont fonctionné dans le navigateur. Vérifiez un par un l’adresse du serveur, la clé API et le format des paramètres, et lisez l’erreur affichée sous /mcp. Gardez un périmètre de requête réduit pour la première vérification afin qu’un délai d’attente ne soit pas confondu avec un échec de connexion.
Après modification de l'ensemble d'outils, Claude Code affiche encore les anciens outils
Après avoir enregistré le nouvel ensemble d’outils, copiez à nouveau le prompt d’installation actuel, demandez à Claude Code de mettre à jour le serveur, puis rechargez. Les clients ne synchronisent pas automatiquement les changements d’ensemble d’outils.
Liste de contrôle
- Vous avez exécuté la Data App avec succès dans le navigateur avec une petite quantité de données.
- Vous avez copié le prompt d’installation depuis la section Integration actuelle de l’application.
- La clé API est stockée uniquement dans la configuration Claude Code au niveau utilisateur ou un outil de gestion des identifiants.
- Le serveur Data Hub apparaît comme connecté sous
/mcp et son outil est visible.
- Vous avez effectué un vrai appel d’outil et vérifié le nombre d’enregistrements et les champs clés.
Connexion générale
Ne choisissez pas d’application au préalable. Connectez-vous, puis laissez l’agent chercher et exécuter la bonne capacité de données.
Codex : connecter une application spécifique
Si vous utilisez Codex, consultez le flux complet pour une application spécifique dans ce client.