# Opcje uwierzytelniania agenta

Połącz się z kluczykiem API lub MCP OAuth, weryfikuj dostęp bez płatnego zapytania i używaj go do późniejszych zadań.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/agent-access
Przegląd: 2026-11-05 przez FlashData

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

## 1. Wybierz i podłącz

Już się połączyłeś? Przejdź bezpośrednio do wolnej kontroli w kroku 2. W przeciwnym razie, wybierz dostęp do aplikacji lub agenta potrzebuje.

| Łączysz się | Stosowanie | Kto trzyma wiarygodność? |
| --- | --- | --- |
| Aplikacja, SDK, CLI lub zaplanowany skrypt | Właściciel klucz API | Sklep tajny serwera lub profil CLI |
| Narzędzia badawcze Codex lub OpenClaw | MCP OAuth | Host po uzyskaniu zgody przeglądarki |
| Agent próbujący użyć FlashData bez konta | Tymczasowy klucz API | Agent zachował profil próbny, a potem dostęp do właściciela po stwierdzeniu, że |

### Klawisz API

Utwórz klucz w API Keys ze źródłami, których potrzebujesz lub ponownie użyj istniejącego klucza. Dostarcz go do swojego SDK lub wyślij jako X-API-Key ze swojego backendu. W Bash oraz PowerShell Kontrole stopniowe 2 pracować bezpośrednio z API; nie CLI wymagana jest instalacja.

- [API Keys](https://flashdata.dev/app/api-keys)
- [Zapisz klucz w CLI](https://flashdata.dev/pl/docs/guides/agent-access/reference.md#import-key)
- [Konfiguracja kluczy SDK i HTTP](https://flashdata.dev/pl/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP OAuth

Użyj hosta skonfigurowanego dla FlashData OAuth. Właściciel konta kończy podpisywanie lub podpisywanie i wyraża zgodę w przeglądarce; host zapisuje żetony. To połączenie nie instaluje klucza CLI ani nie rości sobie procesu.

#### Połączenie Hosted MCP

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

- [Połącz Codex](https://flashdata.dev/pl/docs/integrations/codex/reference.md#setup)
- [Połącz OpenClaw](https://flashdata.dev/pl/docs/integrations/openclaw/reference.md#setup)
- [Inni klienci MCP](https://flashdata.dev/pl/docs/integrations/mcp-clients/reference.md#connect)

### Proces w sprawie agenta

Dla agenta bez klucza discover aktualna kwalifikacja próbna przed rejestracją. Ponownie użyj istniejącego procesu i jego profilu. YouTube Download i powtarzające się zadania wymagają dostępu właściciela.

#### Odkryj bez rejestracji

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

- [Rozpocząć proces i wystąpić z nim](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md)
- [Protokół uwierzytelniania agenta](https://flashdata.dev/auth.md)


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

### Z jakich źródeł można korzystać?

Stosowanie X-API-Key dla normy HTTP wnioski oraz API- klucz MCP połączenia. Tokeny na okaziciela OAuth działają tylko w punkcie końcowym MCP. YouTube Download potrzebuje właściciela klucza API z youtube_download i miejsca przeznaczenia.

| Kredytowe | Dostępne źródła |
| --- | --- |
| Właściciel klucz API | Źródła przyznane kluczykowi, w tym youtube_download po zatwierdzeniu. |
| Tymczasowy klucz API | Wyłącznie przyznane źródła kwalifikowane do badania. Odczytywanie sopów z bieżącej odpowiedzi tożsamości. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |


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

### Zapisz klucz w CLI

Pomiń import, jeśli CLI ma już dostęp lub tajny menedżer dostarcza FLASHDATA_API_KEY. W przeciwnym razie należy wybrać metodę poniżej i zachować ten sam profil badań dla późniejszych poleceń. Zapisany klucz CLI nie jest automatycznie dostępny dla SDK lub lokalnych serwerów MCP.

#### Interaktywny terminal

Wklej klucz na ukrytym terminalu.

##### Importuj raz

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


#### Automatyzacja · Bash

Ustaw FLASHDATA_KEY_FILE na ścieżkę istniejącego pliku kluczy chronionych. Polecenie odczytuje go poprzez stdin; nie wpuszczaj klawisza do argumentów czatu i poleceń.

##### Przeczytaj ukryty sekret poprzez stdin

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


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

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

## 2. Weryfikacja połączenia

Uruchom darmowe sprawdzenie w środowisku, które będzie wykonywać zadanie. Sprawdzanie CLI i HTTP używa klucza API; sprawdzanie MCP używa własnego zapisanego połączenia hosta.

### Bash / cURL

Wymaga Bash i cURL 7.76 +. Pomiń ukryty sygnał, jeśli Twoje środowisko już dostarcza FLASHDATA_API_KEY. Uruchom polecenia odczytu w tym samym terminalu.

#### Ustaw klucz · skip, jeśli jest już skonfigurowany

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

#### Czytaj konto 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

Pomiń ukryty sygnał klawisza, jeśli FLASHDATA_API_KEY jest już ustawiony. Uruchom polecenia odczytu w tym samym terminalu.

#### Ustaw klucz · skip, jeśli jest już skonfigurowany

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

#### Czytaj konto 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

Użyj katalogu użytkownika, profilu i stanu OS z logowania. Zastąp badania, jeśli używasz innego profilu; w razie potrzeby dodaj --state-dir PATH. FLASHDATA_API_KEY nadjeżdża zapisany klucz. Oczekuj ok: true i data.accessVerified: true; następnie sprawdź pola identyfikacyjne poniżej.

#### Bezpłatne czytanie konta

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

- [Ustaw klucz](https://flashdata.dev/pl/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP

Wyślij to na nową sesję swojego powiązanego agenta. Zastąp google_search źródłem, którego potrzebujesz. Oczekuj, że oba narzędzia wywołają sukces; sprawdź cenę i równowagę oddzielnie przed płatną pracą. Sam serwer nie weryfikuje dostępu.

#### Kontrola połączenia

```text
Użyj istniejącego połączenia flashdata MCP.
Zadzwoń do get_pricing z {"source":"google_search","request_count":1}.
Zadzwoń do get_balance z {}.
Proszę podać, czy oba połączenia zakończyły się sukcesem, czy źródło ma dostępną cenę,
oraz dostępne saldo kredytowe. Saldo zerowe nie jest wadą uwierzytelniania.
Nie uruchamiaj wyszukiwania ani pobierania, nie twórz prób ani nie zmieniaj referencji.
```



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

### Przeczytaj tożsamość klucza API-

Pola tożsamości HTTP są na najwyższym poziomie. W CLI JSON należy przeczytać data.identity.identity i zażądać data.accessVerified: true. HTTP 200 lub CLI ok: true w monoterapii nie wystarczy.

| Sprawdź | Wymagany wynik |
| --- | --- |
| Przewidywane konto | accountId i apiKeyId identyfikują konto i klucz, którego chcesz użyć. |
| Dostęp możliwy do użycia | access: ready |
| Zezwolenie na zadanie | Szopy zawierają źródło, takie jak google_search. CLI zawiera również listę dozwolonych źródeł w data.identity.permittedSources. |
| Powtarzające się zadanie | accountType: owned · installed: true · recurringAllowed: true |

- [Automatyzacja tych kontroli przed planowaniem](https://flashdata.dev/pl/docs/guides/agent-access/reference.md#recurring-check)

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

### Aktywny proces jest poprawnym połączeniem

Próba może przejść jednorazową kontrolę zadania, podczas gdy recurringAllowed jest false. Przeczytaj rzeczywiste zakresy i wygaśnięcie; zażądać istniejącego procesu przed planowaniem pracy.

#### Tożsamość tymczasowa - pola ilustrujące

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


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

### Znajdź połączenie w Codex

Wymień skonfigurowane serwery, a następnie użyj /mcp w świeżej sesji Codex. Uruchom kontrolę MCP powyżej, aby zweryfikować wiarygodność.

#### Lista serwerów

```bash
codex mcp list
```

- [Konfiguracja Codex i pierwsze zadanie](https://flashdata.dev/pl/docs/integrations/codex/reference.md)

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

### Sprawdź połączenie w OpenClaw

Sprawdź zapisany serwer, a następnie uruchom kontrolę MCP powyżej w aktywnej rozmowie.

#### Sprawdź serwer

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

- [Konfiguracja OpenClaw i pierwsze zadanie](https://flashdata.dev/pl/docs/integrations/openclaw/reference.md)

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

## 3. Ponowne wykorzystanie dostępu do późniejszych zadań

Utrzymuj sklep kredytowy prywatny i trwały w całym procesie restartuje. Recheck dostępu w nowym procesie przed zezwoleniem na terminarza.

| Kredytowe | Do następnego zadania |
| --- | --- |
| Właściciel klucz API | Ponownie użyj zapisanego klucza. Nie posiada żadnego kroku odświeżania OAuth; należy go zastąpić, jeśli wygasł lub został cofnięty. |
| MCP OAuth | Host odświeża jednogodzinne żetony dostępu OAuth za pomocą obrotowych żetonów odświeżających. Uzupełnić po wygaśnięciu lub cofnięciu grantu na dzień 90-. Każda instalacja jest właścicielem sklepu z żetonami; nie udostępniaj plików z symbolami odświeżania pomiędzy hostami. |
| Tymczasowy klucz API | Wykończ właściciela twierdząc i creditial przekazanie przed powtarzającą się pracą. Ponownie użyj oryginalnego profilu; nie rejestruj się ponownie dla każdego uruchomienia. |

- [Powracający przepływ zadań](https://flashdata.dev/pl/docs/guides/recurring-tasks/reference.md)

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

### Zaznacz zadanie CLI przed planowaniem

Wymaga Bash i jq. Ustaw SOURCE na źródło zadania. Skrypt używa badań domyślnie; ustaw FLASHDATA_PROFILE i FLASHDATA_STATE_DIR dla innego profilu lub katalogu stanu. Wyjście 0 z tożsamością JSON oznacza, że klucz właściciela jest gotowy, zainstalowany i dozwolony dla tego źródła. Niech twój terminarz zatrzyma się na każdym innym wyjściu. Nie jest składane żadne zapytanie.

#### Sprawdzanie dostępu do nowego procesu · 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}'
)
```

- [Dodaj cenę, równowagę i powtarzający się biegacz](https://flashdata.dev/pl/docs/guides/recurring-tasks/reference.md#prepare)

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

### Jeśli dostęp jest nadal procesem

Ukończ proces i domagaj się przewodnika z oryginalnym profilem. Po zatwierdzeniu właściciela i przekazaniu uprawnień, bezpłatna kontrola powinna wykazać własny dostęp i recurringAllowed: true. Ciągłe żądania wykorzystują wspólny bilans właściciela; niewykorzystane kredyty próbne nie są przenoszone. MCP OAuth logowanie jest oddzielnym połączeniem i nie rości sobie prawa do tego procesu.

- [Polecenia próbne i roszczenia](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md)
- [auth.md](https://flashdata.dev/auth.md)

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

## Dostęp ponownie

Najpierw przerwij powtarzające się prace. Odnowić dopasowanie funkcji kredytowej poniżej, a następnie powtórzyć bezpłatny czek ze świeżego procesu lub sesji przed oczyszczeniem lokalnego dostępu. Oczekuj awarii uwierzytelniania lub żądania ponownego połączenia; nie zatwierdzaj nowego połączenia podczas sprawdzania. Samodzielne wylogowanie lokalne nie unieważnia dostępu do serwera.

| Połączenie | Gdzie należy odwołać |
| --- | --- |
| MCP OAuth | Settings → Connected apps → grant aplikacji. |
| Zatwierdzony agent API klucz | Settings → Connected apps → Połączenia agentów. |
| Konto API klucz | API Keys → klucz używany przez tę integrację. |

- [Connected apps](https://flashdata.dev/app/settings/connections)
- [API Keys](https://flashdata.dev/app/api-keys)
- [Błędy w dostępie do informacji o problemach](https://flashdata.dev/pl/docs/guides/troubleshooting/reference.md#credentials)

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

## Napraw nieudany sprawdzian

| Wynik | Działanie |
| --- | --- |
| accessVerified: false | Faza odczytu i nextCommand. Profil oczekujący może zwrócić ok: true przed użyciem klucza. Zakończ zapisaną rejestrację lub roszczenie; zachowaj ten sam profil. |
| access: blocked | Przestań nawet jeśli HTTP Odpowiedź na leczenie była 200. Przeglądaj konto lub połączenie w konsoli; nie traktuj odpowiedzi tożsamości jako zgody na zapytanie. |
| accountType: temporary | Korzystaj z próby kwalifikacyjnej w przypadku pracy jednorazowej. Zatwierdź to przed planowaniem; nowe połączenie OAuth nie powoduje powstania tego profilu. |
| installed: false | Po zatwierdzeniu właściciela, uruchom flashdata auth finish --wait z oryginalnym profilem i katalogiem stanu. Więc powtórz czek. |
| 401 / invalid_grant | Przywrócenie wygasłego lub cofniętego kredytu w swoim oryginalnym gospodarzu. Nie rozpoczynaj kolejnego procesu, żeby go obejść. |
| 403 / source_forbidden | Sprawdź w kluczach lub w liście źródłowej OAuth. YouTube Download używa klucza właściciela API. |
| Ważny dostęp, zerowa równowaga | Uwierzytelnienie zadziałało. Zaznacz Billing przed płatną pracą; nie zastępuj poprawnego klucza. |

- [Billing](https://flashdata.dev/app/billing)
- [Odzyskiwanie przerwanego połączenia](https://flashdata.dev/pl/docs/guides/agent-recovery/reference.md)
