Skip to main content
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 laissez Codex l’utiliser comme outil fixe.
Cette page suit le modèle « choisir d’abord l’application, puis se connecter ». Si vous ne savez pas encore quelle application choisir et que vous voulez connecter d’abord le MCP et laisser l’agent chercher, utilisez plutôt Connexion générale : choisir une application dans l’agent.
Cette page utilise comme exemple une Data App d’enrichissement d’entreprises, qui renvoie le secteur, l’effectif et le siège à partir d’un nom d’entreprise. Si vous choisissez une autre Data App, le nom de la page, les paramètres d’entrée et les champs retournés seront différents, mais la méthode de connexion est la même.

​
Ce que vous pourrez faire ensuite

Après ce tutoriel, vous pourrez décrire un besoin de données directement dans Codex, laisser Codex appeler la Data App sur Data Hub et obtenir des résultats structurés. Vous n’écrivez jamais de configuration MCP à la main.

​
Avant de commencer

Préparez les éléments suivants :
  • Un compte Octoparse auquel vous pouvez vous connecter.
  • Codex installé et connecté.
  • Une cible de test claire et réduite, par exemple « enrichir trois noms d’entreprises avec le secteur, l’effectif et le siège ».
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 Codex demande explicitement un identifiant.

​
Étape 1 : choisir et tester la Data App

Avant de connecter l’agent, vérifiez dans le navigateur que la Data App répond à vos besoins. Si un appel ultérieur échoue, vous pourrez alors rapidement déterminer si le problème vient des paramètres de données ou de la configuration de Codex.
1

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.
2

Trouver la Data App dont vous avez besoin

Utilisez la recherche ou les filtres de catégorie pour trouver l’application cible. Sur la page de détail, lisez d’abord la description de la capacité, les paramètres d’entrée, les champs de sortie et le prix. Ne jugez pas l’adéquation d’après le seul nom de l’application.
3

Exécuter en ligne avec une petite quantité de données

Cliquez sur Try It Now et remplissez les paramètres obligatoires. 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 d’entrée ou passez à une autre Data App. Ne vous précipitez pas pour connecter Codex.

​
Étape 2 : copier le prompt d’installation Codex

Sur la page de détail de la Data App, ouvrez Integration, choisissez MCP et cliquez sur Copy install prompt. Copiez le contenu complet que la page génère. Copy MCP URL ne donne que l’adresse du serveur, ce qui suffit si vous préférez ajouter le serveur à la main. Ne réécrivez pas l’adresse du serveur à la main.
Lorsque vous n’avez besoin que d’une capacité, connectez une seule Data App. Codex choisit plus facilement le bon outil, et le dépannage est plus simple.

​
Étape 3 : créer une clé API Octoparse

1

Ouvrir la page des clés API

Rendez-vous dans le centre de compte Octoparse et créez une nouvelle clé.
2

Conserver temporairement la nouvelle clé

Une clé n’est généralement affichée en entier qu’au moment de sa création. Enregistrez-la dans un gestionnaire de mots de passe de confiance. Après la configuration, ne la conservez pas dans un fichier texte brut.
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 simplement 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 : laisser Codex terminer la connexion

1

Envoyer le prompt d'installation à Codex

Démarrez une nouvelle conversation Codex, collez le prompt d’installation complet que vous avez copié et envoyez-le. Codex lit l’adresse du serveur et les exigences de configuration, puis vous indique ce dont il a besoin ensuite.
2

Fournir la clé API lorsqu'elle est demandée

Fournissez la clé que vous venez de créer uniquement lorsque Codex demande explicitement un identifiant. Vérifiez que Codex modifie la configuration MCP de l’utilisateur actuel, et non un fichier partagé dans le projet.
3

Confirmer le résultat de la configuration

Lorsque Codex a terminé, il vous indique quel fichier de configuration il a écrit et le nom du nouveau serveur. Normalement, il modifie le fichier config.toml au niveau utilisateur et vous invite à recharger MCP ou à redémarrer Codex.
4

Recharger Codex

Rechargez MCP comme Codex le suggère. Si l’interface n’a pas d’option de rechargement, fermez et rouvrez Codex. Poursuivez ensuite avec la vérification ci-dessous.

​
Étape 5 : effectuer le premier vrai appel

Indiquez à Codex en langage naturel ce que vous voulez interroger, avec un périmètre clair. Limitez la quantité lors du premier appel. Par exemple :
1

Confirmer que Codex a appelé la Data App

Observez les appels d’outils dans la conversation. Ce n’est que lorsqu’un appel d’outil Data Hub apparaît que Codex a réellement utilisé la Data App, au lieu de répondre d’après ses propres connaissances.
2

Vérifier les résultats retournés

Vérifiez si le nombre d’enregistrements, les champs et le contenu correspondent au test dans le navigateur. Un champ vide ne signifie pas toujours un échec. Vérifiez d’abord si les données source fournissent ce champ pour l’enregistrement.

​
Optionnel : laisser Codex utiliser plusieurs Data Apps

Créez un ensemble d’outils multi-applications uniquement lorsqu’un flux de travail a réellement besoin de plusieurs capacités de données.
1

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.
2

Choisir les Data Apps nécessaires

Ajoutez uniquement les applications dont le flux actuel a réellement besoin. Certaines pages de détail proposent aussi un lot Related Data Apps.
3

Copier et envoyer le prompt d'installation multi-applications

Enregistrez l’ensemble d’outils, copiez le prompt d’installation généré par la page, envoyez-le à Codex et rechargez MCP lorsque vous y êtes invité.
4

Vérifier les outils un par un

Demandez d’abord à Codex de lister les capacités de données disponibles, puis testez une application à la fois. Une fois toutes validées, laissez plusieurs applications travailler ensemble sur une tâche complexe.

​
FAQ

Rechargez MCP ou redémarrez Codex. Si les outils n’apparaissent toujours pas, demandez à Codex de vérifier que l’adresse du serveur et les en-têtes du fichier config.toml au niveau utilisateur sont complets, et confirmez qu’il lit la même configuration utilisateur.
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.
Écrivez explicitement « utilise l’outil Data Hub que tu viens de connecter » dans la question, et donnez les paramètres pris en charge par l’application. Vous pouvez aussi demander à Codex de lister d’abord les outils disponibles pour confirmer que le serveur est chargé.
Comparez avec les paramètres qui ont fonctionné dans le navigateur. Vérifiez un par un l’adresse du serveur, la clé API, le format des paramètres et les journaux de Codex. 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 avoir enregistré le nouvel ensemble d’outils, copiez à nouveau le prompt d’installation actuel, demandez à Codex de mettre à jour la configuration, puis rechargez MCP. 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 une configuration locale de confiance ou un outil de gestion des identifiants.
  • Codex a rechargé MCP et l’outil Data Hub apparaît.
  • 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.

Claude Code : connecter une application spécifique

Si vous utilisez Claude Code, consultez le flux complet pour une application spécifique dans ce client.