> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter une Data App à Codex

> Choisissez une Data App fixe dans le catalogue Data Hub, ajoutez-la à Codex avec le prompt d'installation généré et effectuez un vrai appel avec un petit test.

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.

<Note>
  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 <a href="/docs/fr/datahub/quick-start/agent-connection/general" target="_blank" rel="noopener noreferrer">Connexion générale : choisir une application dans l'agent</a>.
</Note>

<Note>
  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.
</Note>

## 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 ».

<Warning>
  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.
</Warning>

## É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.

<Steps>
  <Step title="Ouvrir Octoparse Data Hub et se connecter">
    Rendez-vous sur la <a href="https://www.octoparse.fr/data-hub" target="_blank" rel="noopener noreferrer">Octoparse Data Hub</a> et connectez-vous via l'accès au compte en haut à droite.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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.

<Tip>
  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.
</Tip>

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

<Steps>
  <Step title="Ouvrir la page des clés API">
    Rendez-vous dans le <a href="https://www.octoparse.fr/console/open-platform/api-keys" target="_blank" rel="noopener noreferrer">centre de compte Octoparse</a> et créez une nouvelle clé.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## É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 :

```text theme={null} theme={null}
Utilise l'outil d'enrichissement d'entreprises que tu viens de connecter pour enrichir ces trois leads avec le secteur, l'effectif et le siège : Qonto, Doctolib, Alan.
```

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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é.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="Codex indique que la configuration a réussi, mais aucun outil n'apparaît">
    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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Codex 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 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é.
  </Accordion>

  <Accordion title="Le navigateur retourne des résultats, mais l'appel Codex échoue">
    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.
  </Accordion>

  <Accordion title="Après modification de l'ensemble d'outils, Codex affiche encore les anciens outils">
    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.
  </Accordion>
</AccordionGroup>

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

<CardGroup cols={2}>
  <Card title="Connexion générale" href="/docs/fr/datahub/quick-start/agent-connection/general">
    Ne choisissez pas d'application au préalable. Connectez-vous, puis laissez l'agent chercher et exécuter la bonne capacité de données.
  </Card>

  <Card title="Claude Code : connecter une application spécifique" href="/docs/fr/datahub/quick-start/agent-connection/claude-code">
    Si vous utilisez Claude Code, consultez le flux complet pour une application spécifique dans ce client.
  </Card>
</CardGroup>