Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Integrazioni

Codex

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

In questa pagina

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.

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
[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. 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
codex mcp login flashdata --scopes mcp:research

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

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

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.

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.

CompitiStrumento MCP
Trova le fonti web per una risposta o un'implementazionegoogle_search
Trova i video YouTubeyoutube_search
Leggi i titoli video, i canali e i metadatiyoutube_metadata
Recuperare la trascrizione di un video per un riassuntoyoutube_transcript
Controllare i crediti disponibili e il costo della richiestaget_balance · get_pricing

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.

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

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

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.

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
codex mcp logout flashdata

Altre opzioni di configurazione

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

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.

Nel tuo progetto
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcp

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.

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

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.

1. Impostare la chiave senza stamparlo
# 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
[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
3. Avviare una nuova sessione in questo terminale
codex

Risoluzione dei problemi

ProblematicheProva questo
Strumenti FlashDataEseguire l'elenco mcp codex, quindi /mcp in una sessione fresca. Controlla il file di configurazione e il login finish.
Abilità mancanteControlla .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 / callbackConfronta il passo 1 esattamente. Autorizzazione completa in un browser in grado di raggiungere il callback dell'ospite iniziante.
401Controllare 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.
403Controllare il permesso della fonte richiesta. Ricerca OAuth non include YouTube Download; utilizza la sua configurazione API-chiave. Fissare il permesso prima di riprovare.
402Controllare il saldo dell'account get_balance o flashdata. Aggiungi crediti in Billing o interrompere l'attività; la firma di nuovo non aggiunge crediti.
429Attendere 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 chiaveImpostare 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 fallisceEsegui 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 sconosciutoMantenere la richiesta o il lavoro ID e controllare History prima di resubmitting. Utilizzare get_result per la continuazione restituita IDs.

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.