# Codex

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

Kanonische Referenz: https://flashdata.dev/de/docs/integrations/codex
Test: 2026-11-05 von FlashData

<a id="choose"></a>

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

- [Verwenden Sie CLI-Fähigkeiten oder starten Sie eine Studie](https://flashdata.dev/de/docs/integrations/codex/reference.md#cli)
- [Codex CLI](https://learn.chatgpt.com/docs/codex/cli)

<a id="setup"></a>

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

```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"
```


<a id="oauth"></a>

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

```bash
codex mcp login flashdata --scopes mcp:research
```


<a id="connection-check"></a>

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

```text
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.
```


<a id="first-task"></a>

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

```text
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.
```


<a id="result"></a>

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

- [Prüfung der Antragshistorie](https://flashdata.dev/app/jobs)

<a id="tools"></a>

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

- [MCP-Tools und Schemas](https://flashdata.dev/de/docs/mcp/reference.md)
- [YouTube Download einrichten](https://flashdata.dev/de/docs/guides/youtube-download-guide/reference.md)

<a id="recurring"></a>

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


<a id="reuse-check"></a>

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

```text
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.
```


<a id="schedule"></a>

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

```text
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.
```

- [Wiederkehrendes Task Guide](https://flashdata.dev/de/docs/guides/recurring-tasks/reference.md)
- [CLI Planung und Wiederherstellung](https://flashdata.dev/de/docs/guides/cli-automation/reference.md#recurring)

<a id="credentials"></a>

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


<a id="revoke"></a>

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

```bash
codex mcp logout flashdata
```

- [Connected apps](https://flashdata.dev/app/settings/connections)

<a id="options"></a>

## Mehr Setup-Optionen

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


<a id="skills"></a>

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

##### In Ihrem Projekt

```bash
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcp
```


#### Node.js / npm

##### In Ihrem Projekt

```bash
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent codex --copy
```


- [CLI Installation](https://flashdata.dev/de/docs/guides/flashdata-cli/reference.md#install)
- [Lesen Sie die MCP Fertigkeit](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Aktualisieren oder Entfernen von Fähigkeiten](https://flashdata.dev/de/docs/guides/agent-skill-management/reference.md)

<a id="cli"></a>

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

#### Bestehender API-Schlüssel

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

```bash
flashdata auth login
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. Check-Balance und Kosten - keine Suche

```bash
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

```bash
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.
```


#### CLI-Zugang gespeichert

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.

##### 1. Wiederverwendung und Überprüfung des gespeicherten Zugriffs

```bash
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. Check-Balance und Kosten - keine Suche

```bash
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

```bash
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.
```


#### Zulässige Prüfung

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.

##### 1. Einrichten und Verifizieren des Testzugangs

```bash
flashdata setup --agent codex --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. Check-Balance und Kosten - keine Suche

```bash
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

```bash
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.
```


- [Download CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [CLI Installation](https://flashdata.dev/de/docs/guides/flashdata-cli/reference.md#install)
- [Wiederherstellen eines gespeicherten Ergebnisses](https://flashdata.dev/de/docs/guides/cli-automation/reference.md#recover)
- [Reklamation vor wiederkehrenden CLI-Aufgaben](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md)

<a id="local"></a>

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

##### 1. Setzen Sie den Schlüssel, ohne ihn zu drucken

```bash
# 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

```toml
[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/mcp@0.2.0", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
```

##### 3. Starten Sie eine neue Sitzung in diesem Terminal

```bash
codex
```


#### PowerShell 7 (Windows)

##### 1. Setzen Sie den Schlüssel, ohne ihn zu drucken

```powershell
# 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
```

##### 2. Ersetzen Sie den Eintrag in ~/.codex/config.toml

```toml
[mcp_servers.flashdata]
command = "npx.cmd"
args = ["--yes", "--package=@flashdata-dev/mcp@0.2.0", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
```

##### 3. Starten Sie eine neue Sitzung in diesem Terminal

```powershell
codex
```


- [Führen Sie den Free Connection Check durch](https://flashdata.dev/de/docs/integrations/codex/reference.md#connection-check)
- [Erstellen Sie einen API-Schlüssel](https://flashdata.dev/app/api-keys)
- [Lokale MCP Dokumentation](https://github.com/flashdatadev/flashdata-mcp)

<a id="help"></a>

## Fehlerbehebung

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

- [Wiedereinziehungsrichtlinie](https://flashdata.dev/de/docs/guides/agent-recovery/reference.md)
- [Codex MCP Dokumentation](https://learn.chatgpt.com/docs/extend/mcp)

<a id="compatibility"></a>

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

- [Amtliche Fähigkeiten](https://github.com/flashdatadev/flashdata-skills)
- [MCP-Paket und Quelle](https://github.com/flashdatadev/flashdata-mcp)
