> ## 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 le MCP Data Hub à votre agent

> Connecter le MCP Data Hub sans choisir d'application au préalable, puis laisser l'agent chercher et exécuter la bonne capacité à chaque tâche.

Utilisez ce tutoriel si vous ne savez pas encore quelle Data App utiliser, ou si vous voulez que l'agent trouve lui-même une capacité pour chaque tâche. La connexion générale ajoute à votre agent les outils de découverte et d'exécution de Data Hub. Une fois connecté, vous décrivez les données dont vous avez besoin, et l'agent cherche une Data App adaptée, vérifie ses paramètres, puis confirme et l'exécute.

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

## Comprendre les deux méthodes de connexion

| Méthode                                    | Ordre des opérations                                                                                                                        | Idéal pour                                                                                                                                          |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Connexion générale**                     | Connecter le MCP Data Hub → chercher des applications dans l'agent → vérifier les détails → choisir et exécuter                             | Vous ne savez pas quelle application choisir ; chaque tâche peut nécessiter une capacité différente ; vous voulez que l'agent aide à la découverte. |
| **Connexion à une application spécifique** | Choisir une application dans le catalogue → copier le prompt d'installation de cette application → connecter l'agent → exécuter directement | Vous avez une application fixe ; vous voulez un périmètre d'outils réduit ; vous exécutez un processus métier stable et répété.                     |

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 :

1. Chercher des Data Apps par mot-clé, plateforme ou scénario.
2. Consulter l'objectif, les paramètres d'entrée, les champs de sortie et la facturation d'une application.
3. Confirmer l'application et les paramètres, puis lancer une exécution.
4. Vérifier le statut d'une tâche asynchrone et obtenir le résultat final.

<Note>
  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 <a href="/docs/fr/datahub/mcp-capabilities" target="_blank" rel="noopener noreferrer">Capacités MCP de Data Hub</a>. Cette page se concentre sur la connexion et la première utilisation.
</Note>

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

<Warning>
  Une clé API est un identifiant de compte. Ne placez jamais une vraie clé dans un dépôt de code, une configuration partagée, une capture d'écran publique ou une discussion de groupe. En mode OAuth, ne copiez jamais un jeton d'accès temporaire d'une session de navigateur dans une configuration locale.
</Warning>

## Étape 1 : ouvrir la connexion MCP générale

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

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

<Tip>
  La section **Integration** de chaque Data App comporte aussi, en bas, un lien vers la connexion MCP qui mène ici. Ce lien est un raccourci. Il ne signifie pas que vous devez d'abord choisir cette application.
</Tip>

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

```text theme={null} theme={null}
Authorization: Bearer <YOUR_API_KEY>
```

`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 <a href="https://www.octoparse.fr/console/open-platform/api-keys" target="_blank" rel="noopener noreferrer">centre de compte Octoparse</a>. 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.

<Tip>
  L'adresse générale du serveur affichée sur la page est basée sur `https://mcp-v2.octoparse.com`. La configuration exacte et les paramètres des outils peuvent changer, utilisez donc toujours ce que l'Open Platform génère actuellement.
</Tip>

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

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

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

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

## Étape 5 : terminer l'autorisation OAuth (OAuth uniquement)

Si vous avez choisi la clé API, passez à l'étape suivante.

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

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

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

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

```text theme={null} theme={null}
Utilise Data Hub pour chercher des Data Apps liées à « l'enrichissement d'entreprises ».
Liste les 3 résultats les plus pertinents. Pour chacun, décris l'objectif, les entrées requises, les principaux champs de sortie et le modèle de facturation.
N'exécute rien pour le moment. Attends ma confirmation.
```

L'agent appelle généralement `search_data_apps` pour chercher dans le catalogue, puis `get_data_app_details` pour lire le contrat complet de chaque candidat.

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

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

```text theme={null} theme={null}
Choisis la première Data App. Indique-moi d'abord ses paramètres obligatoires, ses valeurs par défaut et son modèle de facturation.
Après ma confirmation, exécute uniquement avec le plus petit volume de données, puis retourne le statut de la tâche, le nombre d'enregistrements et les 5 premiers enregistrements.
```

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

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

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

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

## FAQ

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

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

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

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

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

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

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

<CardGroup cols={2}>
  <Card title="Codex : connecter une application spécifique" href="/docs/fr/datahub/quick-start/agent-connection/codex">
    Choisissez d'abord une application précise, puis ajoutez-la à Codex comme outil fixe.
  </Card>

  <Card title="Claude Code : connecter une application spécifique" href="/docs/fr/datahub/quick-start/agent-connection/claude-code">
    Choisissez d'abord une application précise, puis ajoutez-la à Claude Code comme serveur MCP fixe.
  </Card>
</CardGroup>

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