# Ajan kimlik doğrulama seçenekleri

Bir API anahtarı veya MCP OAuth ile bağlantı kurmak, ücretli bir sorgu olmadan erişimi doğrulamak ve daha sonra görevleri için yeniden kullanın.

Canonical referans: https://flashdata.dev/tr/docs/guides/agent-access
İnceleme: 2026-11-05 Tarafından FlashData

<a id="access"></a>

## 1. seçin ve bağlantı kurun

Zaten bağlantılı mı? 2'un adımda ücretsiz kontrole gidin. Aksi takdirde, uygulamanızın veya acentenizin ihtiyaç duyduğu erişimi seçin.

| Bağlanıyorsunuz | Kullanım | Kim haçlı tutar? |
| --- | --- | --- |
| Bir uygulama, SDK, CLI veya planlanan senaryo | Sahibi API anahtarı | Sunucunuzun gizli mağazası veya CLI profili |
| Codex veya OpenClaw araştırma araçları | MCP OAuth | Tarayıcı onayından sonra ev sahibi |
| FlashData'u bir hesap olmadan çalışan bir ajan | Geçici API anahtarı | Ajanın kurtarılmış deneme profili, daha sonra sahibine iddia edildikten sonra erişim |

### API anahtarı

API Keys bölümünde görevin gerektirdiği kaynaklara erişen bir anahtar oluşturun veya mevcut anahtarı kullanın. Anahtarı SDK ortamına sağlayın ya da backend üzerinden X-API-Key başlığıyla gönderin. Adım 2 içindeki Bash ve PowerShell kontrolleri doğrudan API ile çalışır; CLI kurulumu gerekmez.

- [API Keys](https://flashdata.dev/app/api-keys)
- [CLI'da bir anahtar tasarruf edin](https://flashdata.dev/tr/docs/guides/agent-access/reference.md#import-key)
- [SDK ve HTTP anahtar kurulum](https://flashdata.dev/tr/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP OAuth

FlashData OAuth için ev sahibi bir yapılandırın. Hesap sahibi tarayıcıda imza veya imzayı tamamlar ve onay alır; ev sahibi jetleri kurtarır. Bu bağlantı bir CLI anahtarı yüklemez veya bir deneme iddia etmez.

#### Hosted MCP bağlantı

```text
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:research
```

- [Connect Connect Codex](https://flashdata.dev/tr/docs/integrations/codex/reference.md#setup)
- [Connect Connect OpenClaw](https://flashdata.dev/tr/docs/integrations/openclaw/reference.md#setup)
- [Diğer MCP müşterileri](https://flashdata.dev/tr/docs/integrations/mcp-clients/reference.md#connect)

### Agent deneme

Anahtarsız bir ajan için, discover, kayıt yapmadan önce mevcut dava uygunluk. Mevcut bir denemeyi ve profilini yeniden kullanın. YouTube Download ve tekrarlanan görevler sahibi erişim gerektirir.

#### Kayıt olmadan Keşfet

```bash
flashdata discover --profile research --json
```

- [Bir deneme başlatın ve iddia](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md)
- [Agent doğrulama protokolü](https://flashdata.dev/auth.md)


<a id="permissions"></a>

### Hangi kaynaklar bu credential kullanımı olabilir?

Use Use Use X-API-Key Normal için normal HTTP Talepler ve talepler API-key MCP bağlantılar. OAuth ayıcı jetonlar sadece ev sahipliğinde çalışır MCP endpoint. YouTube Download Bir sahibine ihtiyacı var API anahtarı ile anahtar youtube_download ve varış depolama.

| Credential | Mevcut kaynaklar |
| --- | --- |
| Sahibi API anahtarı | youtube_download dahil anahtara verilen kaynaklar onaylandığında. |
| Geçici API anahtarı | Yalnızca izin verilmiş ve denemeye uygun kaynaklar kullanılabilir. Güncel kimlik yanıtındaki scopes alanını okuyun. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |


<a id="import-key"></a>

### CLI'da bir anahtar tasarruf edin

CLI'un zaten eriştiği veya gizli yöneticinizin FLASHDATA_API_KEY'ye sahip olup olmadığını ithal edin. Aksi takdirde, aşağıdaki bir yöntem seçin ve daha sonra komutlar için aynı araştırma profili tut. Kurtarılan CLI anahtarı otomatik olarak SDK veya yerel MCP sunucular için mevcut değildir.

#### Etkileşimli terminal

Gizli terminalde anahtarı yapıştırın.

##### Bir kez ithalat bir kez

```bash
flashdata auth login --profile research
```


#### Otomasyon · Bash

FLASHDATA_KEY_FILE'u mevcut korumalı bir anahtar dosyasının yolunda ayarlayın. Komut bunu stdin aracılığıyla okur ve komuta tartışmalarının anahtarıyla okur.

##### stdin aracılığıyla korunan bir sırrı okuyun

```bash
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
  < "$FLASHDATA_KEY_FILE"
```


- [CLI installation](https://flashdata.dev/tr/docs/guides/flashdata-cli/reference.md#install)

<a id="verify"></a>

## 2. Bağlantıyı doğrulayın

Görevi yapacak çevrede ücretsiz kontrol yapın. CLI ve HTTP checks bir API anahtarı kullanıyor; MCP check, ev sahibinin kendi kurtarılmış bağlantısını kullanıyor.

### Bash / cURL

Bash ve cURL 7.76+'yı gerektirir. Çevrenizin zaten FLASHDATA_API_KEY'u tedarik etmesi durumunda gizli anahtarı yazın. Aynı terminaldeki okuma komutlarını çalıştırın.

#### Anahtarı ayarlayın · zaten yapılandırılırsa atlayın

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

#### Hesap JSON

```bash
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)
```


### PowerShell 7

FLASHDATA_API_KEY'un zaten ayarlandığı gizli anahtara girin. Aynı terminaldeki okuma komutlarını çalıştırın.

#### Anahtarı ayarlayın · zaten yapılandırılırsa atlayın

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

#### Hesap JSON

```powershell
& {
  $ErrorActionPreference = 'Stop'
  if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
    throw 'Set FLASHDATA_API_KEY first'
  }
  $flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
  $flashdataBase = 'https://api.flashdata.dev/v2'
  $flashdataUri = "$flashdataBase/api-access/identity"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```


### CLI

OS kullanıcısını, profil ve eyalet dizilerini girişten kullanın. Başka bir profil kullanıyorsanız araştırmayı değiştirin; gerekirse --state-dir PATH ekleyin. FLASHDATA_API_KEY, kurtarılan anahtarın üstüne çıktı. ok: true ve data.accessVerified: true; sonra aşağıdaki kimlik alanlarını inceler.

#### Ücretsiz hesap okur

```bash
flashdata auth status --profile research --json --non-interactive
```

- [Bir anahtar oluşturun](https://flashdata.dev/tr/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP

Bunu, bağlı ajanınızın taze bir seansına gönderin. google_search'u görev ihtiyaçlarınızla değiştirin. Her iki aracın başarılı olmasını bekleyin; ücretli işten önce fiyat ve dengeyi kontrol edin. Listelenen bir sunucu sadece erişim doğrulamaz.

#### 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="identity-result"></a>

### API-key kimliğini okuyun

HTTP kimlik alanları en üst seviyededir. CLI JSON, data.identity.identity'u okuyun ve data.accessVerified: true'u gerektirir. HTTP 200 veya CLI ok: true tek başına yeterli değildir.

| Kontrol | Gerekli sonuç |
| --- | --- |
| Intended account | accountId ve apiKeyId, kullanmak istediğiniz hesabı ve anahtarını tanımlar. |
| Kullanılabilir erişim | access: ready |
| Görev izni | Kapsam google_search gibi kaynak içerir. CLI Ayrıca izin verilen kaynakları listeler data.identity.permittedSources. |
| Görevi Yeniden Değerlendirme | accountType: owned · installed: true · recurringAllowed: true |

- [Automate bu çekleri zamanlamadan önce](https://flashdata.dev/tr/docs/guides/agent-access/reference.md#recurring-check)

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

### Aktif bir deneme geçerli bir bağlantıdır

Bir deneme, bir çıkış görevi kontrolünü geçebilirken recurringAllowed Is is is is Is is Is Is is'dir. false. Gerçek kapsamı ve expiry'yi okuyun; mevcut davayı planlamadan önce iddia edin.

#### Geçici kimlik · illüstrasyonel alanlar

```json
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}
```


<a id="codex"></a>

### Codex ile bağlantıyı bulun

Liste yapılandırılmış sunucular, sonra /mcp'u taze bir Codex seansında kullanın. MCP check yukarıda haçlıyı doğrulamak için kontrol edin.

#### Liste sunucuları

```bash
codex mcp list
```

- [Codex kurulumu ve ilk görev](https://flashdata.dev/tr/docs/integrations/codex/reference.md)

<a id="openclaw"></a>

### OpenClaw ile bağlantıyı kontrol edin

Daha sonra MCP'u aktif konuşmanızda kontrol edin.

#### Probe the server

```bash
openclaw mcp doctor flashdata --probe
```

- [OpenClaw kurulumu ve ilk görev](https://flashdata.dev/tr/docs/integrations/openclaw/reference.md)

<a id="refresh"></a>

## 3. Daha sonraki görevler için yeniden kullanım erişim

Süreç boyunca özel ve kalıcı olan credential store'ı devam ettirin. Programcınıza izin vermeden önce taze bir süreçte erişim.Recheck access in a fresh process before  enable your scheduler.

| Credential | Bir sonraki görev için |
| --- | --- |
| Sahibi API anahtarı | Kurtarılan anahtarı yeniden kullanın. OAuth yenilenme adımına sahip değil; süresiz veya iptal edilirse değiştirin. |
| MCP OAuth | Ev sahibi bir saat OAuth erişim jetleri geri dönüş jetleri kullanarak. 90-day hibesi sona erdiğinde veya iptal edilir. Her yüklemenin token mağazasına sahiptir; ev sahipleri arasındaki yeni-token dosyaları paylaşmayın. |
| Geçici API anahtarı | Tekrarlanan çalışmadan önce son sahibi iddia etti ve haçlı eloff. Orijinal profili yeniden kullanın; her biri için tekrar kayıt yapmayın. |

- [Görev iş akışını yeniden değerlendir](https://flashdata.dev/tr/docs/guides/recurring-tasks/reference.md)

<a id="recurring-check"></a>

### Bir CLI görevini planlamadan önce kontrol edin

Bash ve jq'u gerektirir. Görev kaynağına SOURCE'yi ayarlayın. Senaryo, varsayılan olarak araştırma kullanır; FLASHDATA_PROFILE ve FLASHDATA_STATE_DIR'u farklı bir profil veya eyalet rehberi için ayarlar. 0 ile kimlik JSON, sahibinin anahtarı hazır ve bu kaynak için izin verilen anlamına gelir. Planlayıcınız başka bir çıkışta durur. Hiçbir sorgu gönderilemez.

#### Taze işlem erişim kontrolü · Bash

```bash
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
  args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi

flashdata auth status "${args[@]}" |
  jq -e --arg source "$SOURCE" '
    select(.ok == true and .data.accessVerified == true)
    | .data.identity as $auth
    | $auth.identity
    | select(.accountType == "owned" and .access == "ready"
        and .installed == true and .recurringAllowed == true
        and ((.scopes // []) | index($source) != null)
        and (($auth.permittedSources // []) | index($source) != null))
    | {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)
```

- [Fiyat ekle, denge ve tekrarlanan bir koşucu](https://flashdata.dev/tr/docs/guides/recurring-tasks/reference.md#prepare)

<a id="claim"></a>

### Eğer erişim hala bir denemedir

Denemeyi tamamlayın ve orijinal profili ile rehberi iddia edin. Sahibi onayı ve haçlı eloff sonra, ücretsiz kontrol erişim ve recurringAllowed: true göstermeli. Devamlı istekler, sahibinin paylaşılan bakiyesini kullanır; kullanılmamış deneme kredileri transfer edilmez. MCP OAuth login ayrı bir bağlantıdır ve bu denemeyi iddia etmez.

- [Deneme ve iddia komutları](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md)
- [auth.md](https://flashdata.dev/auth.md)

<a id="revoke"></a>

## Revoke access

Pause ilk önce işleri tekrarladı. Aşağıdaki eşleşen haçlılığı geri alın, ardından yerel erişimi temizlemekten önce taze bir süreçten veya seanstan ücretsiz check'i tekrarlayın. Onaylama başarısızlığı veya yeniden bağlantı isteği; check sırasında yeni bir bağlantı onaylama. Yerel logout tek başına sunucu erişimini geri çevirmez.

| Bağlantı Bağlantısı | Nereden geri dönecek |
| --- | --- |
| MCP OAuth | Settings → Connected apps → Uygulamanın hibesi. |
| Davalı ajan API anahtarı | Settings → Connected apps → Ajan bağlantıları. |
| Hesap API anahtarı | API Keys → Bu entegrasyon tarafından kullanılan anahtar. |

- [Connected apps](https://flashdata.dev/app/settings/connections)
- [API Keys](https://flashdata.dev/app/api-keys)
- [Problemshoot erişim hataları](https://flashdata.dev/tr/docs/guides/troubleshooting/reference.md#credentials)

<a id="fixes"></a>

## Başarısız bir çek

| Sonuç Sonuç Sonuç | Action Action Action |
| --- | --- |
| accessVerified: false | faz ve nextCommand. Beklenmeyen bir profil ok: true'yu anahtardan önce geri döndürebilir. Kurtarılan kayıt veya iddiasını bitirin; aynı profili tut. |
| access: blocked | HTTP cevabı 200 idiyse bile durdurun. Konsoldaki hesabı veya bağlantıyı gözden geçirin; sorguya izin verilen bir kimlik yanıtı tedavi etmeyin. |
| accountType: temporary | Bir çıkış çalışması için uygun denemeyi kullanın. Bunu planlamadan önce talep edin; yeni bir OAuth bağlantısı bu profili iddia etmiyor. |
| installed: false | Sahibi onayından sonra, flashdata auth finish --wait'u orijinal profil ve eyalet rehberi ile çalıştırın. Sonra kontrolü tekrarlayın. |
| 401 / invalid_grant | Yeniden, kendi orijinal ev sahibindeki sınırsız veya geri dönüşlü haçlı haçlı ile bağlantı kurun. Onu atlamak için başka bir deneme başlatmayın. |
| 403 / source_forbidden | Anahtarın kapsamını veya OAuth kaynak listesini kontrol edin. YouTube Download, bir sahibi API anahtar kullanır. |
| Geçerli erişim, sıfır denge | Kimlik doğrulama çalıştı. Billing'u ücretli çalışmadan önce kontrol edin; geçerli bir anahtarı değiştirmeyin. |

- [Billing](https://flashdata.dev/app/billing)
- [Bir kesinti bağlantısını yeniden keşfedin](https://flashdata.dev/tr/docs/guides/agent-recovery/reference.md)
