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.
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.
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.
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.
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.
1
Octoparse Data Hub öffnen und anmelden
Rufen Sie den Octoparse Data Hub auf und melden Sie sich über den Kontoeinstieg oben rechts an.
2
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.
3
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.
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
1
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.
2
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.
3
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.
4
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.
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:
Nutze das gerade verbundene Tool zur Unternehmensanreicherung, um diese drei Leads um Branche, Mitarbeiterzahl und Hauptsitz zu ergänzen: Personio, Celonis, Trade Republic.
1
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.
2
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.
Legen Sie ein Toolset mit mehreren Apps nur an, wenn ein Workflow wirklich mehrere Datenfunktionen braucht.
1
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.
2
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.
3
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.
4
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.
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.