# Варіанти ідентифікації агента

З'єднайте з ключем API або MCP OAuth, перевірте доступ без оплаченої запиту, і повторно використовуйте його для пізніше завдань.

Канонічне посилання: https://flashdata.dev/uk/docs/guides/agent-access
Переглянуто: 2026-11-05 від FlashData

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

## 1. Підключіть і підключіть

Вже підключено? Перейдіть прямо до безкоштовної перевірки на крок 2. В іншому випадку виберіть доступ до вашого додатка або агента, який потребує.

| Ви з'єднуєтеся | Зареєструватися | Хто зберігає довіру? |
| --- | --- | --- |
| Додаток, SDK, CLI або плановий скрипт | Власник API ключ | Ваш сервер секретний магазин або CLI профіль |
| Codex або OpenClaw | MCP OAuth | Заява про те, що після узгодження веб-переглядача |
| Агент, який намагається FlashData без облікового запису | Тимчасовий API ключ | Збережений профіль агента, після чого доступ власника після розгляду |

### API ключ

Створіть ключ у API Keys з джерелами, які необхідні для завдання, або повторно використовуйте існуючий ключ. Поставити його на SDK або відправити його як X-API-Key з вашого спина. Bash і PowerShell перевіряється на крок 2 безпосередньо з API; немає установки CLI.

- [API Keys](https://flashdata.dev/app/api-keys)
- [Заощаджуйте ключ в CLI](https://flashdata.dev/uk/docs/guides/agent-access/reference.md#import-key)
- [SDK і HTTP](https://flashdata.dev/uk/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP OAuth

Використовуйте для FlashData OAuth. Власник облікового запису завершує реєстрацію або затвердження та згоду на браузер; господар зберігає токени. Це з'єднання не встановлює ключ CLI або претензії на випробування.

#### Хостований MCP з'єднання

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

- [Підключення Codex](https://flashdata.dev/uk/docs/integrations/codex/reference.md#setup)
- [Підключення OpenClaw](https://flashdata.dev/uk/docs/integrations/openclaw/reference.md#setup)
- [Інші клієнти MCP](https://flashdata.dev/uk/docs/integrations/mcp-clients/reference.md#connect)

### Тестування агента

Якщо агент не має ключа, перед реєстрацією перевірте поточні умови пробного доступу. Повторно використовуйте наявний пробний доступ і його профіль. YouTube Download та регулярні завдання потребують доступу власника.

#### Знайти без реєстрації

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

- [Почати процес і вимагати його](https://flashdata.dev/uk/docs/guides/agent-onboarding/reference.md)
- [Протокол автентифікації агента](https://flashdata.dev/auth.md)


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

### Які джерела можуть використовуватися для цього облікового запису?

Використовуйте X-API-Key для нормальних запитів HTTP та API-ключа MCP. OAuth ведмедики працюють тільки в розміщеному пункті MCP. YouTube Download потребує власника API ключ з youtube_download і зберігання призначення.

| Поведінка | Доступні джерела |
| --- | --- |
| Власник API ключ | Джерела, надані ключем, включаючи youtube_download при затвердженні. |
| Тимчасовий API ключ | Тільки надані джерела даних, що надаються. Читання сфер із відповіді на поточну ідентичність. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |


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

### Заощаджуйте ключ в CLI

Зареєструвати імпорт, якщо CLI вже має доступ або секретний менеджер постачає FLASHDATA_API_KEY. В іншому випадку виберіть метод нижче і зберігайте той самий профіль дослідження для пізніх команд. Увімкнути CLI ключ не автоматично доступний для SDKs або локальних серверів MCP.

#### Інтерактивний термінал

Вставте ключ у прихований термінал підказки.

##### Імпорт

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


#### Автоматизація · Bash

Налаштуйте FLASHDATA_KEY_FILE на шлях існуючого захищеного файлу ключа. Команда читає її через stdin; зберігає ключ від чату і аргументів команд.

##### Читай захищений секрет через 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"
```


- [CLI інсталяція](https://flashdata.dev/uk/docs/guides/flashdata-cli/reference.md#install)

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

## 2. Перевірити підключення

Виконайте безкоштовну перевірку в середовищі, яка буде виконувати завдання. CLI і HTTP перевіряє використання ключа API; перевірка MCP використовує власне збережене з'єднання.

### Bash / cURL

Вимагає Bash і cURL 7.76+. Випробуйте приховану клавішу підказки, якщо ваше оточення вже постачає FLASHDATA_API_KEY. Виконайте дані команди в одному терміналі.

#### Встановити ключ · пропустити, якщо вже налаштовано

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

#### Читання облікового запису 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 вже встановлена. Виконайте дані команди в одному терміналі.

#### Встановити ключ · пропустити, якщо вже налаштовано

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

#### Читання облікового запису 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 користувача, профіль та державне каталог з логіна. Замініть дослідження, якщо ви використовуєте інший профіль; додайте --state-dir PATH, якщо це необхідно. FLASHDATA_API_KEY перенадає збережений ключ. Очікуйте ok: true і data.accessVerified: true; потім перевірте поля ідентичності нижче.

#### Безкоштовні читання облікового запису

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

- [Налаштування ключа](https://flashdata.dev/uk/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP

Надішліть це на свіжу сеанс вашого підключеного агента. Замініть google_search з джерелом ваших потреб. Очікуйте як виклики інструментів, щоб досягти успіху; перевірте ціноутворення та баланс окремо перед оплаченою роботою. Зазначений сервер невірний доступ.

#### Перевірка підключення

```text
Використовуйте існуючі флешки MCP з'єднання.
Зателефонуйте get_pricing з {"source":"google_search","request_count":1}.
Зателефонуйте get_balance з {}.
Повідомляємо, чи є у вас вихідне джерело,
і наявний кредитний баланс. Нульовий баланс не є автентифікаційною недостатністю.
Не запустіть пошук або завантажити, створіть пробну або змінну облікові дані.
```



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

### Читати стиль API-key

HTTP на рівні вершини. У CLI JSON читайте data.identity.identity і вимагають data.accessVerified: true. HTTP 200 або CLI ok: true окремо не вистачає.

| Про нас | Потрібні результати |
| --- | --- |
| Зареєстрований рахунок | accountId і apiKeyId виявляти обліковий запис і ключ, який ви означали, щоб використовувати. |
| Доступний доступ | access: ready |
| Дозвіл на роботу | Сфера містить джерело, такі як google_search. CLI також списує дозволені джерела в data.identity.permittedSources. |
| Задача задач | accountType: owned · installed: true · recurringAllowed: true |

- [Автоматизувати ці перевірки перед складанням](https://flashdata.dev/uk/docs/guides/agent-access/reference.md#recurring-check)

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

### Активна пробна версія є дією з'єднання

Тест може пройти перевірку задачі з одностороннім інтервалом, коли recurringAllowed є false. Прочитати існуючу пробну роботу перед складанням роботи.

#### Тимчасова ідентичність · ілюстраційні поля

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


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

### Знайдіть підключення до Codex

Список налаштованих серверів, після чого використовуйте /mcp в свіжому форматі Codex. Запустіть перевірку MCP вище, щоб перевірити достовірність.

#### Статус на сервери

```bash
codex mcp list
```

- [Налаштування Codex і перше завдання](https://flashdata.dev/uk/docs/integrations/codex/reference.md)

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

### Перевірити підключення в OpenClaw

Зроби збережений сервер, потім запустіть MCP перевірте вище у вашій активної розмові.

#### Пробе сервер

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

- [Налаштування OpenClaw і перше завдання](https://flashdata.dev/uk/docs/integrations/openclaw/reference.md)

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

## 3. Запобігання доступу до пізніших завдань

Зберігати власний і стійкий до перезаряджання процесу. Перевірити доступ до свіжого процесу перед тим, як забезпечити ваш планувальник.

| Поведінка | Для наступного завдання |
| --- | --- |
| Власник API ключ | Зловживання збереженим ключем. Не має OAuth освіжаючий крок; замініть його, якщо вибухнув або відкликається. |
| MCP OAuth | За допомогою обертальних освіжувальних жетонів запроваджують токени OAuth. Від'єднатися, коли Гарантований сертифікат 90-день або відкликається. Кожна інсталяція має власний токеновий магазин; не діляться освіжаючими файлами між хостами. |
| Тимчасовий API ключ | Оздоблення власника, що вимагає та достовірного відключення перед рецидивною роботою. За допомогою оригінального профілю не потрібно реєструвати ще раз. |

- [Відшкодування задачі](https://flashdata.dev/uk/docs/guides/recurring-tasks/reference.md)

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

### Перевірити завдання CLI перед складанням

Вимагає Bash і jq. Встановити SOURCE до джерела задачі. Скрипт використовує дослідження за замовчуванням; встановити FLASHDATA_PROFILE і FLASHDATA_STATE_DIR для різних профілів або державного каталогу. Випадковий 0 з ідентичністю JSON – ключ власника, встановленого та допущеним для цього джерела. Зареєструйтеся на будь-який інший виїзд. Немає запиту.

#### Перевірка доступу до Fresh-process · 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}'
)
```

- [Додайте ціни, баланс та повторюваний бігун](https://flashdata.dev/uk/docs/guides/recurring-tasks/reference.md#prepare)

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

### Якщо доступ досі пробний

Пройдіть інструкцію з пробного доступу та прив’язування з початковим профілем. Після схвалення власником і передачі облікових даних безкоштовна перевірка має показати owned та recurringAllowed: true. Подальші запити використовують спільний баланс власника; невикористані пробні кредити не переносяться. Вхід MCP OAuth створює окреме підключення й не прив’язує цей пробний доступ.

- [Команди пробного доступу та прив’язування](https://flashdata.dev/uk/docs/guides/agent-onboarding/reference.md)
- [auth.md](https://flashdata.dev/auth.md)

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

## Відновити доступ

Запобігання повторної роботи першим. Відновити відповідні дані нижче, потім повторити безкоштовну перевірку з свіжого процесу або сеансу перед очищенням місцевого доступу. Визначте відмову від автентифікації або запит про відключення; не затверджуйте нове з'єднання під час перевірки. Місцевий логотип не відкликає доступ до сервера.

| З'єднання | Де відкликати |
| --- | --- |
| MCP OAuth | Settings → Connected apps → грант програми. |
| Claimed агент API ключ | Settings → Connected apps → Зв'язки агента. |
| Рахунок API ключ | API Keys → ключ, який використовується цією інтеграцією. |

- [Connected apps](https://flashdata.dev/app/settings/connections)
- [API Keys](https://flashdata.dev/app/api-keys)
- [Виправлення помилок доступу](https://flashdata.dev/uk/docs/guides/troubleshooting/reference.md#credentials)

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

## Виправлення недійсної перевірки

| Поповнення | Дія |
| --- | --- |
| accessVerified: false | Поточна фаза та nextCommand. Закінчений профіль може повернути ok: true перед ключем. Оздоблення збереженої реєстрації або позову; зберігати той самий профіль. |
| access: blocked | Якщо відповідь HTTP була 200. Перегляд облікового запису або підключення в консолі; не лікуйте відповіді на особистість як дозвіл на запит. |
| accountType: temporary | Використовуйте правовий тест для однієї роботи. Клайміть його перед складанням; новий з'єднання OAuth не претендує на цей профіль. |
| installed: false | Після затвердження власника, запустіть флешки auth finish --wait з оригінальним профільом та державним каталогом. Після чого повторюємо перевірку. |
| 401 / invalid_grant | Від'єднайте відірваний або відкликаний кримінал у своєму оригінальному господарстві. Не запустіть чергову пробну версію, щоб обійти її. |
| 403 / source_forbidden | Перевірити ключові обсяги або OAuth YouTube Download використовує власника API ключ. |
| Дійсний доступ, нульовий баланс | Аутентифікація працювала. Перевірити Billing перед платною роботою; не замінити дійсний ключ. |

- [Billing](https://flashdata.dev/app/billing)
- [Відновити переривання з'єднання](https://flashdata.dev/uk/docs/guides/agent-recovery/reference.md)
