# FlashData MCP

Berikan agenmu Google Search dan alat YouTube. Hubungkan hostmu, lalu minta hasil pertamamu.

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

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Server resmi MCP
- [referensi MCP](https://flashdata.dev/ms/docs/mcp/reference.md) — Alat - Alatan, parameter, dan tanggapan
- [Dapatkan kunci API](https://flashdata.dev/app/api-keys) — Untuk host yang menggunakan otentikasi header

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

## 1. Hubungkan dan daftar masuk

Pilih Codex atau OpenClaw untuk OAuth berbasis peramban. Untuk host lain, pilih Kunci Remote / API jika mendukung Streamable HTTP dan header custom, atau Local / stdio jika meluncurkan proses MCP. Server yang dituanrumah tidak memerlukan instalasi lokal.

### Codex

Menggabungkan konfigurasi dibawah ke ~/.codex/config.toml, kemudian jalankan perintah login. Complete FlashData signup atau sign-in dan persetujuan dalam browser. Mulai sesi baru Codex setelah login.

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

#### Log masuk

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


### OpenClaw

Anda menggunakan profil OpenClaw. Signup lengkap atau sign-in dan persetujuan di peramban, kemudian memulai sesi baru. Dokter kuar memeriksa sambungan yang disimpan.

#### Konfigurkan, daftar 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
```


### Kunci jauh / API

Aisex membuat kunci dengan izin Google Search, atau gunakan kembali satu. ** Tambahkan server di host anda ** MCP pengaturan menggunakan bidang di bawah ini. Tidak ada kunci yang melindungi dan menyambung kembali. OAuth Perintah dari X-A diperlukan.

#### Tetapan MCP

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

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

### Ongo / stdio

Kemudi membutuhkan kunci Node.jsQ 22.18+ dan kunci API dengan izin Google Search. Cantumkan ini ke dalam sebuah host yang mendukung mcpServers JSON. Megantikan YOUR_API_KEY dalam konfigurasi terlindungi lokalnya, kemudian memulai ulang host. Use npx.cmd pada Windows jika host memerlukan nama file yang dapat dieksekusi.

Paket npm yang disematkan menjalankan server lokal MCP. İstanonalone FlashData CLI adalah sebuah executable yang 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"
      }
    }
  }
}
```

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


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

## 2. Periksa sambungan

Kirim ini dalam sesi agen baru. Expend sukses get_pricing dan panggilan get_balance, harga yang tersedia untuk google_search dan saldo kredit yang tersedia. Keseimbangan nol berarti Anda membutuhkan kredit untuk pencarian; itu tidak berarti otentikasi gagal.

### Semak sambungan

```text
Guna koneksi flashdata MCP yang sudah ada.
Panggil get_pricing dengan {"source":"google_search","request_count":1}.
Panggil get_balance dengan {}.
Laporan apakah kedua panggilan berhasil, apakah sumber memiliki harga yang tersedia,
Dan saldo kredit yang tersedia. Keseimbangan nol bukanlah kegagalan autentikasi.
Jangan jalankan pencarian atau download, buat sidang, atau ubah kredensial.
```


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

## 3. Mintalah tugas pertamamu

Ini akan ditempelkan ke agenmu. Keseimbangan dan pengenaan cek gratis; pencarian menggunakan kredit akun.

### Promp Tugas pertama

```text
Gunakan FlashData untuk memeriksa saldoku dan harga satu Google pencarian. Jika ada kredit yang cukup, panggil google_searchQ sekali dengan query "battery recycling research", num 5 dan mode "realtime". Gelar Return, sumber URLs, kutipan pendek dan kredit aktual yang digunakan. Berhenti setelah tugas ini.
```


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

### Semak hasil

Agenmu harus mengembalikan sumber link dan kutipan, ditambah kredit yang sebenarnya digunakan. Hasil pencarian tersembunyi telah status: done dan results[].organic. Hasil kosong adalah valid; agen harus melaporkannya. Contoh di bawah ini adalah ilustrasi.

#### Contoh jawaban

```text
Selesai dengan satu pencarian Google.
1. Riset daur ulang baterai, yaitu https://example.org/recycling
   Contoh kutipan pencarian.
Credits digunakan: 0.02
```


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

## Alat-alat yang tersedia

Panggilan API-key menggunakan izin yang diberikan untuk kunci tersebut. Discover alat dan skema masukan server untuk katalog penuh saat ini.

| Task | Alat Fon | Akses |
| --- | --- | --- |
| Cari Google | google_search | mcp:research / API key |
| Cari video YouTube | youtube_search | mcp:research / API key |
| Data meta video Bacaan Data meta baca ika | youtube_metadata | mcp:research / API key |
| Dapatkan gambar - gambar yang ada | youtube_transcript | mcp:research / API key |
| Video atau audio unduhan KUNCI | youtube_download | Kunci API Z Pemilik XQ + penyimpanan tujuan |
| Mengecek dan mengecilkan rekening | get_balance, get_pricing, get_limits, get_usage | Akun gratis dibaca |

- [Semua peralatan dan parameter](https://flashdata.dev/ms/docs/mcp/reference.md#parameters)
- [Persediaan unduhan ROMBOY](https://flashdata.dev/ms/docs/guides/youtube-download-guide/reference.md)

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

## Perihal OAuth, izin dan uji coba

OAuth Dan biarkan toko host dan tokennya disegarkan. hibah mcp:research meliputi keempat sumber penelitian di atas. Sambungan kunci API-key menggunakan header X-API-Key yang dilindungi dan dapat memasukkan sumber lain yang berwenang.

Untuk mencoba FlashData sebelum membuat akun, gunakan aliran uji coba CLI. MCP OAuth menghubungkan akun pemilik; tidak mendaftarkan atau mengklaim pengadilan. Profil CLI tidak secara otomatis dibagikan dengan host MCP anda.

- [\"Memulai pengadilan agen\"](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md#access)
- [Tuntutan klaim dan bukti kelayakan](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md#claim)
- [Memolakure reuse akses tersimpan](https://flashdata.dev/ms/docs/guides/agent-access/reference.md#refresh)
- [Akses Relorge](https://flashdata.dev/ms/docs/guides/agent-access/reference.md#revoke)

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

## Penerjemahan Masalah

| Problem | Cuba ini |
| --- | --- |
| Tak ada alat FlashData | Persetujuan selesai, sambung kembali dan mulai sesi baru. Periksa angkutan URL dan HTTP. |
| invalid_client / callback error | Untuk Codex atau OpenClaw, gunakan konfigurasi kliennya yang tepat dan sebuah peramban yang dapat mencapai callback lokal. Untuk host lain, gunakan API-key atau setup stdio yang didukung di atas. |
| 401 | Putuskan kembali kedaluwarsa atau batalkan akses OAuth, atau periksa kunci API yang diberikan ke host. Ulangi cek gratisnya. |
| 403 | Periksa sumber dan hak kunci yang diminta. YouTube Download Dia membutuhkan pemilik. API Kunci dengan youtube_download Tempat penyimpanan dan destinasi; mcp:research Tidak termasuk ke dalam kata-kata itu. |
| 402 | Periksa Billing dan harga saat ini. Putuskan kembali hubungan kredensial yang sah tidak menambah kredit. |
| 429 | Ikuti Retry-After. ¡Jaga setiap pekerjaan atau hasil yang ada ID sebelum memutuskan apakah akan mencoba kembali tugas tersebut. |
| Penjawaban habis masa kerja atau tidak lengkap | Simpan permintaan ID dan periksa History. Kelanjutan gresult-besar dibaca dengan get_result daripada mengulangi pencarian. |

- [Billing](https://flashdata.dev/app/billing)
- [Sejarah permintaan](https://flashdata.dev/app/jobs)

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

## Teruskan

- [Bina klien MCP suai](https://flashdata.dev/ms/docs/guides/mcp-custom-client/reference.md)
- [Rincian persediaan Codex](https://flashdata.dev/ms/docs/integrations/codex/reference.md)
- [Rincian persediaan OpenClaw](https://flashdata.dev/ms/docs/integrations/openclaw/reference.md)
- [Tugas berulang](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md)
