> ## 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 à Claude Code

> Choisir une Data App fixe, l'ajouter à Claude Code comme serveur MCP via le prompt d'installation généré, puis vérifier un appel réel.

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.

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

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

<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 Claude Code demande explicitement un identifiant.
</Warning>

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

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

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

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.

<Tip>
  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.
</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é API.
  </Step>

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

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

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

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

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

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

```text theme={null} theme={null}
Utilise l'outil Data Hub 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 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.
  </Step>

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

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

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

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

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

## FAQ

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

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

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

<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="Codex : connecter une application spécifique" href="/docs/fr/datahub/quick-start/agent-connection/codex">
    Si vous utilisez Codex, consultez le flux complet pour une application spécifique dans ce client.
  </Card>
</CardGroup>