# Codex

Dare Codex Google Ricerca e strumenti YouTube per la codifica e la ricerca.

Riferimento canonico: https://flashdata.dev/it/docs/integrations/codex
Recensito: 2026-11-05 da FlashData

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

## Prima di iniziare

Fai installare e lavorare Codex CLI. Questa configurazione MCP ospitata utilizza OAuth per Google Search, YouTube Search, Metadata e Transcripts. È possibile creare un account FlashData durante il login.

- [Utilizzare le competenze CLI o avviare una prova](https://flashdata.dev/it/docs/integrations/codex/reference.md#cli)
- [Installare Codex CLI](https://learn.chatgpt.com/docs/codex/cli)

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

## 1. Aggiungi il server MCP

Unire questa voce in ~/.codex/config.toml (o config.toml sotto CODEX_HOME). Mantenere il client registrato ID e callback URL come mostrato.

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

Eseguire il comando di login. Nel browser, accedi o crea e verifica un account, quindi approva l'accesso. Attendere che il terminale confermi il login. Le query usano i crediti di quell'account.

### Accedi

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


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

### Controllare la connessione gratuitamente

Avviare una nuova sessione Codex e controllare /mcp per i dati flash. Invia questo prompt; entrambe le chiamate dovrebbero avere successo. Un saldo zero conferma ancora una connessione di lavoro.

#### Incolla il tuo agente

```text
Utilizzare la connessione flashdata MCP.
Chiama get_balance con {} e get_pricing con {"source":"google_search","request_count":1}.
Rapporto di crediti disponibili e il prezzo stimato. Non eseguire una ricerca.
```


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

## 3. Esegui il tuo primo compito

Invia questo al tuo agente collegato. I controlli sono gratuiti; la singola ricerca utilizza crediti.

### Primo prompt delle attività

```text
Utilizzare il server flashdata MCP. Controlla il mio saldo e il prezzo di una ricerca Google.
Se finanziato, chiamare google_search una volta con query "site:docs.python.org/3/library/venv.html create virtual environment", num 5 e modalità "realtime".
Spiegare come creare un ambiente virtuale Python utilizzando le fonti restituite.
Cite fonti e segnalare i crediti effettivi utilizzati. Smettetela dopo questo compito.
```


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

### Che cosa dovresti vedere

Cercare una chiamata completa google_search con status: done, collegamenti sorgente da results[].organic e una risposta in base a tali fonti. L'uso proviene da usage.credits; non è il numero di risultati. I risultati vuoti dovrebbero essere segnalati come vuoti.

- [Ispezionare la cronologia delle richieste](https://flashdata.dev/app/jobs)

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

## Cosa puoi chiedere

Questa connessione OAuth copre gli strumenti di ricerca. YouTube Download utilizza una chiave API e una memoria di destinazione tramite API o CLI.

| Compiti | Strumento MCP |
| --- | --- |
| Trova le fonti web per una risposta o un'implementazione | google_search |
| Trova i video YouTube | youtube_search |
| Leggi i titoli video, i canali e i metadati | youtube_metadata |
| Recuperare la trascrizione di un video per un riassunto | youtube_transcript |
| Controllare i crediti disponibili e il costo della richiesta | get_balance · get_pricing |

- [Strumenti e schemi MCP](https://flashdata.dev/it/docs/mcp/reference.md)
- [Impostare YouTube Scarica](https://flashdata.dev/it/docs/guides/youtube-download-guide/reference.md)

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

## Riutilizzare l'accesso per le attività ricorrenti

Utilizzare lo stesso profilo Codex, utente OS e negozio di credenziali. Creare il programma nel vostro host agente o scheduler esistente; FlashData fornisce gli strumenti di dati.


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

### Verificare l'accesso salvato

Eseguire questo controllo gratuito in una sessione fresca nell'ambiente pianificato. Entrambe le chiamate dovrebbero avere successo senza un nuovo login del browser.

#### Riutilizzare il controllo

```text
Riutilizzare la connessione flashdata esistente MCP.
Chiama get_balance con {} e get_pricing con {"source":"google_search","request_count":1}.
Segnala se sono riusciti entrambi. Non cercare o creare nuovi accessi.
```


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

### Creare l'attività ricorrente

Nel programmatore del tuo host, scegli un fuso orario e un fuso orario, ad esempio ogni giorno a 09:00 Asia/Shanghai. Utilizzare questo come il corpo dell'attività. Eseguire una volta lì e controllare il rapporto salvato prima di abilitare la ricorrenza.

#### Corpo di lavoro

```text
Riutilizzare la connessione flashdata esistente MCP. Controlla get_balance e get_pricing per una ricerca Google.
Se consentito e finanziato, eseguire google_search una volta per "site:docs.python.org/3/library/venv.html create virtual environment" con num 5 e modalità "realtime".
Salvare un rapporto datato con fonte URLs, estratti e crediti reali utilizzati.
Stop all'accesso revocato o crediti insufficienti; rispettare Retry-After. Non creare una prova, richiedere una nuova autorizzazione o ripetere una richiesta il cui risultato è sconosciuto.
```

- [Guida alle attività ricorrenti](https://flashdata.dev/it/docs/guides/recurring-tasks/reference.md)
- [CLI scheduling e recupero](https://flashdata.dev/it/docs/guides/cli-automation/reference.md#recurring)

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

### Deposito centrata e aggiornamento

Codex mantiene i token OAuth nel suo negozio di credenziali configurato. Un altro utente, profilo o ambiente di esecuzione OS può avere bisogno della propria connessione approvata.

L'host aggiorna i token di accesso OAuth di un'ora utilizzando token di aggiornamento rotanti. Ricollegare quando la sovvenzione 90-day scade o viene revocata. Ogni installazione possiede il suo negozio di token; non condividere i file di aggiornamento-token tra gli host.


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

### Rivocare o riconnettere

1. Pausa compiti programmati, quindi revocare la connessione OAuth in FlashData Settings → Connected apps.
2. Chiedi all'agente di chiamare get_balance una volta con la connessione salvata. Dovrebbe fallire l'autenticazione o chiedere di riconnettersi. Non approvare un nuovo login durante questo assegno.
3. Rimuovere le credenziali OAuth locali con il comando sottostante. Per riconnettersi in seguito, ripetere il passaggio 2 con l'approvazione del proprietario ed eseguire il controllo di connessione gratuito.

#### Rimuovere le credenziali OAuth salvate

```bash
codex mcp logout flashdata
```

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

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

## Altre opzioni di configurazione

Aggiungi le competenze del flusso di lavoro alla connessione MCP, o scegli l'accesso CLI o un server MCP locale.


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

### Aggiungere l'abilità MCP

L'abilità flashdata-mcp insegna al tuo agente come utilizzare gli strumenti collegati. Riutilizza la connessione sopra.

Scappa dal tuo progetto. Scegliere il nativo FlashData CLI v1.2.1, o l'installatore di competenze con Node.js 22.20+ e npm. Avviare una nuova sessione Codex e chiedere di utilizzare flashdata-mcp.

#### FlashData CLI

##### Nel tuo progetto

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


#### Node.js / npm

##### Nel tuo progetto

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


- [Installazione CLI](https://flashdata.dev/it/docs/guides/flashdata-cli/reference.md#install)
- [Leggi l'abilità MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Aggiornare o rimuovere le competenze](https://flashdata.dev/it/docs/guides/agent-skill-management/reference.md)

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

### Utilizzare le competenze CLI o avviare una prova

Installare FlashData CLI v1.2.1 ed eseguire da il tuo progetto. Scegli una scheda di accesso. Gli esempi utilizzano il profilo predefinito CLI, separato da MCP OAuth; mantieni il tuo --profile e --state-dir se utilizzi quelli personalizzati.

Setup installa le competenze CLI in .agents/skills. Avviare una nuova sessione Codex dopo l'installazione e chiedere di utilizzare Google-search.

#### Cintura API esistente

Incollare una chiave con il permesso google_search al prompt nascosto. Per l'importazione incustodita, passalo dal tuo manager segreto a auth login --api-key-stdin --non-interactive.

##### 1. Importa e verifica la chiave

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

##### 2. Bilancio di controllo e costo — nessuna ricerca

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

# Continuare solo se accessVerified e estimateAvailable sono true,
# google_search è permesso e availableCredits copre estimatedCredits.
```

##### 3. Correre una volta → ./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

# Leggi il file salvato: stato, results[].organic, usage.credits.
# Terminal JSON riporta il percorso di uscita; mantieni il percorso di esecuzione ID per il recupero.
```


#### Accesso salvato CLI

Riutilizzare la chiave o il prova esistenti. Se viene impostato FLASHDATA_API_KEY, è necessario prevalere sulla chiave salvata; verificare l'account mostrato da auth status.

##### 1. Riutilizzare e verificare l'accesso salvato

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

##### 2. Bilancio di controllo e costo — nessuna ricerca

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

# Continuare solo se accessVerified e estimateAvailable sono true,
# google_search è permesso e availableCredits copre estimatedCredits.
```

##### 3. Correre una volta → ./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

# Leggi il file salvato: stato, results[].organic, usage.credits.
# Terminal JSON riporta il percorso di uscita; mantieni il percorso di esecuzione ID per il recupero.
```


#### Prova idonea

Riutilizzare una prova esistente o registrarsi una volta. Se scaduto, esaurito o revocato, recupera o reclama. Prima di riattivare le attività CLI, rivendicare l'account e confermare recurringAllowed: true in auth status.

##### 1. Impostare e verificare l'accesso alla prova

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

##### 2. Bilancio di controllo e costo — nessuna ricerca

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

# Continuare solo se accessVerified e estimateAvailable sono true,
# google_search è permesso e availableCredits copre estimatedCredits.
```

##### 3. Correre una volta → ./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

# Leggi il file salvato: stato, results[].organic, usage.credits.
# Terminal JSON riporta il percorso di uscita; mantieni il percorso di esecuzione ID per il recupero.
```


- [Scarica CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Installazione CLI](https://flashdata.dev/it/docs/guides/flashdata-cli/reference.md#install)
- [Recuperare un risultato salvato](https://flashdata.dev/it/docs/guides/cli-automation/reference.md#recover)
- [Rivendicare prima di eseguire le attività CLI](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md)

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

### Eseguire MCP locale con una chiave API

Richiede Node.js 22.18+, npm e una chiave API con il permesso google_search per la prima attività. Questo viene eseguito @flashdata-dev/mcp 0.2.0; non legge il tasto salvato di FlashData CLI o i token MCP OAuth.

Impostare la chiave in un terminale, sostituire l'intera voce flashdata precedente (compresa la sua sottosezione OAuth) con la configurazione sottostante, quindi avviare Codex da quel terminale. Un agente può utilizzare una variabile di ambiente iniettato esistente invece del prompt nascosto.

Dopo l'installazione, eseguire il prompt di connessione-check gratuito sopra in una nuova sessione di agente. Una volta che entrambi i controlli passano, utilizzare il prompt del primo-task. L'accesso API-chiave non richiede il login mcp.

#### Bash

##### 1. Impostare la chiave senza stamparlo

```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. Sostituire l'ingresso 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. Avviare una nuova sessione in questo terminale

```bash
codex
```


#### PowerShell 7 (Windows)

##### 1. Impostare la chiave senza stamparlo

```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. Sostituire l'ingresso 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. Avviare una nuova sessione in questo terminale

```powershell
codex
```


- [Eseguire il controllo della connessione gratuita](https://flashdata.dev/it/docs/integrations/codex/reference.md#connection-check)
- [Creare una chiave API](https://flashdata.dev/app/api-keys)
- [Documentazione locale MCP](https://github.com/flashdatadev/flashdata-mcp)

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

## Risoluzione dei problemi

| Problematiche | Prova questo |
| --- | --- |
| Strumenti FlashData | Eseguire l'elenco mcp codex, quindi /mcp in una sessione fresca. Controlla il file di configurazione e il login finish. |
| Abilità mancante | Controlla .agents/skills in questo progetto. Per un'installazione nativa MCP-skill, eseguire le competenze dei dati flash verificano il codex --agent --skill flashdata-mcp. Riavviare la sessione. |
| invalid_client / callback | Confronta il passo 1 esattamente. Autorizzazione completa in un browser in grado di raggiungere il callback dell'ospite iniziante. |
| 401 | Controllare se la connessione o la chiave è stata revocata o scaduta. Per OAuth, ripeti il login con l'approvazione del proprietario; per CLI, eseguire flashdata auth status. L'aggiunta di crediti non ripara l'autenticazione. |
| 403 | Controllare il permesso della fonte richiesta. Ricerca OAuth non include YouTube Download; utilizza la sua configurazione API-chiave. Fissare il permesso prima di riprovare. |
| 402 | Controllare il saldo dell'account get_balance o flashdata. Aggiungi crediti in Billing o interrompere l'attività; la firma di nuovo non aggiunge crediti. |
| 429 | Attendere Retry-After e ridurre la convalutazione. Conservare il profilo attuale e la prova di registrazione; non creare prove di sostituzione. |
| MCP locale non può leggere la chiave | Impostare FLASHDATA_API_KEY in cui il processo host inizia e riavviarlo. Una chiave salvata da flashdata auth login non viene esportata automaticamente in MCP locale. |
| Il file di output CLI esiste già | Leggi ./codex-first-search.json. Per esportare di nuovo il successo salvato, utilizzare flashdata runs show codex- Prima ricerca.001 --result --output codex-first-search-copy.json con il profilo originale. Utilizzare una nuova esecuzione ID solo per una nuova ricerca prevista. |
| L'attività pianificata fallisce | Esegui il controllo di riutilizzo gratuito all'interno di quell'ambiente. Abbina l'utente OS, il profilo host, le autorizzazioni di archiviazione e strumento credenziali. |
| Esito di timeout o sconosciuto | Mantenere la richiesta o il lavoro ID e controllare History prima di resubmitting. Utilizzare get_result per la continuazione restituita IDs. |

- [Guida di recupero](https://flashdata.dev/it/docs/guides/agent-recovery/reference.md)
- [Documentazione Codex MCP](https://learn.chatgpt.com/docs/extend/mcp)

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

## Note di convalida OAuth

OAuth login, callback, credenziali salvate, una chiamata gratuita per i prezzi, aggiornamento e revoca sono stati verificati su Windows con Codex 0.163.0-alpha.10.2 su 2026-10-21. Quell'esecuzione non ha convalidato le domande pagate o l'esecuzione programmata. Le istruzioni di configurazione sono state controllate contro la documentazione dell'host su 2026-11-05.

- [Capacità ufficiali](https://github.com/flashdatadev/flashdata-skills)
- [Pacchetto e fonte MCP](https://github.com/flashdatadev/flashdata-mcp)
