# FlashData MCP

Berikan agen Anda Google Search dan alat YouTube. Hubungkan inang Anda, kemudian meminta hasil pertama Anda.

Referensi kanonikal: https://flashdata.dev/id/docs/integrations/mcp-clients
Diulang: 2026-11-05 oleh FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Server resmi MCP
- [MCP referensi](https://flashdata.dev/id/docs/mcp/reference.md) — Perkakas, parameter dan respon
- [Dapatkan API key](https://flashdata.dev/app/api-keys) — Bagi host yang memakai otentikasi header

<a id="connect"></a>

## 1. Hubungkan dan tandai

Pilih Codex atau OpenClaw untuk browser- berbasis OAuth. Untuk host lain, pilih Remote / API kunci jika mendukung Streamable HTTP dan tajuk ubahan, atau Local / stdio jika diluncurkan MCP proses. Server yang diselenggarakan tidak memerlukan instalasi lokal.

### Codex

Gabung config di bawah ini ke ~ /.codex/config.toml, kemudian jalankan perintah login. Lengkap FlashData signal atau signal-in dan persetujuan dalam peramban. Mulai sesi Codex baru setelah log masuk.

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

#### Masuk

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


### OpenClaw

Jalankan perintah ini dalam profil OpenClaw yang digunakan agenmu. Lengkap pendaftaran atau tandatangan dan persetujuan dalam peramban, kemudian memulai sesi baru. Dokter memeriksa sambungan yang tersimpan.

#### Atur, masuk dan periksa Bash / PowerShell 7

```bash
openclaw mcp set flashdata '{"url":"https://data.flashdata.dev/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"mcp:research","clientMetadataUrl":"https://api.flashdata.dev/oauth/clients/openclaw.json"}}'
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```


### Remote / API kunci

Buat kunci dengan izin Google Search, atau gunakan ulang satu. Tambahkan server pada pengaturan MCP host Anda dengan menggunakan ruas di bawah ini. Masukkan kunci dalam ruas header terproteksi dan koneksikan kembali; tak ada perintah OAuth yang diperlukan.

#### Pengaturan MCP

```text
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEY
```

- [Buat kunci API](https://flashdata.dev/app/api-keys)

### Lokal / stdio

Memerlukan Node.js 22.18+ dan sebuah API kunci dengan Google Search izin. Merge ini ke dalam host yang mendukung mcpServers JSON. Ganti YOUR_API_KEY dengan konfigurasi lokal yang dilindungi, kemudian restart host. Gunakan npx.cmd pada Windows jika host memerlukan sebuah nama berkas executable.

Paket npm yang disematkan menjalankan server MCP lokal. The standalone FlashData CLI adalah executable terpisah.

#### Konfigurasi MCP

```json
{
  "mcpServers": {
    "flashdata": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=@flashdata-dev/mcp@0.2.0",
        "flashdata-mcp"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

- [Buat kunci API](https://flashdata.dev/app/api-keys)
- [Dokumentasi server lokal](https://github.com/flashdatadev/flashdata-mcp)


<a id="sign-in"></a>

## 2. Periksa sambungan

Kirim ini dalam sesi agen segar. Mengharapkan keberhasilan get_pricing dan panggilan get_balance, harga yang tersedia untuk google_search dan saldo kredit Anda yang tersedia. Nilai nol berarti Anda memerlukan kredit untuk pencarian; itu tidak berarti otentikasi gagal.

### Pemeriksaan koneksi

```text
Gunakan flashdata yang ada koneksi MCP.
Call get_pricing dengan {"source":"google_search","request_count":1}.
Call get_balance dengan {}.
Laporkan apakah kedua panggilan berhasil, apakah sumber memiliki harga yang tersedia,
dan saldo kredit yang tersedia. Sebuah keseimbangan nol bukan sebuah kegagalan otentikasi.
Jangan jalankan pencarian atau unduh, buat uji coba, atau ubah kredensial.
```


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

## 3. Mintalah tugas pertama Anda

Tempel ini ke agen terhubung Anda. Keseimbangan dan cek harga gratis; pencarian menggunakan kredit akun.

### Prompt tugas pertama

```text
Gunakan FlashData untuk memeriksa saldo saya dan harga dari satu Google pencarian. Jika ada cukup kredit, panggil google_search sekali dengan query "battery recycling research", num 5 dan mode "realtime". Judul kembalian, sumber URLs, kutipan pendek dan kredit aktual digunakan. Berhenti setelah tugas ini.
```


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

### Periksa hasil

Agenmu harus mengembalikan link dan kutipan, ditambah kredit yang dipakai. Hasil pencarian yang mendasari telah status: done dan results[].organic. Hasil kosong valid; agen harus melaporkannya. Contoh di bawah ini adalah ilustratif.

#### Jawaban contoh

```text
Selesai satu Google pencarian.
1. Uji ulang baterai - https://example.org/recycling
   Sebuah example excerpt pencarian.
Credits digunakan: 0.02
```


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

## Perkakas yang tersedia

API-key panggilan gunakan hak akses diberikan ke kunci itu. Temukan alat server dan skema masukan untuk katalog sekarang.

| Tugas | Alat | Akses |
| --- | --- | --- |
| Cari Google | google_search | mcp:research / API key |
| Cari video YouTube | youtube_search | mcp:research / API key |
| Baca metadata video | youtube_metadata | mcp:research / API key |
| Ambil takarir yang sudah ada | youtube_transcript | mcp:research / API key |
| Unduh video atau audio | youtube_download | Pemilik API kunci + penyimpanan tujuan |
| Periksa akun dan harga | get_balance, get_pricing, get_limits, get_usage | Rekening bebas dibaca |

- [Semua alat dan parameter](https://flashdata.dev/id/docs/mcp/reference.md#parameters)
- [Unduh setup](https://flashdata.dev/id/docs/guides/youtube-download-guide/reference.md)

<a id="authentication"></a>

## Tentang OAuth, perizinan dan uji coba

OAuth menghubungkan akun pemilik verifikasi Anda dan membiarkan toko host dan token refresh. The mcp:research hibah mencakup empat sumber penelitian di atas. API-key koneksi menggunakan sebuah terproteksi X-API-Key header dan dapat menyertakan sumber-sumber berwenang lainnya.

Untuk mencoba FlashData sebelum membuat akun, gunakan arus percobaan CLI. MCP OAuth menghubungkan sebuah akun pemilik; itu tidak mendaftar atau mengklaim sidang. Profil CLI tidak otomatis dibagikan dengan host MCP Anda.

- [Mulai percobaan agen](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md#access)
- [Klaiming and credential handoff](https://flashdata.dev/id/docs/guides/agent-onboarding/reference.md#claim)
- [Gunakan kembali akses yang disimpan](https://flashdata.dev/id/docs/guides/agent-access/reference.md#refresh)
- [Menghilangkan akses](https://flashdata.dev/id/docs/guides/agent-access/reference.md#revoke)

<a id="errors"></a>

## Permasalahan menarik

| Masalah | Coba ini |
| --- | --- |
| Tidak ada alat FlashData | Selesai persetujuan, menyambung kembali dan memulai sesi baru. Periksa transportasi URL dan Streamable HTTP. |
| invalid_client / callback error | Untuk Codex atau OpenClaw, gunakan konfigurasi klien yang tepat dan peramban yang dapat mencapai callback lokal. Untuk host lain, gunakan yang didukung API-key atau stdio setup di atas. |
| 401 | Rekonnect kadaluwarsa atau dicabut akses OAuth, atau periksa kunci API yang diberikan ke host. Ulangi cek gratis. |
| 403 | Periksa perizinan sumber dan kunci yang diminta. YouTube Download memerlukan pemilik kunci API dengan penyimpanan tujuan youtube_download; mcp:research tidak termasuk. |
| 402 | Periksa Billing dan harga saat ini. Menyambung ulang kredensial yang valid tidak menambah kredit. |
| 429 | Ikuti Retry-After. Simpan pekerjaan yang sudah ada atau hasil ID sebelum memutuskan apakah akan mengulang tugas tersebut. |
| Waktu habis atau respon tidak lengkap | Simpan permintaan ID dan periksa History. Pembacaan large- hasil kelanjutan dengan get_result bukannya mengulangi pencarian. |

- [Billing](https://flashdata.dev/app/billing)
- [Meminta riwayat](https://flashdata.dev/app/jobs)

<a id="client"></a>

## Pergi lebih jauh

- [Buat klien MCP gubahan](https://flashdata.dev/id/docs/guides/mcp-custom-client/reference.md)
- [Codex setup rincian](https://flashdata.dev/id/docs/integrations/codex/reference.md)
- [OpenClaw setup rincian](https://flashdata.dev/id/docs/integrations/openclaw/reference.md)
- [Tugas berkala](https://flashdata.dev/id/docs/guides/recurring-tasks/reference.md)
