Jelajahi dokumentasi
Integrasi
Berikan Codex Google Search dan alat YouTube untuk coding dan penelitian.
Di halaman ini
Sebelum Anda mulai
Buat Codex CLI terpasang dan bekerja. Pengaturan MCP ini menggunakan OAuth untuk Google Search, YouTube Search, Metadata, dan Transkrip. Anda dapat membuat akun FlashData selama sign- in.
1. Tambahkan server MCP
Gabung entri ini ke ~ /.codex/config.toml (atau config.toml di bawah CODEX_HOME). Jauhkan klien terdaftar ID dan callback URL seperti yang ditunjukkan.
[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. Masuk
Jalankan perintah log masuk. Dalam peramban, masuk atau membuat dan memverifikasi sebuah akun, kemudian menyetujui akses. Tunggu terminal untuk mengkonfirmasi login. Kueri menggunakan kredit rekening itu.
codex mcp login flashdata --scopes mcp:researchPeriksa sambungan secara gratis
Mulai sesi Codex baru dan periksa /mcp untuk flashdata. Kirim prompt ini; kedua panggilan harus berhasil. Keseimbangan nol masih mengkonfirmasi koneksi kerja.
Gunakan flashdata koneksi MCP.
Hubungi get_balance dengan {} dan get_pricing dengan {"source":"google_search","request_count":1}.
Laporan kredit yang tersedia dan harga perkiraan. Jangan jalankan pencarian.3. Jalankan tugas pertama Anda
Kirim ini ke agen Anda terhubung. Cek gratis; pencarian tunggal menggunakan kredit.
Gunakan flashdata server MCP. Periksa saldo saya dan harga dari satu Google pencarian.
Jika didanai, panggilan google_search sekali dengan query "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 Cite dan laporan kredit aktual digunakan. Berhenti setelah tugas ini.Apa yang harus Anda lihat
Cari alat google_search lengkap yang dipanggil dengan status: done, sumber tautan dari results[].organic dan jawaban berdasarkan sumber tersebut. Penggunaan berasal dari usage.credits; ini bukan jumlah hasil. Hasil kosong harus dilaporkan sebagai kosong.
Apa yang dapat Anda minta
Koneksi OAuth ini mencakup alat-alat penelitian. YouTube Download menggunakan pemilik kunci API dan penyimpanan tujuan melalui API atau CLI.
| Tugas | MCP alat |
|---|---|
| Cari sumber web untuk jawaban atau implementasi | google_search |
| Cari video YouTube yang relevan | youtube_search |
| Baca judul video, kanal, dan metadata | youtube_metadata |
| Ambil transkrip video untuk ringkasan | youtube_transcript |
| Periksa kredit yang tersedia dan permintaan biaya | get_balance · get_pricing |
Gunakan kembali akses untuk tugas yang berulang
Gunakan profil Codex yang sama, pengguna OS dan toko kredensial. Buat jadwal dalam host agen atau penjadwalan yang ada; FlashData menyediakan alat-alat data.
Verifikasi akses tersimpan
Jalankan pemeriksaan gratis ini dalam sesi segar di lingkungan yang dijadwalkan. Kedua panggilan harus berhasil tanpa login peramban baru.
Gunakan kembali data kilas yang ada MCP koneksi.
Hubungi get_balance dengan {} dan get_pricing dengan {"source":"google_search","request_count":1}.
Laporkan apakah keduanya berhasil. Jangan cari atau buat akses baru.Buat tugas berulang
Dalam penjadwalan host Anda, pilih zona waktu dan waktu, misalnya sehari-hari di 09:00 Asia/Shanghai. Gunakan ini sebagai tubuh tugas. Jalankan sekali di sana dan periksa laporan tersimpan sebelum mengaktifkan rekurensi.
Gunakan kembali data kilas yang ada MCP koneksi. Periksa get_balance dan get_pricing untuk satu pencarian Google.
Jika diijinkan 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 dipakai.
Berhenti pada akses dicabut atau kredit yang tidak mencukupi; hormati Retry-After. Jangan buat percobaan, minta otorisasi baru atau ulangi permintaan yang hasilnya tak diketahui.Penyimpanan kredensial dan penyegaran
Codex menyimpan token OAuth di toko kredensial yang dikonfigurasi. Pengguna OS yang berbeda, profil atau lingkungan eksekusi mungkin perlu koneksi sendiri yang disetujui.
Host menyegarkan satu-jam token akses OAuth menggunakan token refresh berputar. Rekonnect ketika 90-day hibah berakhir atau dicabut. Setiap instalasi memiliki toko token nya; jangan berbagi segar-token berkas antara host.
Membatalkan atau menyambung kembali
- Jeda tugas yang dijadwalkan, lalu batalkan nama OAuth koneksi dalam FlashData Settings → Connected apps.
- Minta agen untuk memanggil get_balance sekali dengan sambungan yang tersimpan. Ini harus gagal otentikasi atau meminta untuk menyambung kembali. Jangan menyetujui log masuk baru selama pemeriksaan ini.
- Hapus kredensial OAuth lokal dengan perintah di bawah ini. Untuk berhubungan kembali nanti, langkah berulang 2 dengan persetujuan pemilik dan menjalankan pemeriksaan koneksi bebas.
codex mcp logout flashdataOpsi setup lebih lanjut
Tambahkan keterampilan arus kerja ke koneksi MCP Anda, atau pilih akses CLI lokal atau server MCP.
Tambahkan keterampilan MCP
Keahlian flashdatma -mcp mengajarkan agen Anda bagaimana menggunakan alat-alat yang terhubung. Ini reuses koneksi di atas.
Lari dari proyekmu. Pilih asli FlashData CLI v1.2.1, atau pemasangan keterampilan dengan Node.js 22.20+ dan npm. Mulai sesi Codex baru dan minta memakai flashdatta -mcp.
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcpnpx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent codex --copyGunakan keterampilan CLI atau mulai percobaan
Pasang FlashData CLI v1.2.1 dan jalankan dari projek Anda. Pilih satu tab akses. Contoh memakai nilai baku CLI profil, terpisah dari MCP OAuth; menjaga keberadaan Anda --profile dan --state-dir jika Anda menggunakan yang kustom.
Setup memasang keterampilan CLI ke .agents/skills. Mulai sesi Codex baru setelah instalasi dan minta untuk menggunakan pencarian google-.
Tempelkan kunci dengan izin google_search pada prompt tersembunyi. Untuk impor tanpa pengawasan, pipe dari manajer rahasia Anda ke auth login --api-key-stdin --non-interactive.
flashdata auth login
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactiveflashdata 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
# Lanjutkan jika accessVerified dan estimateAvailable adalah true,
# google_search diperbolehkan, dan availableCredits meliputi estimatedCredits.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 keluaran; jaga ID untuk pemulihan.Gunakan kembali kunci atau uji coba yang ada. Jika FLASHDATA_API_KEY diset, maka ini akan diutamakan dari kunci yang tersimpan; verifikasi akun yang ditampilkan oleh auth status.
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactiveflashdata 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
# Lanjutkan jika accessVerified dan estimateAvailable adalah true,
# google_search diperbolehkan, dan availableCredits meliputi estimatedCredits.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 keluaran; jaga ID untuk pemulihan.Gunakan ulang percobaan yang ada atau register sekali. Jika kadaluarsa, habis atau dicabut, pemulihan atau klaim itu. Sebelum mengulang tugas CLI, klaim akun dan konfirmasi recurringAllowed: true dalam auth status.
flashdata setup --agent codex --non-interactive
flashdata auth status --json --non-interactiveflashdata 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
# Lanjutkan jika accessVerified dan estimateAvailable adalah true,
# google_search diperbolehkan, dan availableCredits meliputi estimatedCredits.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 keluaran; jaga ID untuk pemulihan.Jalankan lokal MCP dengan kunci API
Membutuhkan Node.js 22.18 +, npm dan kunci API dengan izin google_search untuk tugas pertama. Ini berjalan @flashdata-dev/mcp 0.2.0; ia tidak membaca FlashData CLIkunci disimpan atau MCP OAuth token.
Set kunci dalam sebuah terminal, ganti seluruh entri flashdata sebelumnya (termasuk subseksi OAuth) dengan config di bawah ini, kemudian jalankan Codex dari terminal tersebut. Seorang agen dapat menggunakan variabel lingkungan yang disuntikkan, bukan prompt tersembunyi.
Setelah setup, jalankan koneksi- periksa prompt di atas dalam sesi agen baru. Setelah kedua pemeriksaan lulus, gunakan tugas pertama. API-key access tidak memerlukan log masuk mcp.
# 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[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]codex# 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[mcp_servers.flashdata]
command = "npx.cmd"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]codexPermasalahan menarik
| Masalah | Coba ini |
|---|---|
| Tidak ada alat FlashData | Jalankan daftar codex mcp, kemudian /mcp dalam sesi segar. Periksa berkas konfigurasi dan login finish. |
| Skill hilang | Periksa .agents/skills dalam proyek ini. Untuk seorang asli MCP- keterampilan install, jalankan flashdata keterampilan verifikasi --agent kodex --skill flashdatda-mcp. Memulai ulang sesi. |
| invalid_client / callback | Padukan langkah 1 tepat. Otorisasi lengkap dalam peramban yang dapat mencapai pemanggilan balik host yang dimulai. |
| 401 | Periksa apakah koneksi atau kunci dibatalkan atau kadaluwarsa. Untuk OAuth, ulangi tanda-tanda dengan persetujuan pemilik; untuk CLI, jalankan flashdata auth status. Menambahkan kredit tidak akan memperbaiki otentikasi. |
| 403 | Periksa izin sumber yang diminta. Penelitian OAuth tidak termasuk YouTube Download; gunakan setup kunci API-nya. Perbaiki izin sebelum mencoba lagi. |
| 402 | Periksa get_balance atau saldo rekening flashdata. Tambahkan kredit dalam Billing atau menghentikan tugas; penandatanganan masuk lagi tidak menambah kredit. |
| 429 | Tunggu Retry-After dan kurangi konkuitnya. Pertahankan profil saat ini dan bukti pendaftaran; jangan membuat percobaan pengganti. |
| MCP lokal tidak dapat membaca kunci | Set FLASHDATA_API_KEY dimana proses host dimulai dan restart. Sebuah kunci disimpan oleh flashdata auth login tidak otomatis diekspor ke lokal MCP. |
| CLI berkas keluaran sudah ada | Baca ./codex-first-search.json. Untuk mengekspor sukses yang disimpan lagi, gunakan data-kilas runs show codex-First-search-001 --result --output codex-first-search-copy.json dengan profil asli. Gunakan run baru ID hanya untuk pencarian baru yang dimaksudkan. |
| Tugas terjadwal gagal | Jalankan pemeriksaan penggunaan ulang gratis di dalam lingkungan itu. Cocok dengan pengguna OS, profil host, toko kredensial dan perizinan alat. |
| Waktu habis atau hasil tak dikenal | Simpan permintaan atau pekerjaan ID dan periksa History sebelum menyerahkan kembali. Gunakan get_result untuk mengembalikan kelanjutan IDs. |
OAuth catatan validasi
OAuth login, callback, tersimpan kredensial, panggilan harga gratis, refresh dan pembatalan diverifikasi pada Windows dengan Codex 0.163.0-alpha.10.2 nyala 2026-10-21. Run yang tidak memvalidasi kueri dibayar atau dijadwalkan eksekusi. Instruksi pengaturan telah diperiksa terhadap dokumentasi host pada 2026-11-05.