# エージェント認証オプション

APIキーまたはMCP OAuthと接続し、有料のクエリなしでアクセスを検証し、後でタスクのために再利用します。

キャニシニカル参照: https://flashdata.dev/ja/docs/guides/agent-access
レビュー: FlashData による 2026-11-05

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

## 1. 選択し、接続して下さい

既に接続されているか? Goは、ステップ2で無料チェックにストレート。 それ以外の場合は、アプリケーションまたはエージェントのニーズへのアクセスを選択します。

| 接続する | 利用条件 | 誰がクレデンシャルを保ちますか? |
| --- | --- | --- |
| アプリケーション、SDK、CLI、またはスケジュールされたスクリプト | 所有者 API キー | サーバの秘密ストアやCLIのプロファイル |
| Codex または OpenClaw リサーチツール | MCP OAuth | ブラウザの同意後ホスト |
| アカウントなしでFlashDataを試すエージェント | 一時的なAPIのキー | エージェントの保存されたトライアルプロファイルは、主張した後、所有者のアクセス |

### APIキー

API Keys でタスクに必要なソースの権限を持つキーを作成するか、既存のキーを再利用してください。SDK に渡すか、バックエンドから X-API-Key として送信します。手順 2 の Bash と PowerShell の確認コマンドは API を直接呼び出すため、CLI のインストールは不要です。

- [API Keysの特長](https://flashdata.dev/app/api-keys)
- [CLIでキーを保存](https://flashdata.dev/ja/docs/guides/agent-access/reference.md#import-key)
- [SDKおよびHTTPのキーの組み立て](https://flashdata.dev/ja/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/ja/docs/integrations/codex/reference.md#setup)
- [OpenClawを接続して下さい](https://flashdata.dev/ja/docs/integrations/openclaw/reference.md#setup)
- [その他のMCPクライアント](https://flashdata.dev/ja/docs/integrations/mcp-clients/reference.md#connect)

### エージェントトライアル

鍵のないエージェントの場合、discover は登録前の現在の試験の適格性です。 既存のトライアルとそのプロファイルを再利用します。 YouTube Download と再発タスクは、所有者のアクセスが必要です。

#### 登録せずに発見

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

- [トライアルを開始し、それを主張する](https://flashdata.dev/ja/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 は youtube_download および保存先が付いている所有者 API のキーを必要とします。

| 資格情報 | 利用可能なソース |
| --- | --- |
| 所有者 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キーはSDKやローカル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/ja/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 を期待し、下にある ID フィールドを調べます。

#### 無料アカウントの読み込み

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

- [キーを設定する](https://flashdata.dev/ja/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP

接続されたエージェントの新鮮なセッションにこれを送信します。 google_search を、タスクのニーズをソースに置き換えます。 両方のツール呼び出しを成功させる; 有料の作業の前に個別に価格設定と残高をチェック. リストされたサーバーのみがアクセスを検証しません。

#### 接続チェック

```text
既存の Flashdata MCP 接続を使用してください。
get_pricing と {"source":"google_search","request_count":1} を呼び出します。
get_balance と {} を呼び出します。
ソースが利用可能な価格を持っているかどうか、両方の呼び出しが成功しているかどうかを報告します。
利用可能なクレジット残高。 ゼロバランスは認証障害ではありません。
検索を実行したり、ダウンロードしたり、トライアルを作成したり、資格情報を変更したりしないでください。
```



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

### APIキーのアイデンティティを読みます

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/ja/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/ja/docs/integrations/codex/reference.md)

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

### OpenClawの接続を確認してください

保存されたサーバーをプローブし、MCP チェックを実行して、アクティブな会話で実行します。

#### サーバをプローブする

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

- [OpenClawセットアップと最初のタスク](https://flashdata.dev/ja/docs/integrations/openclaw/reference.md)

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

## 3. 後続タスクへのアクセスを再利用する

プロセスを再起動して、クレデンシャルストアをプライベートかつ持続的に保持します。 スケジュールを有効にする前に、新しいプロセスでアクセスをリセットします。

| 資格情報 | 次のタスクのために |
| --- | --- |
| 所有者 API キー | 保存したキーを再利用します。 OAuthリフレッシュステップはありません。期限切れまたは再発した場合は、それを交換してください。 |
| MCP OAuth | ホストは、回転リフレッシュトークンを使用して、1時間 OAuth アクセストークンを更新します。 90-dayの付与が期限切れになったり、再発されたりすると再接続します。 各インストールはトークンストアを所有しています。ホスト間でリフレッシュトークンファイルを共有しないでください。 |
| 一時的なAPIのキー | 作業を再開する前に、作業を要求し、クレデンシャルハンドオフを完了します。 元のプロファイルを再利用し、各実行に再度登録しないでください。 |

- [タスクワークフローの再利用](https://flashdata.dev/ja/docs/guides/recurring-tasks/reference.md)

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

### CLI タスクをスケジューリングする前にチェック

Bashとjqが必要です。 タスクのソースにSOURCEを設定します。 スクリプトはデフォルトで研究を使用します。FLASHDATA_PROFILEとFLASHDATA_STATE_DIRを異なるプロファイルまたは状態ディレクトリに設定します。 0をアイデンティティJSONで終了すると、所有者キーが準備ができ、インストールされ、このソースのために許可されます。 他の出口にスケジューラが止まります。 問い合わせは受け付けません。

#### フレッシュプロセスアクセスチェック・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/ja/docs/guides/recurring-tasks/reference.md#prepare)

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

### アクセスがまだトライアルの場合

オリジナルのプロファイルで試行錯誤ガイドを完了します。 所有者の承認と資格取得後、無料のチェックは、所有するアクセスとrecurringAllowed: trueを表示する必要があります。 継続的なリクエストは、所有者の共有残高を使用しており、未使用のトライアルクレジットは譲渡しません。 MCP OAuthのログインは別の接続であり、この試験を主張しません。

- [試行とクレームコマンド](https://flashdata.dev/ja/docs/guides/agent-onboarding/reference.md)
- [auth.md](https://flashdata.dev/auth.md)

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

## アクセスを回復する

ジョブの再利用を最初に行なう。 マッチング資格を下に戻し、ローカルアクセスをクリアする前に、新鮮なプロセスやセッションから無料チェックを繰り返します。 認証の失敗や再接続リクエストを期待してください。チェック中に新しい接続を承認しないでください。 ローカルログアウトだけでサーバーアクセスを再開しません。

| コネクション | どこをリムークする |
| --- | --- |
| MCP OAuth | Settings → Connected apps → アプリの助成金. |
| クレームエージェント 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/ja/docs/guides/troubleshooting/reference.md#credentials)

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

## 失敗したチェックを修正

| 結果発表 | アクション |
| --- | --- |
| accessVerified: false | フェーズとnextCommandを読みます。 ピンディングプロファイルは、キーが使用可能になる前に、ok: trueを返すことができます。 保存された登録またはクレームを完了します。同じプロファイルを保持します。 |
| access: blocked | HTTP応答が200であった場合でも、停止します。 コンソールでアカウントや接続を確認する; クエリへの許可として、アイデンティティの応答を扱いません。 |
| accountType: temporary | ワンオフワークの資格試験を使用してください。 scheduling の前にそれを主張して下さい; 新しい 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/ja/docs/guides/agent-recovery/reference.md)
