# Codex

Berikan alat CodexZQ Google Search dan YouTube untuk pengodean dan penelitian.

Referensi boonical: https://flashdata.dev/ms/docs/integrations/codex
Diulas: 2026-11-05 oleh FlashData

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

## Sebelum kau mulai

Pastikan Codex CLI telah dipasang dan berfungsi. Persediaan MCP dihoskan ini menggunakan OAuth untuk Google Search, YouTube Search, Metadata dan Transcripts. Anda boleh mencipta akaun FlashData semasa log masuk.

- [Use CLI keterampilan atau memulai percobaan](https://flashdata.dev/ms/docs/integrations/codex/reference.md#cli)
- [Pasang Codex CLI](https://learn.chatgpt.com/docs/codex/cli)

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

## 1. ** Tambah server MCP **

Cantumkan entri ini ke ~/.codex/config.toml (atau config.toml dibawah CODEX_HOME). ¡Simpan klien terdaftar ID dan panggil balik URL seperti yang ditunjukkan.

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

Jalankan perintah login. Dalam browser, tanda tangan masuk atau membuat dan memverifikasi akun, kemudian menyetujui akses. Tunggu terminal untuk mengkonfirmasi log masuk. Queries menggunakan kredit rekening itu.

### Log masuk

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


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

### Periksa koneksi gratis

Mulai sesi baru Codex dan periksa /mcp untuk flashdata. Kirim prompt ini; kedua panggilan harus berhasil. Keseimbangan nol masih mengkonfirmasi hubungan kerja.

#### Ketemu dengan agenmu

```text
Guna koneksi flashdata MCP.
Panggilan get_balance dengan {} dan get_pricing dengan {"source":"google_search","request_count":1}.
Laporkan kredit yang tersedia dan harga yang diperkirakan. Jangan mencari.
```


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

## 3. Jalankan tugas pertama anda

Dia mengirim ini ke agenmu yang terhubung. Cek bebas; pencarian tunggal menggunakan kredit.

### Promp Tugas pertama

```text
Guna server MCP Data flashdata. Periksa keseimbanganku dan harga satu pencarian Google.
Jika didanai, sebut google_search sekali dengan pertanyaan "site:docs.python.org/3/library/venv.html create virtual environment", num 5 dan mode "realtime".
Jelaskan bagaimana membuat lingkungan virtual Python menggunakan sumber yang dikembalikan.
Sumber-sumber Cite dan laporan kredit aktual yang digunakan. Berhenti setelah tugas ini.
```


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

### Apa yang harus kau lihat

Lihat untuk panggilan alat google_search lengkap dengan status: done, sumber link dari results[].organic dan jawaban berdasarkan sumber-sumber tersebut. Penggunaan teropong berasal dari usage.credits; itu bukan jumlah hasil. Hasil kosong seharusnya dilaporkan kosong.

- [Sejarah permintaan pemeriksaan dan pemeriksaan](https://flashdata.dev/app/jobs)

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

## Apa yang bisa kau minta

Sambungan OAuth ini meliputi alat-alat penelitian. YouTube Download menggunakan kunci API pemilik dan penyimpanan tujuan melalui API atau CLI.

| Task | Alat MCP |
| --- | --- |
| Wake_r cari sumber web untuk jawaban atau implementasi | google_search |
| Keperluan mencari video YouTube yang relevan | youtube_search |
| (Inggris) Baca judul video, saluran, dan data meta | youtube_metadata |
| Mengeluarkan transkrip video untuk sebuah ringkasan | youtube_transcript |
| Periksa kredit dan biaya permintaan yang tersedia | get_balance · get_pricing |

- [Alat dan skema MCP](https://flashdata.dev/ms/docs/mcp/reference.md)
- [YouTube Download](https://flashdata.dev/ms/docs/guides/youtube-download-guide/reference.md)

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

## _Tolakkan kembali akses untuk tugas yang berulang

Use Codex yang sama profile, OS user dan credential store. Buat jadwal dalam agen tuan rumah atau penjadwal yang ada; FlashData memasok alat-alat data.


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

### Akses yang disimpan secara pasti akan disimpan

Jalankan cek gratis ini di sesi baru di lingkungan yang dijadwalkan. Kedua panggilan harus berhasil tanpa log masuk peramban baru.

#### Cek penggunaan ulang

```text
Gunakan kembali koneksi flashdata MCP yang ada.
Panggilan get_balance dengan {} dan get_pricing dengan {"source":"google_search","request_count":1}.
Melaporkan apakah keduanya berhasil. Jangan mencari atau membuat akses baru.
```


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

### _Ubah suai tugas yang berulang

Di jadwal tuan rumah, pilihlah zona waktu dan waktu, misalnya setiap hari di 09:00 Asia/Shanghai. Gunakan ini sebagai badan tugas. Jalankan sekali di sana dan periksa laporan tersimpan sebelum mengaktifkan pengulangan.

#### Badan Tugas Penggeledahan

```text
Gunakan kembali koneksi flashdata MCP yang ada. Periksa get_balance dan get_pricing untuk satu pencarian Google.
Jika diizinkan dan didanai, jalankan google_search sekali untuk "site:docs.python.org/3/library/venv.html create virtual environment" dengan num 5 dan mode "realtime".
Simpan laporan tertanggal dengan sumber URLs, kutipan dan kredit aktual yang digunakan.
Stop pada akses yang dicabut atau kredit yang tidak mencukupi; hormati Retry-After. Jangan buat persidangan, minta otorisasi baru atau ulangi permintaan yang hasilnya tidak diketahui.
```

- [Petunjuk tugas yang berulang](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md)
- [Penjadwalan dan pemulihan CLI](https://flashdata.dev/ms/docs/guides/cli-automation/reference.md#recurring)

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

### Penyimpanan dan penyegaran kredensial

Codex menyimpan token OAuth dalam toko kredensial yang telah dikonfigurasi. Pengguna OS yang berbeda, profil atau lingkungan eksekusi mungkin membutuhkan koneksi yang disetujui sendiri.

Most me-refresh satu jam OAuth token akses menggunakan refresh token berputar. Putuskan kembali ketika hibah 90-hari berakhir atau dicabut. Setiap instalasi memiliki toko tokennya; jangan berbagi berkas-berkas yang disegarkan di antara host.


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

### Membatalkan atau menyambung kembali

1. Jeda jadwalkan tugas, kemudian batalkan yang bernama OAuth Sambungan sambungan dalam FlashData Settings → Connected apps.
2. Minta agen untuk memanggil get_balance sekali dengan koneksi tersimpan. Ini harus gagal otentikasi atau meminta untuk menyambung kembali. Jangan menyetujui log masuk baru selama pemeriksaan ini.
3. Keluarkan kelayakan lokal OAuth dengan perintah di bawah. Untuk menyambung kembali kemudian, ulangi langkah 2 dengan persetujuan pemilik dan jalankan pemeriksaan sambungan bebas.

#### Evidence OAuth tersimpan

```bash
codex mcp logout flashdata
```

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

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

## Lebih banyak pilihan setup

Tambahkan keterampilan alur kerja ke sambungan MCP Anda, atau pilih akses CLI atau server lokal MCP.


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

### * Tambahkan kemampuan MCP *

Kemampuan flashdata-mcp mengajarkan agenmu bagaimana menggunakan alat yang terhubung. Ini menggunakan kembali sambungan di atas.

Lulus dari proyekmu. Pilih FlashData CLI v1.2.1, atau pemasang keterampilan dengan Node.js 22.20+ dan npm. Mulai sesi baru Codex dan minta menggunakan flashdata-mcp.

#### FlashData CLI

##### Dalam proyek Anda

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


#### Node.js / npm

##### Dalam proyek Anda

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


- [Pemasangan CLI](https://flashdata.dev/ms/docs/guides/flashdata-cli/reference.md#install)
- [Dia membaca kemampuan MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Update atau hapus keterampilan](https://flashdata.dev/ms/docs/guides/agent-skill-management/reference.md)

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

### Use CLI keterampilan atau memulai percobaan

Anstal FlashData CLI v1.2.1 dan jalankan dari Proyekmu. Pilih satu tab akses. Contoh-contoh contoh menggunakan profil standar CLI, terpisah dari MCP OAuth; jaga --profile dan --state-dir jika Anda menggunakan yang biasa.

Setup nixify memasang kemampuan CLI ke dalam .agents/skills. Mulai sesi baru Codex setelah pemasangan dan minta menggunakan google-search.

#### Kunci API Wujud

Tempelkan kunci dengan izin google_search di prompt tersembunyi. Untuk impor yang tidak diinginkan, pipakan dari manajer rahasiamu ke auth login --api-key-stdin --non-interactive.

##### 1. Import dan sahkan kunci

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

##### 2. Periksa keseimbangan dan biaya — tidak ada pencarian

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

# Hanya lanjutkan jika accessVerified dan estimateAvailable adalah true,
# google_search diizinkan, dan availableCredits mencakup estimatedCredits.
```

##### 3. Hainda Run sekali → ./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

# Baca berkas yang disimpan: status, results[].organic, usage.credits.
# Terminal JSON melaporkan jalur output; tetap jalankan ID untuk pemulihan.
```


#### Akses CLI tersimpan

Anda menggunakan kembali kunci atau persidangan Anda yang ada. Jika FLASHDATA_API_KEY ditetapkan, ia mengambil alih kunci yang disimpan; sahkan akun yang ditunjukkan oleh auth status.

##### 1. Memulangi dan memverifikasi akses yang disimpan

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

##### 2. Periksa keseimbangan dan biaya — tidak ada pencarian

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

# Hanya lanjutkan jika accessVerified dan estimateAvailable adalah true,
# google_search diizinkan, dan availableCredits mencakup estimatedCredits.
```

##### 3. Hainda Run sekali → ./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

# Baca berkas yang disimpan: status, results[].organic, usage.credits.
# Terminal JSON melaporkan jalur output; tetap jalankan ID untuk pemulihan.
```


#### Pengadilan yang dapat dilenyapkan

Dia menggunakan ulang percobaan atau pendaftar yang ada sekali. Jika kedaluwarsa, habis atau dicabut, pulihkan atau klaim. Tugas CLI yang berulang tidak terulang, klaim akun dan konfirmasi recurringAllowed: true dalam auth status.

##### 1. Atur dan periksa akses pengadilan

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

##### 2. Periksa keseimbangan dan biaya — tidak ada pencarian

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

# Hanya lanjutkan jika accessVerified dan estimateAvailable adalah true,
# google_search diizinkan, dan availableCredits mencakup estimatedCredits.
```

##### 3. Hainda Run sekali → ./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

# Baca berkas yang disimpan: status, results[].organic, usage.credits.
# Terminal JSON melaporkan jalur output; tetap jalankan ID untuk pemulihan.
```


- [Muaturun CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Pemasangan CLI](https://flashdata.dev/ms/docs/guides/flashdata-cli/reference.md#install)
- [Pulihkan kembali hasil yang disimpan](https://flashdata.dev/ms/docs/guides/cli-automation/reference.md#recover)
- [TULAPKAN sebelum tugas CLI yang berulang](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md)

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

### Pergi ke MCP lokal dengan kunci API

Keanquires Node.js 22.18+, npm dan kunci API dengan izin google_search untuk tugas pertama. Ini dijalankan @flashdata-dev/mcp 0.2.0Itu tidak membaca FlashData CLIKunci tersimpan atau MCP OAuth Token.

Diakonkan kunci dalam sebuah terminal, ganti seluruh masukan flashdata sebelumnya (termasuk subsection OAuth-nya) dengan konfigurasi di bawah, kemudian mulai Codex dari terminal tersebut. Agen agen gondok dapat menggunakan variabel lingkungan yang sudah disuntikkan, bukan propt tersembunyi.

Setelah penyiapan, jalankan prompt connection-check gratis di atas dalam sesi agen baru. Setelah kedua cek lulus, gunakan prompt first-task. Akses API-key tidak memerlukan log masuk mcp.

#### Bash

##### 1. ** Set kunci tanpa mencetaknya *

```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. Gantikan nama entri dalam ~/.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. Mulai sesi baru di terminal ini

```bash
codex
```


#### PowerShell 7 (Windows)

##### 1. ** Set kunci tanpa mencetaknya *

```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. Gantikan nama entri dalam ~/.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. Mulai sesi baru di terminal ini

```powershell
codex
```


- [Memerlukan cek sambungan gratis](https://flashdata.dev/ms/docs/integrations/codex/reference.md#connection-check)
- [Xachive membuat kunci API](https://flashdata.dev/app/api-keys)
- [Dokumentasi lokal MCP](https://github.com/flashdatadev/flashdata-mcp)

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

## Penerjemahan Masalah

| Problem | Cuba ini |
| --- | --- |
| Tak ada alat FlashData | Jalankan daftar mcp kodeks, lalu /mcp dalam sesi baru. Periksa berkas konfigurasi dan login finish. |
| Keterampilan Tak Ada | Periksa .agents/skills di proyek ini. Untuk install MCP-skill asli, jalankan kemampuan flashdata verifikasi --agent kodeks --skill flashdata-mcp. Mulai ulang sesinya. |
| invalid_client / callback | Bandingkan langkah 1 dengan tepat. Otorisasi Complete Otorisasi dalam browser yang dapat mencapai callback host yang dimulai. |
| 401 | Keengganan untuk memeriksa apakah sambungan atau kunci dicabut atau telah kadaluarsa. Untuk OAuth, repeat sign-in dengan persetujuan pemilik; untuk CLI, jalankan flashdata auth status. Kredit tambahan tidak akan memperbaiki autentikasi. |
| 403 | Periksa izin sumber yang diminta. Penelitian OAuth tidak termasuk YouTube Download; gunakan setup API-key-nya. \"Fix\" izinnya sebelum mencoba lagi. |
| 402 | Periksa saldo akun get_balance atau flashdata. Address credits in Billing atau menghentikan tugas; signing in again tidak menambahkan credits. |
| 429 | Wait untuk Retry-After dan mengurangi konkurensi. Ketahanan profil dan bukti pendaftaran saat ini; jangan membuat uji coba penggantian. |
| Log Logikal MCP tidak dapat membaca kunci | FLASHDATA_API_KEY dimana proses host dimulai dan memulai ulang. Kunci yang disimpan oleh flashdata auth login tidak otomatis diekspor ke MCP lokal. |
| Berkas keluaran CLI sudah ada | Token baca ./codex-first-search.json. Untuk mengekspor kesuksesan yang disimpan kembali, gunakan flashdata runs show codex-pertama-search-001 --result --output codexXQ-first-search-copy.json dengan profil asli. Gunalah ID baru hanya untuk pencarian baru yang ditujukan. |
| Tugas yang dijadwalkan gagal | Jalankan cek penggunaan kembali gratis di dalam lingkungan itu. Kecocokan dengan pengguna OS, profil host, credential store dan hak akses alat. |
| Kehabisan masa atau hasil yang tidak diketahui | Tetap jaga permintaan atau pekerjaan ID dan periksa History sebelum pengiriman ulang. Use get_result untuk mengembalikan kelanjutan IDs. |

- [Panduan Pemulihan Limpahan](https://flashdata.dev/ms/docs/guides/agent-recovery/reference.md)
- [Dokumentasi Codex MCP](https://learn.chatgpt.com/docs/extend/mcp)

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

## Catatan validasi OAuth

Login OAuth, callback, devired disimpan, panggilan pricing bebas, refresh dan pembatalan telah diverifikasi pada Windows dengan Codex 0.163.0-alpha.10.2 pada 2026-10-21. Eksekusi yang dijalankan tidak mengesahkan pertanyaan atau eksekusi terjadwal. Instruksi setup susunan engsel diperiksa terhadap dokumentasi host pada 2026-11-05.

- [Keterampilan resmi](https://github.com/flashdatadev/flashdata-skills)
- [paket dan sumber MCP](https://github.com/flashdatadev/flashdata-mcp)
