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

# Data Hub MCP mit dem Agenten verbinden

> Das Data Hub-MCP verbinden, ohne vorher eine App zu wählen, und den Agenten je Aufgabe die passende Datenfunktion suchen und ausführen lassen.

Nutzen Sie dieses Tutorial, wenn Sie noch nicht wissen, welche Data App Sie verwenden möchten, oder wenn der Agent für jede Aufgabe selbst eine Funktion finden soll. Die allgemeine Verbindung fügt Ihrem Agenten die Data Hub-Tools zum Suchen und Ausführen hinzu. Nach der Verbindung beschreiben Sie die benötigten Daten, und der Agent sucht eine passende Data App, prüft ihre Parameter und führt sie nach Bestätigung aus.

<Note>
  **Die allgemeine Verbindung erfordert keine vorherige App-Auswahl.** Dieses Tutorial und die Tutorials „Codex: eine bestimmte App verbinden“ und „Claude Code: eine bestimmte App verbinden“ sind zwei unterschiedliche Nutzungsmuster. Eine Verbindung zu einer bestimmten App passt zu einer klaren, dauerhaft festen Funktion. Die allgemeine Verbindung passt zu wechselnden Anforderungen oder wenn die App noch nicht gewählt ist.
</Note>

## Die zwei Verbindungsmethoden verstehen

| Methode                                | Reihenfolge der Schritte                                                                             | Am besten für                                                                                                                             |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Allgemeine Verbindung**              | Data Hub-MCP verbinden → im Agenten nach Apps suchen → Details prüfen → auswählen und ausführen      | Sie wissen nicht, welche App Sie wählen sollen; jede Aufgabe braucht eventuell eine andere Funktion; der Agent soll bei der Suche helfen. |
| **Verbindung zu einer bestimmten App** | App im Katalog wählen → Installations-Prompt der App kopieren → Agenten verbinden → direkt ausführen | Sie haben eine feste App; Sie wollen einen kleineren Tool-Umfang; Sie betreiben einen stabilen, wiederkehrenden Geschäftsprozess.         |

Beide Methoden rufen dieselben Data Apps auf Data Hub auf. Der einzige Unterschied ist, wo Sie die App wählen. Sie können beide Verbindungsarten behalten, sollten ihnen aber erkennbare Namen geben, damit der Agent nicht das falsche Tool wählt.

## Was Sie danach tun können

Nach diesem Tutorial können Sie in Ihrem Agenten der Reihe nach:

1. Data Apps nach Stichwort, Plattform oder Szenario suchen.
2. Zweck, Eingabeparameter, Ausgabefelder und Abrechnung einer App prüfen.
3. App und Parameter bestätigen und dann einen Lauf starten.
4. Den Status einer asynchronen Aufgabe prüfen und das Endergebnis abrufen.

<Note>
  Die vollständigen Parameter und Verarbeitungsregeln für `search_data_apps`, `run_data_app`, asynchrone Statusabfragen und das `handoff` für große Ergebnisse finden Sie unter <a href="/docs/de/datahub/mcp-capabilities" target="_blank" rel="noopener noreferrer">Data Hub-MCP-Funktionen</a>. Diese Seite konzentriert sich auf Verbindung und erste Nutzung.
</Note>

## Bevor Sie beginnen

Halten Sie Folgendes bereit:

* Ein Octoparse-Konto, mit dem Sie sich anmelden können.
* Einen Agenten-Client, der Streamable HTTP MCP unterstützt, etwa Claude Code, Codex oder Cursor.
* Falls Sie die API-Schlüssel-Methode wählen: vorab einen Octoparse-API-Schlüssel erstellen.
* Ein einfaches Datenziel zum Testen, etwa „finde eine Data App, die Unternehmensinformationen anreichern kann“.

<Warning>
  Ein API-Schlüssel ist ein Kontozugangsdatum. Legen Sie einen echten Schlüssel nie in ein Code-Repository, eine geteilte Konfiguration, einen öffentlichen Screenshot oder einen Gruppenchat. Kopieren Sie im OAuth-Modus nie ein temporäres Zugriffstoken aus einer Browsersitzung in eine lokale Konfiguration.
</Warning>

## Schritt 1: die allgemeine MCP-Verbindung öffnen

<Steps>
  <Step title="Zur Data Hub Open Platform gehen">
    Melden Sie sich auf der Octoparse-Website an, öffnen Sie oben das Menü Data Hub und klicken Sie auf **Data Hub Open Platform**.
  </Step>

  <Step title="MCP connection öffnen">
    Klicken Sie in der linken Navigation der Open Platform auf **MCP connection**, um die Seite Data Hub MCP Server zu öffnen. Das auf der Seite angezeigte Standard-Toolset kann jede Data App auf Data Hub suchen und ausführen. Sie müssen vorher keine App im Katalog wählen.
  </Step>
</Steps>

<Tip>
  Auch der Abschnitt **Integration** jeder Data App enthält unten einen Link zur MCP-Verbindung, der hierher führt. Dieser Link ist eine Abkürzung. Er bedeutet nicht, dass Sie diese App zuerst wählen müssen.
</Tip>

## Schritt 2: eine Authentifizierungsmethode wählen

Die allgemeine Verbindung unterstützt sowohl API-Schlüssel als auch OAuth. Die Wahl betrifft nur die Authentifizierung. Sie ändert nicht, wie Data Apps gesucht oder ausgeführt werden.

### Option 1: API-Schlüssel (empfohlen)

Ideal für dauerhafte, stabile Nutzung, Kommandozeilen-Clients und Automatisierung. Die von der Seite erzeugte Konfiguration enthält:

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

`Bearer` ist lediglich das Header-Format, in dem der API-Schlüssel übergeben wird. Verwenden Sie einen Octoparse-API-Schlüssel, kein temporäres Zugriffstoken aus einer angemeldeten Browsersitzung.

Wenn Sie noch keinen Schlüssel haben, erstellen Sie einen im <a href="https://www.octoparse.de/console/open-platform/api-keys" target="_blank" rel="noopener noreferrer">Octoparse-Kontocenter</a>. Ein API-Schlüssel wird meist nur einmal vollständig angezeigt, nämlich bei der Erstellung. Speichern Sie ihn in einem vertrauenswürdigen Passwortmanager.

### Option 2: Anmeldung per OAuth

Ideal für interaktive Clients, die MCP OAuth unterstützen. Wenn Sie OAuth wählen, enthält die Konfiguration keinen API-Schlüssel. Beim ersten Verbinden öffnet der Client einen Browser, in dem Sie sich bei Octoparse anmelden und die Autorisierung bestätigen. Die Sitzung kann ablaufen, dann autorisieren Sie erneut.

## Schritt 3: den allgemeinen Installations-Prompt kopieren

Wählen Sie auf der Seite **MCP connection** Ihren Agenten-Client und die Authentifizierungsmethode und klicken Sie dann auf **Copy install prompt**. **Copy MCP URL** liefert nur die Serveradresse. Kopieren Sie den vollständigen Inhalt, den die Seite gerade erzeugt. Tippen Sie Serveradresse, Tool-Umfang oder Header nicht aus dem Gedächtnis.

<Tip>
  Die auf der Seite angezeigte allgemeine Serveradresse basiert auf `https://mcp-v2.octoparse.com`. Die genaue Konfiguration und die Tool-Parameter können sich ändern, verwenden Sie daher immer das, was die Open Platform aktuell erzeugt.
</Tip>

## Schritt 4: den Agenten die Konfiguration abschließen lassen

Das folgende Beispiel verwendet Claude Code. Codex und Cursor platzieren die Schaltflächen anders, aber die Kernschritte sind gleich: Installations-Prompt einfügen, Authentifizierungsmethode wählen, Änderungen an der MCP-Konfiguration des aktuellen Benutzers erlauben, dann den Client neu laden.

<Steps>
  <Step title="Den Installations-Prompt an den Agenten senden">
    Starten Sie eine neue Unterhaltung und fügen Sie den vollständigen kopierten Prompt ein. Der Agent sollte vor dem Schreiben der Konfiguration nach der Authentifizierungsmethode fragen. Wenn er versucht, Zugangsdaten in eine Projektdatei zu schreiben, stoppen Sie ihn und verlangen Sie stattdessen die lokale MCP-Konfiguration des aktuellen Benutzers.
  </Step>

  <Step title="Die Authentifizierungsmethode bestätigen">
    Wenn Sie den API-Schlüssel gewählt haben, geben Sie ihn sicher an, sobald der Agent fragt. Wenn Sie OAuth gewählt haben, geben Sie keinen Schlüssel an und lassen Sie den Agenten eine Konfiguration ohne Zugangsdaten schreiben.
  </Step>

  <Step title="Den Client neu laden">
    Laden Sie nach der Konfiguration die MCP-Server neu oder starten Sie den Client neu. Bei OAuth kann die erste Verbindung „Authentifizierung erforderlich“ anzeigen. Das ist erwartet.
  </Step>
</Steps>

## Schritt 5: die OAuth-Autorisierung abschließen (nur OAuth)

Wenn Sie den API-Schlüssel gewählt haben, springen Sie zum nächsten Schritt.

<Steps>
  <Step title="Die Verbindung im Client auslösen">
    Führen Sie in Claude Code `/mcp` aus und wählen Sie den gerade hinzugefügten Data Hub-Server, standardmäßig `octoparse_datahub` genannt. Wenn angezeigt wird, dass eine Authentifizierung nötig ist, wählen Sie die Authentifizierung. Andere Clients zeigen in ihren MCP-Einstellungen eine Schaltfläche **Connect** oder ähnlich.
  </Step>

  <Step title="Im Browser anmelden und autorisieren">
    Der Browser öffnet die Identitätsseite von Octoparse. Prüfen Sie Domain und aktuelles Konto, lesen Sie den angeforderten Umfang und bestätigen Sie. Folgen Sie der Aufforderung auf der Seite, um zum Client zurückzukehren. Manche Clients kehren automatisch zurück.
  </Step>

  <Step title="Bestätigen, dass der Server aktiviert ist">
    Prüfen Sie zurück im Client, dass der Zustand „Authentifizierung erforderlich“ verschwunden ist und der Server aktiviert ist. Wenn er weiterhin als nicht authentifiziert angezeigt wird, laden Sie den Client neu und versuchen Sie es erneut.
  </Step>
</Steps>

## Schritt 6: zuerst suchen, noch nicht ausführen

Der Kern der allgemeinen Verbindung ist, dass der Agent zuerst Data Apps entdeckt. Bitten Sie ihn bei der ersten Nutzung ausdrücklich, nur zu suchen und zu vergleichen und noch keine kostenpflichtige Aufgabe anzulegen. Zum Beispiel:

```text theme={null} theme={null}
Suche in Data Hub nach Data Apps zum Thema „Unternehmensanreicherung“.
Liste die 3 relevantesten Ergebnisse auf. Beschreibe für jedes den Zweck, die benötigten Eingaben, die wichtigsten Ausgabefelder und das Abrechnungsmodell.
Führe noch nichts aus. Warte auf meine Bestätigung.
```

Der Agent ruft meist `search_data_apps` auf, um den Katalog zu durchsuchen, und dann `get_data_app_details`, um den vollständigen Vertrag jedes Kandidaten zu lesen.

<Note>
  Anzahl, Namen und Plattformabdeckung der Apps, die ein Agent findet, ändern sich in Echtzeit mit dem Data Hub-Katalog. Diese Dokumentation liefert keine feste Liste. Verlassen Sie sich auf das, was `search_data_apps` tatsächlich zurückgibt.
</Note>

## Schritt 7: die App bestätigen, dann ausführen

Wählen Sie eine App aus den Kandidaten. Lassen Sie den Agenten die Parameter und geplanten Aktionen wiedergeben und dann einen kleinen Test ausführen:

```text theme={null} theme={null}
Wähle die erste Data App. Nenne mir zuerst ihre Pflichtparameter, Standardwerte und das Abrechnungsmodell.
Nach meiner Bestätigung führe nur mit der kleinsten Datenmenge aus und gib den Aufgabenstatus, die Anzahl der Datensätze und die ersten 5 Datensätze zurück.
```

<Steps>
  <Step title="Eingaben und Kosten prüfen">
    Bestätigen Sie Pflichtparameter, Datenumfang, zurückgegebene Felder und Abrechnungseinheit. Wenn etwas unklar ist, lassen Sie den Agenten das Detail-Tool erneut aufrufen, statt Parameter zu raten.
  </Step>

  <Step title="Einen kleinen Test ausführen">
    Erst nach der Bestätigung lassen Sie den Agenten `run_data_app` aufrufen. Eine synchrone App liefert Ergebnisse direkt. Eine asynchrone App braucht anschließende Statusabfragen.
  </Step>

  <Step title="Asynchrone Ergebnisse abrufen">
    Lassen Sie den Agenten bei asynchronen Aufgaben mit den Status- und Ergebnis-Tools auf den Abschluss warten und dann die endgültigen Daten zurückgeben. Behandeln Sie „Aufgabe eingereicht“ nicht als erfolgreiche Extraktion.
  </Step>

  <Step title="Die Ergebnisse prüfen">
    Prüfen Sie Aufgabenstatus, tatsächliche Anzahl der Datensätze und Schlüsselfelder. Ein fehlendes Feld in einem einzelnen Datensatz kann an Unterschieden in den Quelldaten liegen. Wenn die meisten Datensätze nicht den Erwartungen entsprechen, wechseln Sie die App oder passen Sie die Parameter an.
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="Erfordert die allgemeine Verbindung, zuerst eine Data App zu wählen?">
    Nein. Die allgemeine Verbindung stellt zuerst die Such- und Ausführungs-Tools bereit. Nach der Verbindung nutzt der Agent `search_data_apps`, um Funktionen zu finden. Nur die Verbindung zu einer bestimmten App erfordert, zuerst eine App im Katalog zu wählen.
  </Accordion>

  <Accordion title="Soll ich API-Schlüssel oder OAuth wählen?">
    Bevorzugen Sie den API-Schlüssel für dauerhafte Nutzung, Kommandozeilen-Clients und Automatisierung. Wählen Sie OAuth, wenn Sie sich über den Browser anmelden möchten und Ihr Client MCP OAuth ausdrücklich unterstützt. OAuth-Sitzungen können ablaufen und eine erneute Autorisierung erfordern.
  </Accordion>

  <Accordion title="Die Konfiguration war erfolgreich, aber es gibt kein Tool search_data_apps">
    Prüfen Sie, dass Sie die allgemeine Konfiguration von der Seite **MCP connection** der Open Platform verwendet haben, nicht die eingeschränkte Konfiguration einer bestimmten App. Kopieren Sie den aktuellen Prompt erneut und laden Sie den Client neu.
  </Accordion>

  <Accordion title="OAuth zeigt weiterhin an, dass eine Authentifizierung nötig ist">
    Lösen Sie die Verbindung in den MCP-Einstellungen des Clients aus, schließen Sie Anmeldung und Autorisierung im Browser ab und kehren Sie zum Client zurück. Prüfen Sie, ob der Browser die Weiterleitung blockiert hat, und stellen Sie sicher, dass die Autorisierungsseite zum offiziellen Identitätsdienst von Octoparse gehört.
  </Accordion>

  <Accordion title="Der Agent hat eine App gefunden und sofort ausgeführt">
    Schreiben Sie „nur suchen und vergleichen, noch nicht ausführen“ ausdrücklich in den Prompt. Wenn Kosten oder große Datenmengen im Spiel sind, bitten Sie den Agenten, vor dem Aufruf von `run_data_app` auf die Bestätigung zu warten.
  </Accordion>

  <Accordion title="Der Lauf hat nur eine Aufgaben-ID und keine Daten geliefert">
    Die App ist wahrscheinlich asynchron. Lassen Sie den Agenten den Aufgabenstatus weiter prüfen und die Ergebnisse nach Abschluss abrufen. Reichen Sie dieselbe Aufgabe nicht erneut ein.
  </Accordion>
</AccordionGroup>

## Checkliste

* Sie haben den allgemeinen Installations-Prompt von der Seite **MCP connection** der Data Hub Open Platform kopiert.
* Sie haben entweder API-Schlüssel oder OAuth gewählt und die beiden Zugangsdaten nicht vermischt.
* Der Agent hat die allgemeinen Data Hub-Tools geladen und kann `search_data_apps` verwenden.
* Sie haben gesucht und App-Details geprüft, bevor Sie einen Lauf bestätigt haben.
* Sie haben einen echten Aufruf mit der kleinsten Datenmenge abgeschlossen und das Endergebnis geprüft.

## Sie wissen schon, welche App Sie nutzen wollen?

Wenn Ihr Geschäft dauerhaft eine feste App nutzt, können Sie den Verbindungsumfang einschränken:

<CardGroup cols={2}>
  <Card title="Codex: eine bestimmte App verbinden" href="/docs/de/datahub/quick-start/agent-connection/codex">
    Zuerst eine bestimmte App wählen, dann als festes Tool in Codex hinzufügen.
  </Card>

  <Card title="Claude Code: eine bestimmte App verbinden" href="/docs/de/datahub/quick-start/agent-connection/claude-code">
    Zuerst eine bestimmte App wählen, dann als festen MCP-Server in Claude Code hinzufügen.
  </Card>
</CardGroup>

<Note>
  Die tatsächliche Anzahl der Apps, ihre Namen, Herausgeber und Preise in einer Suche ändern sich mit dem Data Hub-Katalog. Verlassen Sie sich auf das, was das Tool bei jedem Aufruf zurückgibt.
</Note>