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

# Eine Data App mit Codex verbinden

> Eine feste Data App wählen, sie mit dem erzeugten Installations-Prompt in Codex einrichten und den ersten echten Aufruf klein testen.

Dieses Tutorial richtet sich an Nutzer, die **bereits wissen, welche Data App sie verwenden möchten**. Sie wählen und testen die App zuerst im Katalog, kopieren dann den Installations-Prompt dieser App und lassen Codex sie als festes Tool verwenden.

<Note>
  Diese Seite folgt dem Muster „zuerst die App wählen, dann verbinden“. Wenn Sie noch nicht wissen, welche App Sie wählen sollen, und zuerst das MCP verbinden und den Agenten suchen lassen möchten, nutzen Sie stattdessen <a href="/docs/de/datahub/quick-start/agent-connection/general" target="_blank" rel="noopener noreferrer">Allgemeine Verbindung: eine App im Agenten wählen</a>.
</Note>

<Note>
  Diese Seite verwendet als Beispiel eine Data App zur Unternehmensanreicherung, die zu einem Firmennamen Branche, Mitarbeiterzahl und Hauptsitz liefert. Wenn Sie eine andere Data App wählen, unterscheiden sich Seitenname, Eingabeparameter und zurückgegebene Felder, die Verbindungsmethode bleibt aber gleich.
</Note>

## Was Sie danach tun können

Nach diesem Tutorial können Sie einen Datenbedarf direkt in Codex beschreiben, Codex die Data App auf Data Hub aufrufen lassen und strukturierte Ergebnisse zurückerhalten. Sie schreiben nie MCP-Konfiguration von Hand.

## Bevor Sie beginnen

Halten Sie Folgendes bereit:

* Ein Octoparse-Konto, mit dem Sie sich anmelden können.
* Codex installiert und angemeldet.
* Ein klares, kleines Testziel, etwa „ergänze drei Firmennamen um Branche, Mitarbeiterzahl und Hauptsitz“.

<Warning>
  Ein API-Schlüssel ist ein Kontozugangsdatum. Legen Sie einen echten Schlüssel nie in Projektdateien, Code-Repositories, öffentliche Screenshots oder Gruppenchats. Geben Sie ihn nur an, wenn Codex ausdrücklich nach einem Zugangsdatum fragt.
</Warning>

## Schritt 1: die Data App wählen und testen

Bestätigen Sie vor der Verbindung des Agenten im Browser, dass die Data App Ihren Bedarf erfüllt. Wenn ein späterer Aufruf fehlschlägt, können Sie dann schnell erkennen, ob das Problem an den Datenparametern oder an der Codex-Konfiguration liegt.

<Steps>
  <Step title="Octoparse Data Hub öffnen und anmelden">
    Rufen Sie den <a href="https://www.octoparse.de/data-hub" target="_blank" rel="noopener noreferrer">Octoparse Data Hub</a> auf und melden Sie sich über den Kontoeinstieg oben rechts an.
  </Step>

  <Step title="Die benötigte Data App finden">
    Nutzen Sie Suche oder Kategoriefilter, um die Ziel-App zu finden. Lesen Sie auf der Detailseite zuerst Funktionsbeschreibung, Eingabeparameter, Ausgabefelder und Preis. Beurteilen Sie die Eignung nicht allein nach dem App-Namen.
  </Step>

  <Step title="Online mit einer kleinen Datenmenge ausführen">
    Klicken Sie auf **Try It Now** und füllen Sie die Pflichtparameter aus. Fordern Sie beim ersten Mal nur eine kleine Datenmenge an. Prüfen Sie nach Abschluss des Laufs Status, Anzahl der Datensätze und Schlüsselfelder.
  </Step>
</Steps>

Wenn der Browser-Lauf keine Ergebnisse liefert, passen Sie zuerst die Eingabeparameter an oder wechseln Sie zu einer anderen Data App. Verbinden Sie Codex nicht vorschnell.

## Schritt 2: den Codex-Installations-Prompt kopieren

Öffnen Sie auf der Detailseite der Data App **Integration**, wählen Sie MCP und klicken Sie auf **Copy install prompt**. Kopieren Sie den vollständigen Inhalt, den die Seite erzeugt. **Copy MCP URL** liefert nur die Serveradresse, was ausreicht, wenn Sie den Server lieber von Hand hinzufügen. Schreiben Sie die Serveradresse nicht von Hand um.

<Tip>
  Wenn Sie nur eine Funktion brauchen, verbinden Sie eine einzelne Data App. Codex wählt das richtige Tool dann leichter, und die Fehlersuche ist einfacher.
</Tip>

## Schritt 3: einen Octoparse-API-Schlüssel erstellen

<Steps>
  <Step title="Die Seite für API-Schlüssel öffnen">
    Gehen Sie zum <a href="https://www.octoparse.de/console/open-platform/api-keys" target="_blank" rel="noopener noreferrer">Octoparse-Kontocenter</a> und erstellen Sie einen neuen Schlüssel.
  </Step>

  <Step title="Den neuen Schlüssel vorübergehend speichern">
    Ein Schlüssel wird meist nur bei der Erstellung vollständig angezeigt. Speichern Sie ihn in einem vertrauenswürdigen Passwortmanager. Bewahren Sie ihn nach der Konfiguration nicht in einer Klartextdatei auf.
  </Step>
</Steps>

Die auf der Detailseite der Data App erzeugte Konfiguration für eine bestimmte App verwendet einen API-Schlüssel. Die Zeile `Authorization: Bearer <API_KEY>` in der Konfiguration ist lediglich das Header-Format für den API-Schlüssel. Die allgemeine Verbindung unterstützt auch OAuth. Vermischen Sie keine Konfigurationsausschnitte aus den beiden Tutorials.

## Schritt 4: Codex die Verbindung abschließen lassen

<Steps>
  <Step title="Den Installations-Prompt an Codex senden">
    Starten Sie eine neue Codex-Unterhaltung, fügen Sie den vollständigen kopierten Installations-Prompt ein und senden Sie ihn. Codex liest Serveradresse und Konfigurationsanforderungen und sagt Ihnen dann, was es als Nächstes braucht.
  </Step>

  <Step title="Den API-Schlüssel auf Nachfrage angeben">
    Geben Sie den gerade erstellten Schlüssel nur an, wenn Codex ausdrücklich nach einem Zugangsdatum fragt. Prüfen Sie, dass Codex die MCP-Konfiguration des aktuellen Benutzers bearbeitet und keine geteilte Datei im Projekt.
  </Step>

  <Step title="Das Konfigurationsergebnis bestätigen">
    Wenn Codex fertig ist, nennt es die geschriebene Konfigurationsdatei und den Namen des neuen Servers. Normalerweise bearbeitet es die `config.toml` auf Benutzerebene und fordert Sie auf, MCP neu zu laden oder Codex neu zu starten.
  </Step>

  <Step title="Codex neu laden">
    Laden Sie MCP neu, wie Codex es vorschlägt. Wenn die Oberfläche keine Option zum Neuladen hat, schließen Sie Codex und öffnen Sie es erneut. Fahren Sie dann mit der Prüfung unten fort.
  </Step>
</Steps>

## Schritt 5: den ersten echten Aufruf machen

Sagen Sie Codex in natürlicher Sprache, was Sie abfragen möchten, und geben Sie einen klaren Umfang an. Begrenzen Sie beim ersten Aufruf die Menge. Zum Beispiel:

```text theme={null} theme={null}
Nutze das gerade verbundene Tool zur Unternehmensanreicherung, um diese drei Leads um Branche, Mitarbeiterzahl und Hauptsitz zu ergänzen: Personio, Celonis, Trade Republic.
```

<Steps>
  <Step title="Bestätigen, dass Codex die Data App aufgerufen hat">
    Beobachten Sie die Tool-Aufrufe in der Unterhaltung. Nur wenn ein Data Hub-Tool-Aufruf erscheint, hat Codex die Data App wirklich verwendet, statt aus eigenem Wissen zu antworten.
  </Step>

  <Step title="Die zurückgegebenen Ergebnisse prüfen">
    Prüfen Sie, ob Anzahl der Datensätze, Felder und Inhalt zum Browser-Test passen. Ein leeres Feld bedeutet nicht immer einen Fehler. Prüfen Sie zuerst, ob die Quelldaten dieses Feld für den Datensatz überhaupt liefern.
  </Step>
</Steps>

## Optional: Codex mehrere Data Apps nutzen lassen

Legen Sie ein Toolset mit mehreren Apps nur an, wenn ein Workflow wirklich mehrere Datenfunktionen braucht.

<Steps>
  <Step title="MCP connection in der Open Platform öffnen">
    Öffnen Sie von Data Hub aus die Open Platform, klicken Sie auf **MCP connection** und öffnen Sie dann den Bereich für eigene Toolsets.
  </Step>

  <Step title="Die benötigten Data Apps wählen">
    Fügen Sie nur die Apps hinzu, die der aktuelle Workflow wirklich braucht. Manche App-Detailseiten bieten auch ein Bündel **Related Data Apps**.
  </Step>

  <Step title="Den Installations-Prompt für mehrere Apps kopieren und senden">
    Speichern Sie das Toolset, kopieren Sie den von der Seite erzeugten Installations-Prompt, senden Sie ihn an Codex und laden Sie MCP neu, wenn Sie dazu aufgefordert werden.
  </Step>

  <Step title="Die Tools einzeln prüfen">
    Bitten Sie Codex zuerst, die verfügbaren Datenfunktionen aufzulisten, und testen Sie dann jeweils eine App. Wenn alle bestehen, lassen Sie mehrere Apps gemeinsam an einer komplexen Aufgabe arbeiten.
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="Codex meldet Erfolg, aber es erscheinen keine Tools">
    Laden Sie MCP neu oder starten Sie Codex neu. Wenn weiterhin keine Tools erscheinen, lassen Sie Codex prüfen, ob Serveradresse und Header in der `config.toml` auf Benutzerebene vollständig sind, und bestätigen Sie, dass dieselbe Benutzerkonfiguration gelesen wird.
  </Accordion>

  <Accordion title="Nicht autorisiert oder ungültiger API-Schlüssel">
    Stellen Sie sicher, dass dem Schlüssel keine Zeichen fehlen, er keine Leerzeichen oder Zeilenumbrüche enthält und noch gültig ist. Diese Seite verwendet die auf der Seite der bestimmten App erzeugte API-Schlüssel-Konfiguration. Wenn Sie OAuth brauchen, verwenden Sie stattdessen die Konfiguration von der Seite der allgemeinen Verbindung.
  </Accordion>

  <Accordion title="Codex hat das Tool nicht aufgerufen und mit reinem Text geantwortet">
    Schreiben Sie „nutze das gerade verbundene Data Hub-Tool“ ausdrücklich in die Frage und geben Sie die Parameter an, die die App unterstützt. Sie können Codex auch zuerst die verfügbaren Tools auflisten lassen, um zu bestätigen, dass der Server geladen ist.
  </Accordion>

  <Accordion title="Der Browser liefert Ergebnisse, aber der Codex-Aufruf schlägt fehl">
    Vergleichen Sie mit den Parametern, die im Browser funktioniert haben. Prüfen Sie Serveradresse, API-Schlüssel, Parameterformat und Codex-Protokolle nacheinander. Halten Sie den Anfrageumfang bei der ersten Prüfung klein, damit ein Timeout nicht mit einem Verbindungsfehler verwechselt wird.
  </Accordion>

  <Accordion title="Nach Änderung des Toolsets zeigt Codex noch die alten Tools">
    Kopieren Sie nach dem Speichern des neuen Toolsets den aktuellen Installations-Prompt erneut, lassen Sie Codex die Konfiguration aktualisieren und laden Sie dann MCP neu. Clients synchronisieren Toolset-Änderungen nicht automatisch.
  </Accordion>
</AccordionGroup>

## Checkliste

* Sie haben die Data App im Browser mit einer kleinen Datenmenge erfolgreich ausgeführt.
* Sie haben den Installations-Prompt aus dem aktuellen Abschnitt **Integration** der App kopiert.
* Der API-Schlüssel ist nur in einer vertrauenswürdigen lokalen Konfiguration oder einem Zugangsdaten-Tool gespeichert.
* Codex hat MCP neu geladen und das Data Hub-Tool erscheint.
* Sie haben einen echten Tool-Aufruf abgeschlossen und Anzahl der Datensätze sowie Schlüsselfelder geprüft.

<CardGroup cols={2}>
  <Card title="Allgemeine Verbindung" href="/docs/de/datahub/quick-start/agent-connection/general">
    Keine App vorab wählen. Verbinden und dann den Agenten die passende Datenfunktion suchen und ausführen lassen.
  </Card>

  <Card title="Claude Code: eine bestimmte App verbinden" href="/docs/de/datahub/quick-start/agent-connection/claude-code">
    Wenn Sie Claude Code verwenden, finden Sie dort den vollständigen Ablauf für eine bestimmte App in diesem Client.
  </Card>
</CardGroup>