Dokumentation durchsuchen
Integrationen
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.
[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.
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.
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.
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.
| Aufgabe | MCP-Tool |
|---|---|
| Finden Sie Webquellen für eine Antwort oder Implementierung | google_search |
| Finden Sie relevante YouTube Videos | youtube_search |
| Lesen Sie Videotitel, Kanäle und Metadaten | youtube_metadata |
| Abrufen des Transkripts eines Videos für eine Zusammenfassung | youtube_transcript |
| Überprüfen Sie verfügbare Credits und Anfragekosten | get_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.
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.
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
- Unterbrechen Sie geplante Aufgaben und widerrufen Sie dann die benannte OAuth-Verbindung in FlashData Settings → Connected apps.
- 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.
- 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.
codex mcp logout flashdataMehr 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.
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcpnpx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent codex --copyVerwenden 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.
flashdata auth login
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactiveflashdata 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.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.Verwenden Sie Ihren vorhandenen Schlüssel oder Test. Wenn FLASHDATA_API_KEY gesetzt ist, hat es Vorrang vor dem gespeicherten Schlüssel; Überprüfen Sie das von auth status angezeigte Konto.
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactiveflashdata 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.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.Verwenden Sie eine vorhandene Testversion oder registrieren Sie sich einmal. Wenn abgelaufen, erschöpft oder widerrufen, erholen oder fordern Sie es. Bevor Sie CLI-Aufgaben wiederholen, fordern Sie das Konto an und bestätigen Sie recurringAllowed: true in auth status.
flashdata setup --agent codex --non-interactive
flashdata auth status --json --non-interactiveflashdata 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.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.
# 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[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]codex# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey[mcp_servers.flashdata]
command = "npx.cmd"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]codexFehlerbehebung
| Problem | Probieren Sie dies aus |
|---|---|
| Keine FlashData-Tools | Fü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 / callback | Vergleichen Sie Schritt 1 genau. Vollständige Autorisierung in einem Browser, der den Callback des einleitenden Hosts erreichen kann. |
| 401 | Prü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. |
| 429 | Warten 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 lesen | Legen 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 vorhanden | Lesen 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ägt | Fü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 Ergebnis | Behalten 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.