Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

Integrationen

Codex

Geben Sie Codex Google Search und YouTube Werkzeuge für die Kodierung und Forschung.

Auf dieser Seite

Bevor Sie anfangen

Haben Codex CLI installiert und funktioniert. Dieses gehostete MCP-Setup verwendet OAuth für Google Search, YouTube Search, Metadaten und Transkripte. Sie können während der Anmeldung ein FlashData-Konto erstellen.

1. Hinzufügen des MCP-Servers

Fügen Sie diesen Eintrag in ~/.codex/config.toml (oder config.toml unter CODEX_HOME) zusammen. Halten Sie den registrierten Client ID und den Rückruf URL wie angezeigt.

~/.codex/config.toml
[mcp_servers.flashdata]
url = "https://data.flashdata.dev/mcp"

[mcp_servers.flashdata.oauth]
client_id = "flashdata-codex"
callback_url = "http://127.0.0.1/callback"

2. Zeichen

Führen Sie den Login-Befehl aus. Melden Sie sich im Browser an oder erstellen und verifizieren Sie ein Konto und genehmigen Sie dann den Zugriff. Warten Sie, bis das Terminal die Anmeldung bestätigt. Abfragen verwenden die credits dieses kontos.

Anmelden
codex mcp login flashdata --scopes mcp:research

Überprüfen Sie die Verbindung kostenlos

Starten Sie eine neue Codex-Sitzung und überprüfen Sie /mcp auf Flash-Daten. Senden Sie diese Aufforderung; beide Anrufe sollten erfolgreich sein. Ein Null-Gleichgewicht bestätigt immer noch eine Arbeitsverbindung.

Einfügen in Ihren Agenten
Verwenden Sie die Flashdata MCP-Verbindung.
Rufen Sie get_balance mit {} und get_pricing mit {"source":"google_search","request_count":1} an.
Melden Sie verfügbare Credits und den geschätzten Preis. Führen Sie keine Suche durch.

3. Führen Sie Ihre erste Aufgabe aus

Senden Sie dies an Ihren Connected Agent. Die Schecks sind kostenlos; die einzelne Suche verwendet Credits.

Erste Aufgabe prompt
Verwenden Sie den Flashdata MCP Server. Überprüfen Sie mein Guthaben und den Preis einer Google-Suche.
Wenn finanziert, rufen Sie google_search einmal mit der Abfrage "site:docs.python.org/3/library/venv.html create virtual environment", num 5 und Modus "realtime" auf.
Erklären Sie, wie Sie eine virtuelle Python-Umgebung mit den zurückgegebenen Quellen erstellen.
Quellen zitieren und tatsächliche Credits verwenden. Stoppen Sie nach dieser Aufgabe.

Was Sie sehen sollten

Suchen Sie nach einem abgeschlossenen google_search-Toolaufruf mit status: done, Quelllinks von results[].organic und einer Antwort basierend auf diesen Quellen. Die Verwendung kommt von usage.credits; es ist nicht die Anzahl der Ergebnisse. Leere Ergebnisse sollten als leer gemeldet werden.

Was Sie sich wünschen können

Diese OAuth-Verbindung deckt Forschungswerkzeuge ab. YouTube Download verwendet einen Besitzer-API-Schlüssel und Zielspeicher über API oder CLI.

AufgabeMCP-Tool
Finden Sie Webquellen für eine Antwort oder Implementierunggoogle_search
Finden Sie relevante YouTube Videosyoutube_search
Lesen Sie Videotitel, Kanäle und Metadatenyoutube_metadata
Abrufen des Transkripts eines Videos für eine Zusammenfassungyoutube_transcript
Überprüfen Sie verfügbare Credits und Anfragekostenget_balance · get_pricing

Wiederverwendung des Zugriffs für wiederkehrende Aufgaben

Verwenden Sie das gleiche Codex Profil, OS Benutzer und Credential Store. Erstellen Sie den Zeitplan in Ihrem Agenten-Host oder vorhandenen Scheduler; FlashData liefert die Daten-Tools.

Überprüfen Sie den gespeicherten Zugriff

Führen Sie diesen kostenlosen Check in einer neuen Sitzung in der geplanten Umgebung aus. Beide Anrufe sollten ohne ein neues Browser-Login erfolgreich sein.

Wiederverwendungskontrolle
Verwenden Sie die vorhandene Flashdata MCP-Verbindung wieder.
Rufen Sie get_balance mit {} und get_pricing mit {"source":"google_search","request_count":1} an.
Berichten Sie, ob beides gelungen ist. Suchen oder erstellen Sie keinen neuen Zugang.

Erstellen Sie die wiederkehrende Aufgabe

Wählen Sie im Scheduler Ihres Hosts eine Zeit- und Zeitzone aus, z. B. täglich bei 09:00 Asia/Shanghai. Verwenden Sie dies als Task Body. Führen Sie es einmal dort aus und überprüfen Sie den gespeicherten Bericht, bevor Sie eine Wiederholung aktivieren.

Aufgabenstelle
Verwenden Sie die vorhandene Flashdata MCP-Verbindung wieder. Überprüfen Sie get_balance und get_pricing für eine Google Suche.
Wenn erlaubt und finanziert, führen Sie google_search einmal für "site:docs.python.org/3/library/venv.html create virtual environment" mit num 5 und Modus "realtime" aus.
Speichern Sie einen datierten Bericht mit der Quelle URLs, Auszügen und tatsächlichen Credits.
Stoppen Sie bei widerrufenem Zugriff oder unzureichenden Credits; respektieren Sie Retry-After. Erstellen Sie keine Testversion, fordern Sie keine neue Autorisierung an oder wiederholen Sie eine Anfrage, deren Ergebnis unbekannt ist.

Aufbewahrung und Aktualisierung von Berechtigungsnachweisen

Codex behält OAuth-Token in seinem konfigurierten Anmeldedatenspeicher. Eine andere OS-Benutzer-, Profil- oder Ausführungsumgebung benötigt möglicherweise eine eigene genehmigte Verbindung.

Der Host aktualisiert eine Stunde OAuth-Zugriffstoken mit rotierenden Refresh-Token. Verbinden Sie sich erneut, wenn der 90-Tageszuschuss abläuft oder widerrufen wird. Jede Installation besitzt ihren Token-Store; Teilen Sie keine Refresh-Token-Dateien zwischen Hosts.

Widerruf oder Wiederverbindung

  1. Unterbrechen Sie geplante Aufgaben und widerrufen Sie dann die benannte OAuth-Verbindung in FlashData Settings → Connected apps.
  2. Bitten Sie den Agenten, get_balance einmal mit der gespeicherten Verbindung anzurufen. Es sollte die authentifizierung fehlschlagen oder die wiederverbindung anfordern. Genehmigen Sie während dieses Checks kein neues Login.
  3. Entfernen Sie die lokalen OAuth-Anmeldeinformationen mit dem Befehl unten. Um später wieder eine Verbindung herzustellen, wiederholen Sie Schritt 2 mit der Genehmigung des Eigentümers und führen Sie die kostenlose Verbindungsüberprüfung aus.
Speicherte OAuth-Zugangsdaten entfernen
codex mcp logout flashdata

Mehr Setup-Optionen

Fügen Sie Ihrer MCP-Verbindung Workflow-Kenntnisse hinzu oder wählen Sie den CLI-Zugang oder einen lokalen MCP-Server.

Hinzufügen der MCP Fertigkeit

Die Flashdata-mcp-Fähigkeit lehrt Ihren Agenten, wie er die verbundenen Tools verwendet. Es verwendet die obige Verbindung wieder.

Laufen Sie von Ihrem Projekt aus. Wählen Sie das native FlashData CLI v1.2.1 oder das Skills Installer mit Node.js 22.20+ und npm. Starten Sie eine neue Codex-Sitzung und bitten Sie, flashdata-mcp zu verwenden.

In Ihrem Projekt
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcp

Verwenden Sie CLI-Fähigkeiten oder starten Sie eine Studie

Installieren Sie FlashData CLI v1.2.1 und führen Sie von Ihr Projekt aus. Wählen Sie einen Access-Tab. Beispiele verwenden das Standard-CLI-Profil, getrennt von MCP OAuth; behalten Sie Ihre vorhandenen --profile und --state-dir, wenn Sie benutzerdefinierte verwenden.

Setup installiert CLI Fähigkeiten in .agents/skills. Starten Sie eine neue Codex-Sitzung nach der Installation und bitten Sie um die Google-Suche.

Fügen Sie einen Schlüssel mit der google_search-Berechtigung an der versteckten Eingabeaufforderung ein. Für den unbeaufsichtigten Import leiten Sie es von Ihrem geheimen Manager zu auth login --api-key-stdin --non-interactive.

1. Importieren und Verifizieren des Schlüssels
flashdata auth login
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactive
2. Check-Balance und Kosten - keine Suche
flashdata account balance --json --non-interactive
flashdata search "site:docs.python.org/3/library/venv.html create virtual environment" --num 5 --dry-run --json --non-interactive

# Nur weiterfahren, wenn accessVerified und estimateAvailable true sind,
# google_search ist erlaubt und availableCredits deckt estimatedCredits ab.
3. Einmalig laufen → ./codex-first-search.json
flashdata search "site:docs.python.org/3/library/venv.html create virtual environment" --num 5 --run-id codex-first-search-001 --output codex-first-search.json --json --non-interactive

# Lesen Sie die gespeicherte Datei: status, results[].organic, usage.credits.
# Terminal JSON meldet den Ausgabepfad; halten Sie den Lauf ID für die Wiederherstellung.

Führen Sie lokales MCP mit einem API-Schlüssel aus

Erfordert Node.js 22.18+, npm und einen API-Schlüssel mit google_search-Berechtigung für die erste Aufgabe. Dies läuft @flashdata-dev/mcp 0.2.0; es liest nicht den gespeicherten Schlüssel des FlashData CLI oder MCP OAuth-Token.

Setzen Sie den Schlüssel in einem Terminal, ersetzen Sie den gesamten früheren Flashdata-Eintrag (einschließlich des OAuth-Unterabschnitts) durch die unten stehende Konfiguration und starten Sie dann Codex von diesem Terminal aus. Ein Agent kann eine vorhandene injizierte Umgebungsvariable anstelle der versteckten Eingabeaufforderung verwenden.

Führen Sie nach dem Einrichten die freie Verbindungsprüfaufforderung oben in einer neuen Agentensitzung aus. Sobald beide Prüfungen bestanden haben, verwenden Sie die First-Task-Eingabeaufforderung. Der API-Schlüsselzugriff erfordert keine mcp-Anmeldung.

1. Setzen Sie den Schlüssel, ohne ihn zu drucken
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
2. Ersetzen Sie den Eintrag in ~/.codex/config.toml
[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
3. Starten Sie eine neue Sitzung in diesem Terminal
codex

Fehlerbehebung

ProblemProbieren Sie dies aus
Keine FlashData-ToolsFühren Sie die Codex-MCP-Liste aus, dann /mcp in einer neuen Sitzung. Überprüfen Sie die Konfigurationsdatei und das finish-Login.
Geschick fehltÜberprüfen Sie .agents/skills in diesem Projekt. Für eine native MCP-Skill-Installation, führen Sie Flashdata Skills aus, um den --agent-Codex --skill Flashdata-mcp zu überprüfen. Starten Sie die Sitzung neu.
invalid_client / callbackVergleichen Sie Schritt 1 genau. Vollständige Autorisierung in einem Browser, der den Callback des einleitenden Hosts erreichen kann.
401Prüfen Sie, ob die Verbindung oder der Schlüssel widerrufen wurde oder abgelaufen ist. Für OAuth wiederholen Sie die Anmeldung mit Genehmigung des Eigentümers; für CLI führen Sie Flashdata auth status aus. Durch das Hinzufügen von Credits wird die Authentifizierung nicht repariert.
403Überprüfen Sie die angeforderte Quellberechtigung. Research OAuth enthält nicht YouTube Download; verwenden Sie seine API-Schlüssel-Setup. Beheben Sie die Berechtigung, bevor Sie erneut versuchen.
402Überprüfen Sie get_balance oder Flashdata Kontostand. Fügen Sie Credits in Billing hinzu oder beenden Sie die Aufgabe; Durch erneutes Anmelden werden keine Credits hinzugefügt.
429Warten Sie auf Retry-After und reduzieren Sie die Parallelität. Bewahren Sie das aktuelle Profil und den Registrierungsnachweis auf; erstellen Sie keine Ersatzversuche.
Lokales MCP kann den Schlüssel nicht lesenLegen Sie FLASHDATA_API_KEY fest, wo der Hostprozess gestartet und neu gestartet wird. Ein von Flashdata auth login gespeicherter Schlüssel wird nicht automatisch in das lokale MCP exportiert.
CLI-Ausgabedatei bereits vorhandenLesen Sie ./codex-first-search.json. Um den gespeicherten Erfolg erneut zu exportieren, verwenden Sie Flashdata runs show codex-first-search-001 --result --output codex-first-search-copy.json mit dem Originalprofil. Verwenden Sie einen neuen Lauf ID nur für eine beabsichtigte neue Suche.
Geplante Aufgabe fehlschlägtFühren Sie den kostenlosen Wiederverwendungscheck innerhalb dieser Umgebung aus. Passen Sie den OS-Benutzer, das Hostprofil, den Anmeldedatenspeicher und die Werkzeugberechtigungen an.
Timeout oder unbekanntes ErgebnisBehalten Sie die Anforderung oder den Job ID und überprüfen Sie History, bevor Sie erneut senden. Verwenden Sie get_result für die zurückgegebene Fortsetzung IDs.

OAuth-Validierungshinweise

OAuth Login, Callback, gespeicherte Anmeldeinformationen, ein kostenloser Preisanruf, Aktualisierung und Widerruf wurden auf Windows mit Codex 0.163.0-alpha.10.2 auf 2026-10-21 verifiziert. Dieser Lauf validierte keine bezahlten Abfragen oder die geplante Ausführung. Setup-Anweisungen wurden mit der Host-Dokumentation auf 2026-11-05 verglichen.