# Codex

Geef Codex Google Search en YouTube tools voor codering en onderzoek.

Canonische referentie: https://flashdata.dev/nl/docs/integrations/codex
Beoordeeld: 2026-11-05 door FlashData

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

## Voordat u begint

Laat de Codex CLI installeren en werken. Deze MCP setup gebruikt OAuth voor Google Search, YouTube Search, Metadata en Transcripts. U kunt een FlashData-account aanmaken tijdens het aanmelden.

- [Gebruik CLI vaardigheden of start een proef](https://flashdata.dev/nl/docs/integrations/codex/reference.md#cli)
- [Codex CLI installeren](https://learn.chatgpt.com/docs/codex/cli)

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

## 1. De MCP-server toevoegen

Voeg dit item toe aan ~/.codex/config.toml (of config.toml onder CODEX_HOME). Houd de geregistreerde client ID en terugbellen URL zoals getoond.

### ~/.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. Aanmelden

Voer het aanmeldcommando uit. In de browser, aanmelden of maken en verifiëren van een account, vervolgens toegang goedkeuren. Wacht tot de terminal de aanmelding bevestigt. Queries gebruiken de credits van die rekening.

### Inloggen

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


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

### Controleer de verbinding gratis

Start een nieuwe Codex sessie en controleer /mcp op flashdata. Stuur deze prompt; beide oproepen moeten slagen. Een nulbalans bevestigt nog steeds een werkverbinding.

#### Plakken in je agent

```text
Gebruik de flashdata MCP verbinding.
Bel get_balance met {} en get_pricing met {"source":"google_search","request_count":1}.
Rapporteer de beschikbare kredieten en de geraamde prijs. Doe geen zoektocht.
```


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

## 3. Voer je eerste taak uit

Stuur dit naar je verbonden agent. De controles zijn gratis; de enkele zoekopdracht maakt gebruik van credits.

### Eerste taakprompt

```text
Gebruik de flashdata MCP server. Controleer mijn saldo en de prijs van één Google zoekopdracht.
Indien gefinancierd, bel google_search één keer met query "site:docs.python.org/3/library/venv.html create virtual environment", num 5 en mode "realtime".
Leg uit hoe je een Python virtuele omgeving maakt met behulp van de teruggekeerde bronnen.
Cite bronnen en rapporteer de werkelijke gebruikte credits. Stop na deze taak.
```


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

### Wat je moet zien

Zoek naar een voltooide google_search tool call met status: done, bronlinks van results[].organic en een antwoord op basis van die bronnen. Gebruik komt van usage.credits; het is niet het aantal resultaten. Lege resultaten moeten als leeg worden gerapporteerd.

- [Geschiedenis van het verzoek inspecteren](https://flashdata.dev/app/jobs)

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

## Wat u kunt vragen

Deze OAuth-verbinding heeft betrekking op onderzoekstools. YouTube Download gebruikt een API sleutel en bestemmingsopslag via de API of CLI.

| Taak | MCP gereedschap |
| --- | --- |
| Webbronnen zoeken voor een antwoord of implementatie | google_search |
| Zoek relevante YouTube-video's | youtube_search |
| Lees videotitels, kanalen en metadata | youtube_metadata |
| Een video transcript ophalen voor een samenvatting | youtube_transcript |
| Controleer beschikbare credits en aanvraagkosten | get_balance · get_pricing |

- [MCP-tools en schema’s](https://flashdata.dev/nl/docs/mcp/reference.md)
- [YouTube Download instellen](https://flashdata.dev/nl/docs/guides/youtube-download-guide/reference.md)

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

## Toegang hergebruiken voor terugkerende taken

Gebruik hetzelfde Codex-profiel, OS-gebruiker en credential store. Maak het schema aan in uw agent host of bestaande scheduler; FlashData levert de datatools.


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

### Gereserveerde toegang verifiëren

Voer deze gratis check in een verse sessie in de geplande omgeving. Beide oproepen moeten slagen zonder een nieuwe browser login.

#### Controle hergebruiken

```text
Gebruik de bestaande flashdata MCP-verbinding opnieuw.
Bel get_balance met {} en get_pricing met {"source":"google_search","request_count":1}.
Rapporteer of beide geslaagd zijn. Niet zoeken of nieuwe toegang creëren.
```


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

### De terugkerende taak aanmaken

Kies in de planning van uw host een tijd- en tijdzone, bijvoorbeeld dagelijks bij 09:00 Asia/Shanghai. Gebruik dit als de taakgroep. Voer het één keer uit en controleer het opgeslagen rapport voordat u het opnieuw inschakelen.

#### Taakorgaan

```text
Gebruik de bestaande flashdata MCP-verbinding opnieuw. Controleer get_balance en get_pricing voor één Google zoekopdracht.
Indien toegestaan en gefinancierd, draai google_search eenmaal voor "site:docs.python.org/3/library/venv.html create virtual environment" met num 5 en modus "realtime".
Sla een gedateerd rapport op met bron URLs, fragmenten en werkelijke gebruikte credits.
Stop bij ingetrokken toegang of onvoldoende credits; respecteer Retry-After. Maak geen proefversie aan, vraag om nieuwe toestemming of herhaal een verzoek waarvan de uitkomst onbekend is.
```

- [Terugkerende taakhandleiding](https://flashdata.dev/nl/docs/guides/recurring-tasks/reference.md)
- [CLI planning en herstel](https://flashdata.dev/nl/docs/guides/cli-automation/reference.md#recurring)

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

### Credential storage en refresh

Codex houdt OAuth tokens in zijn geconfigureerde credential store. Een andere OS gebruiker, profiel of uitvoering omgeving kan een eigen goedgekeurde verbinding nodig hebben.

De host verfrist een uur OAuth toegang tokens met behulp van roterende refresh tokens. Verbinding maken wanneer de 90-dagsubsidie afloopt of wordt ingetrokken. Elke installatie is eigenaar van zijn token store; niet delen van nagelezen bestanden tussen hosts.


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

### Herkoppelen of opnieuw verbinden

1. Pauzeer geplande taken en herroep vervolgens de OAuth verbinding in FlashData Settings → Connected apps.
2. Vraag de agent om get_balance één keer te bellen met de opgeslagen verbinding. Het zou moeten falen authenticatie of vragen om opnieuw verbinding te maken. Een nieuwe aanmelding tijdens deze controle niet goedkeuren.
3. Verwijder de lokale OAuth referenties met het onderstaande commando. Om later opnieuw verbinding te maken, herhaal stap 2 met goedkeuring van de eigenaar en voer de vrije verbindingscontrole uit.

#### Opgeslagen OAuth-gegevens verwijderen

```bash
codex mcp logout flashdata
```

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

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

## Meer instellingen

Voeg workflowvaardigheden toe aan uw MCP-verbinding, of kies CLI-toegang of een lokale MCP-server.


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

### Voeg de MCP vaardigheid toe

De flashdata-mcp vaardigheid leert je agent hoe je de aangesloten tools moet gebruiken. Het hergebruikt de verbinding hierboven.

Ren weg van je project. Kies de eigen FlashData CLI v1.2.1, of de skills installer met Node.js 22.20+ en npm. Start een nieuwe Codex sessie en vraag om flashdata-mcp te gebruiken.

#### FlashData CLI

##### In uw project

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


#### Node.js / npm

##### In uw project

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


- [CLI installatie](https://flashdata.dev/nl/docs/guides/flashdata-cli/reference.md#install)
- [Lees de MCP vaardigheid](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Bekwaamheden bijwerken of verwijderen](https://flashdata.dev/nl/docs/guides/agent-skill-management/reference.md)

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

### Gebruik CLI vaardigheden of start een proef

Installeer FlashData CLI v1.2.1 en voer uit vanaf uw project. Kies één toegangstabblad. Voorbeelden maken gebruik van het standaard CLI-profiel, gescheiden van MCP OAuth; houd uw bestaande --profile en --state-dir als u aangepaste.

Setup installeert CLI vaardigheden in .agents/skills. Start een nieuwe Codex sessie na installatie en vraag om Google-search te gebruiken.

#### Bestaande API-sleutel

Plak een sleutel met google_search permissie op de verborgen prompt. Voor onbeheerde import, pijp het van uw geheime manager naar auth login --api-key-stdin --non-interactive.

##### 1. De sleutel importeren en verifiëren

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

##### 2. Controleer saldo en kosten . Geen zoekopdracht

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

# Alleen doorgaan als accessVerified en estimateAvailable true zijn,
# google_search is toegestaan, en availableCredits dekt estimatedCredits.
```

##### 3. Eenmaal uitvoeren → ./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

# Lees het opgeslagen bestand: status, results[].organic, usage.credits.
# Terminal JSON meldt het uitvoerpad; houd de run ID voor herstel.
```


#### Opgeslagen toegang tot CLI

Hergebruik uw bestaande sleutel of trial. Als FLASHDATA_API_KEY is ingesteld, heeft het voorrang boven de opgeslagen sleutel; verifieer het account weergegeven door auth status.

##### 1. Bewaarde toegang opnieuw gebruiken en verifiëren

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

##### 2. Controleer saldo en kosten . Geen zoekopdracht

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

# Alleen doorgaan als accessVerified en estimateAvailable true zijn,
# google_search is toegestaan, en availableCredits dekt estimatedCredits.
```

##### 3. Eenmaal uitvoeren → ./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

# Lees het opgeslagen bestand: status, results[].organic, usage.credits.
# Terminal JSON meldt het uitvoerpad; houd de run ID voor herstel.
```


#### In aanmerking komende proef

Hergebruik een bestaande proef of registreer één keer. Indien vervallen, uitgeput of ingetrokken, terugvordering of vordering. Voordat u CLI taken herhaalt, kunt u de account aanvragen en recurringAllowed: true bevestigen in auth status.

##### 1. Instellen en verifiëren van toegang tot trials

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

##### 2. Controleer saldo en kosten . Geen zoekopdracht

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

# Alleen doorgaan als accessVerified en estimateAvailable true zijn,
# google_search is toegestaan, en availableCredits dekt estimatedCredits.
```

##### 3. Eenmaal uitvoeren → ./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

# Lees het opgeslagen bestand: status, results[].organic, usage.credits.
# Terminal JSON meldt het uitvoerpad; houd de run ID voor herstel.
```


- [CLI downloaden](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [CLI installatie](https://flashdata.dev/nl/docs/guides/flashdata-cli/reference.md#install)
- [Een opgeslagen resultaat herstellen](https://flashdata.dev/nl/docs/guides/cli-automation/reference.md#recover)
- [Claim voor terugkerende CLI taken](https://flashdata.dev/nl/docs/guides/agent-onboarding/reference.md)

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

### Start lokale MCP met een API-sleutel

Vereist Node.js 22.18+, npm en een API sleutel met google_search toestemming voor de eerste taak. Dit draait @flashdata-dev/mcp 0.2.0; het leest de FlashData CLI's opgeslagen sleutel of MCP OAuth tokens niet.

Stel de sleutel in een terminal in, vervang de gehele eerdere flashdata-item (met inbegrip van de OAuth subsectie) met de onderstaande configuratie, start dan Codex vanaf die terminal. Een agent kan een bestaande geïnjecteerde omgevingsvariabele gebruiken in plaats van de verborgen prompt.

Na het instellen, voer de gratis verbinding-controleprompt hierboven in een nieuwe agent sessie. Zodra beide controles voorbij zijn, gebruik dan de eerste-taakprompt. API-sleutel toegang vereist geen mcp login.

#### Bash

##### 1. Stel de sleutel in zonder af te drukken

```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. Het item in ~/.codex/config.toml vervangen

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

##### 3. Een nieuwe sessie starten in deze terminal

```bash
codex
```


#### PowerShell 7 (Windows)

##### 1. Stel de sleutel in zonder af te drukken

```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. Het item in ~/.codex/config.toml vervangen

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

##### 3. Een nieuwe sessie starten in deze terminal

```powershell
codex
```


- [Voer de vrije verbindingscontrole uit](https://flashdata.dev/nl/docs/integrations/codex/reference.md#connection-check)
- [Een API-sleutel aanmaken](https://flashdata.dev/app/api-keys)
- [Lokale MCP-documentatie](https://github.com/flashdatadev/flashdata-mcp)

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

## Problemen oplossen

| Probleem | Probeer dit eens |
| --- | --- |
| Geen FlashData-gereedschappen | Voer codex mcp lijst, dan /mcp in een verse sessie. Controleer het configuratiebestand en finish login. |
| Vaardigheid ontbreekt | Controleer .agents/skills in dit project. Voor een native MCP-skill-installeer, voer flashdata vaardigheden te verifiëren --agent codex --skill flashdata-mcp. Herstart de sessie. |
| invalid_client / callback | Vergelijk stap 1 precies. Volledige autorisatie in een browser die de oproep van de initiërende host kan bereiken. |
| 401 | Controleer of de verbinding of sleutel is ingetrokken of verlopen. Voor OAuth, herhaal inloggen met goedkeuring van de eigenaar; voor CLI, run flashdata auth status. Het toevoegen van credits zal de authenticatie niet herstellen. |
| 403 | Controleer de gevraagde bron toestemming. Onderzoek OAuth bevat geen YouTube Download; gebruik de API-toetsenopstelling. Repareer de toestemming voor het opnieuw proberen. |
| 402 | Controleer get_balance of flashdata rekening saldo. Voeg credits toe in Billing of stop de taak; opnieuw aanmelden voegt geen credits toe. |
| 429 | Wacht op Retry-After en verminder concurrency. Bewaar het huidige profiel en registratiebewijs; maak geen vervangende proeven. |
| Lokale MCP kan de sleutel niet lezen | Stel FLASHDATA_API_KEY in waar het hostproces wordt gestart en herstart. Een sleutel die is opgeslagen door flashdata auth login wordt niet automatisch geëxporteerd naar lokale MCP. |
| CLI uitvoerbestand bestaat al | Lees ./codex-first-search.json. Om het opgeslagen succes opnieuw te exporteren, gebruik flashdata runs show codex-first-search-001 --result --output codex-first-search-copy.jsonQ met het oorspronkelijke profiel. Gebruik een nieuwe run ID alleen voor een voorgenomen nieuwe zoekopdracht. |
| Geplande taak mislukt | Doe de gratis hergebruik controle in die omgeving. Komt overeen met de OS gebruiker, host profiel, credential store en tool permissies. |
| Timeout of onbekend resultaat | Houd de aanvraag of taak ID en controleer History voordat u opnieuw inzendt. Gebruik get_result voor geretourneerde voortzetting IDs. |

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

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

## OAuth-validatienotities

OAuth login, callback, opgeslagen referenties, een gratis prijsoproep, verfrissen en intrekking werden geverifieerd op Windows met Codex 0.163.0-alpha.10.2 op 2026-10-21. Die run valideerde betaalde vragen of geplande uitvoering niet. De installatie-instructies werden gecontroleerd op de hostdocumentatie op 2026-11-05.

- [Officiële vaardigheden](https://github.com/flashdatadev/flashdata-skills)
- [MCP pakket en bron](https://github.com/flashdatadev/flashdata-mcp)
