Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Integrasi

Codex

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.

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

Masuk
codex mcp login flashdata --scopes mcp:research

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

Tempel ke agen Anda
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.

Prompt tugas pertama
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.

TugasMCP alat
Cari sumber web untuk jawaban atau implementasigoogle_search
Cari video YouTube yang relevanyoutube_search
Baca judul video, kanal, dan metadatayoutube_metadata
Ambil transkrip video untuk ringkasanyoutube_transcript
Periksa kredit yang tersedia dan permintaan biayaget_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.

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

Tubuh tugas
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

  1. Jeda tugas yang dijadwalkan, lalu batalkan nama OAuth koneksi dalam FlashData Settings → Connected apps.
  2. 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.
  3. Hapus kredensial OAuth lokal dengan perintah di bawah ini. Untuk berhubungan kembali nanti, langkah berulang 2 dengan persetujuan pemilik dan menjalankan pemeriksaan koneksi bebas.
Hapus kredensial OAuth yang tersimpan
codex mcp logout flashdata

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

Dalam proyek Anda
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcp

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

1. Impor dan verifikasi kunci
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
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

# Lanjutkan jika accessVerified dan estimateAvailable adalah true,
# google_search diperbolehkan, dan availableCredits meliputi estimatedCredits.
3. Jalankan sekali ./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

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

1. Set kunci tanpa mencetaknya
# 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. Ganti entri dalam ~ /.codex/config.toml
[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
3. Mulai sesi baru di terminal ini
codex

Permasalahan menarik

MasalahCoba ini
Tidak ada alat FlashDataJalankan daftar codex mcp, kemudian /mcp dalam sesi segar. Periksa berkas konfigurasi dan login finish.
Skill hilangPeriksa .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 / callbackPadukan langkah 1 tepat. Otorisasi lengkap dalam peramban yang dapat mencapai pemanggilan balik host yang dimulai.
401Periksa 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.
403Periksa izin sumber yang diminta. Penelitian OAuth tidak termasuk YouTube Download; gunakan setup kunci API-nya. Perbaiki izin sebelum mencoba lagi.
402Periksa get_balance atau saldo rekening flashdata. Tambahkan kredit dalam Billing atau menghentikan tugas; penandatanganan masuk lagi tidak menambah kredit.
429Tunggu Retry-After dan kurangi konkuitnya. Pertahankan profil saat ini dan bukti pendaftaran; jangan membuat percobaan pengganti.
MCP lokal tidak dapat membaca kunciSet 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 adaBaca ./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 gagalJalankan pemeriksaan penggunaan ulang gratis di dalam lingkungan itu. Cocok dengan pengguna OS, profil host, toko kredensial dan perizinan alat.
Waktu habis atau hasil tak dikenalSimpan 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.