# FlashData MCP

Ajan Google Search ve YouTube araçlarınızı verin. Ev sahibine bağlan, sonra ilk sonucunuzu isteyin.

Canonical referans: https://flashdata.dev/tr/docs/integrations/mcp-clients
İnceleme: 2026-11-05 Tarafından FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Resmi MCP server
- [MCP referans](https://flashdata.dev/tr/docs/mcp/reference.md) — Araçlar, parametreler ve cevaplar
- [API anahtarı alın](https://flashdata.dev/app/api-keys) — Bu kullanım başlığı kimlik doğrulamasını sağlayan ev sahipleri için

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

## 1. Connect ve işaret

Codex veya OpenClaw'u tarayıcı tabanlı OAuth için seçin. Başka bir ev sahibi için, API anahtarını Streamable HTTP ve özel başlıkları veya Local / stdio'yu başlatırsa MCP süreçleri başlatır. Ev sahibi sunucunun yerel bir kuruluma ihtiyacı yoktur.

### Codex

Aşağıdaki yapılandırın -/.codex/config.toml, sonra giriş komutunu çalıştırın. FlashData işareti veya işaret-in ve tarayıcıda onay. Giriş yaptıktan sonra taze bir Codex seansı başlayın.

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

#### Giriş yap

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


### OpenClaw

Bu komutları OpenClaw profilinde çalıştırın. Tarayıcıda tam işaret veya işaret-in ve onay, sonra taze bir seans başlatır. Doktor probe, kurtarılan bağlantıyı kontrol eder.

#### Tanımlama, işaret ve kontrol edin · 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
```


### Uzak / API anahtarı

Google Search izni ile anahtar oluşturun veya bir tane yeniden kullanın. Ev sahibinizin MCP ayarlarını aşağıdaki alanları kullanarak bir sunucu ekleyin. Korumalı başlık alanında anahtarı koyun ve yeniden bağlantı kurun; OAuth komutuna gerek yok.

#### MCP ayarları

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

- [Bir API anahtarı oluşturun](https://flashdata.dev/app/api-keys)

### Local / stdio

Node.js 22.18+ ve API anahtarı ile Google Search izni gerekir. Bu, mcpServers JSON'u destekleyen bir ev sahibine. YOUR_API_KEY'u yerel korunan konfigürasyonunda değiştirin, sonra ev sahibi yeniden başlayın. npx.cmd'u Windows'de kullanın, ev sahibinin eklenebilir bir dosya adı gerektirdiği takdirde.

pinned npm paketi yerel MCP sunucuyu çalıştırıyor. The standalone FlashData CLI ayrı bir executable.

#### MCP yapılandırma

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

- [Bir API anahtarı oluşturun](https://flashdata.dev/app/api-keys)
- [Yerel sunucu belgeleri](https://github.com/flashdatadev/flashdata-mcp)


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

## 2. Bağlantıyı kontrol edin

Bunu taze bir ajan oturumunda gönderin. Başarılı get_pricing ve get_balance çağrılarını bekleyin, google_search ve mevcut kredi bakiyeniz için mevcut bir fiyat. Sıfır bir denge, arama için kredilere ihtiyacınız olduğu anlamına gelir; doğrulama başarısız anlamına gelmez.

### Bağlantı kontrolü

```text
Mevcut flashdata MCP bağlantısını kullanın.
get_pricing ile {"source":"google_search","request_count":1}'u arayın.
get_balance ile {}'u arayın.
Her iki aramanın başarılı olup olmadığını rapor edin, kaynağın mevcut bir fiyat olup olmadığını,
Ve mevcut kredi dengesi. Sıfır bir denge bir doğrulama başarısızlığı değildir.
Bir arama veya indirme çalıştırmayın, bir deneme oluşturun veya kimlik değiştirir.
```


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

## 3. İlk göreviniz için sorun

Bunu bağlı ajanınıza yapıştırın. Denge ve fiyat kontrolleri ücretsizdir; arama hesap kredilerini kullanır.

### İlk görev hızlı

```text
FlashData'i dengemi kontrol etmek ve bir Google arama fiyatı kullanın. Eğer yeterli kredi varsa, google_search ile bir kez sorgu "battery recycling research", num 5 ve mod "realtime". Geri dönüş başlıkları, kaynak URLs, kısa alıntılar ve gerçek krediler kullanılır. Bu görevden sonra durun.
```


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

### Sonucu kontrol edin

Ajanınız kaynak bağlantılarını ve alıntılarını geri getirmelidir, artı kullanılan gerçek krediler. Temel arama sonucu status: done ve results[].organic. Boş bir sonuç geçerlidir; ajan bunu rapor etmelidir. Aşağıdaki örnek, açıklayıcıdır.

#### Örnek cevap

```text
Tamamlanan bir Google arama.
1. Battery geri dönüşüm araştırmaları - https://example.org/recycling
   Bir örnek arama bölümü.
Krediler kullanılır: 0.02
```


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

## Mevcut aletler

API-key aramaları bu anahtara verilen izinleri kullanır. Tüm mevcut katalog için sunucunun araçlarını ve giriş şemalarını keşfedin.

| Görev Görev Görevi | Tool Tool Tool | Erişim |
| --- | --- | --- |
| Arama Google | google_search | mcp:research / API key |
| YouTube videoları bulun | youtube_search | mcp:research / API key |
| Video metadata | youtube_metadata | mcp:research / API key |
| Mevcut komutlar erişim | youtube_transcript | mcp:research / API key |
| Video veya ses indir | youtube_download | Sahibi API anahtar + hedef depolama |
| Check account and pricing | get_balance, get_pricing, get_limits, get_usage | Ücretsiz hesap okur |

- [Tüm araçlar ve parametreler](https://flashdata.dev/tr/docs/mcp/reference.md#parameters)
- [Download kurulumu](https://flashdata.dev/tr/docs/guides/youtube-download-guide/reference.md)

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

## OAuth hakkında, izinler ve denemeler

OAuth doğrulanmış sahibi hesabınızı birleştirir ve ev sahibi mağazayı ve yeni jetonları yenilemenize izin verir. mcp:research hibe yukarıdaki dört araştırma kaynağını kapsar. API-key bağlantıları korumalı bir X-API-Key başlığı kullanıyor ve diğer yetkili kaynakları da içerebilir.

FlashData'u bir hesap oluşturmadan önce denemek için, CLI deneme akışını kullanın. MCP OAuth bir sahibi hesabı bağlar; bir deneme kaydetme veya iddia etmez. A CLI profili otomatik olarak MCP host ile paylaşılmaz.

- [Bir ajan denemesine başlayın](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md#access)
- [Talep ve tahrif etmek](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md#claim)
- [Reuse save access access](https://flashdata.dev/tr/docs/guides/agent-access/reference.md#refresh)
- [Revoke access](https://flashdata.dev/tr/docs/guides/agent-access/reference.md#revoke)

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

## Sorun Giderme

| Problem Sorun Problem Problem Problem | Bunu dene |
| --- | --- |
| FlashData aletleri | Bitirme, yeniden bağlantı kurmak ve taze bir seansa başlayın. URL ve Streamable HTTP taşımasını kontrol edin. |
| invalid_client / callback error | Codex veya OpenClaw için, yerel çağrıya ulaşabilen tam müşteri yapılandırmasını ve bir tarayıcıyı kullanın. Başka bir ev sahibi için, desteklenen API-key veya stdio kurulumunu yukarıda kullanın. |
| 401 | Yeniden bağlantı sona ermiş veya OAuth erişimi iptal edildi veya ev sahibine verilen API anahtarını kontrol edin. Ücretsiz çeki tekrarlayın. |
| 403 | Talep edilen kaynağı ve anahtar izinleri kontrol edin. YouTube Download Bir sahibin bir sahibi gerektirir API anahtarla anahtarla youtube_download Hedef depolama; mcp:research Buna dahil değildir. |
| 402 | Billing ve mevcut fiyat kontrol edin. Geçerli bir credential ile bağlantı kurmak kredi eklemez. |
| 429 | Retry-After'u izleyin. Mevcut herhangi bir iş tutun veya görevi yeniden denemeyi karar vermeden önce ID'yu sonuçlayın. |
| Zamanout veya eksik cevap | ID'u talep edin ve History'u kontrol edin. Aramayı tekrarlamak yerine get_result ile büyük devamları okuyun. |

- [Billing](https://flashdata.dev/app/billing)
- [Tarih İstek Tarihi](https://flashdata.dev/app/jobs)

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

## Daha da ileri git

- [Özel bir MCP müşteri oluşturun](https://flashdata.dev/tr/docs/guides/mcp-custom-client/reference.md)
- [Codex kurulum detayları](https://flashdata.dev/tr/docs/integrations/codex/reference.md)
- [OpenClaw kurulum detayları](https://flashdata.dev/tr/docs/integrations/openclaw/reference.md)
- [Yinelenen görevler](https://flashdata.dev/tr/docs/guides/recurring-tasks/reference.md)
