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.
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 Allgemeine Verbindung: eine App im Agenten wählen.
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.
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“.
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.
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.
Octoparse Data Hub öffnen und anmelden
Rufen Sie den Octoparse Data Hub auf und melden Sie sich über den Kontoeinstieg oben rechts an. 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.
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.
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.
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.
Schritt 3: einen Octoparse-API-Schlüssel erstellen
Die Seite für API-Schlüssel öffnen
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.
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
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.
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.
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.
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.
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:
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.
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.
Optional: Codex mehrere Data Apps nutzen lassen
Legen Sie ein Toolset mit mehreren Apps nur an, wenn ein Workflow wirklich mehrere Datenfunktionen braucht.
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.
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.
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.
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.
FAQ
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.
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.
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.
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.
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.
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.
Allgemeine Verbindung
Keine App vorab wählen. Verbinden und dann den Agenten die passende Datenfunktion suchen und ausführen lassen.
Claude Code: eine bestimmte App verbinden
Wenn Sie Claude Code verwenden, finden Sie dort den vollständigen Ablauf für eine bestimmte App in diesem Client.