コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

連携

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

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

このページの内容

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

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

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

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

どのソースがこの資格情報を使うことができますか?

利用条件 X-API-Key 普通のため HTTP リクエストとリクエスト API-キー MCP 接続。 OAuth ベアラートークンは、ホストされている MCP エンドポイントでのみ動作します。 YouTube Download は youtube_download および保存先が付いている所有者 API のキーを必要とします。

資格情報利用可能なソース
所有者 API キー承認されたとき、youtube_download を含むキーに付与されたソース。
一時的なAPIのキー試用対象のソースのみが付与されます。 現在のアイデンティティ応答からスコープを読みます。
MCP OAuthgoogle_search, youtube_search, youtube_metadata, youtube_transcript

CLIでキーを保存

CLIが既にアクセスしているか、あなたの秘密のマネージャーがFLASHDATA_API_KEYを供給している場合は、インポートをスキップします。 それ以外の場合は、以下の方法を選択し、後述のコマンドで同じ研究プロファイルを保持します。 保存したCLIキーはSDKやローカルMCPサーバーに自動的に使用できません。

隠し端末プロンプトでキーを貼り付けます。

一度輸入して下さい
flashdata auth login --profile research

2. 接続を確認する

タスクを実行する環境で無料のチェックを実行します。 CLI と HTTP チェックは、API キーを使用します。 MCP チェックは、ホストの保存された接続を使用します。

BashとcURL 7.76+が必要です。 環境がすでにFLASHDATA_API_KEYを供給している場合は、隠れたキープロンプトをスキップします。 同じターミナルで読み取りコマンドを実行します。

既に設定されている場合はキー・スキップを設定します。
# 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
(
: "${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'
)

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

アクティブトライアルは有効な接続です

recurringAllowed は false である間、トライアルは一オフのタスクチェックを渡すことができます。 実際のスコープと有効期限を読んでください。 スケジュール作業の前に、既存のトライアルを要求します。

仮のアイデンティティ・イラスト分野
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}

Codexの接続を見つける

設定されたサーバーをリストし、/mcpを新しいCodexセッションで使用してください。 MCP チェックを実行して、クレデンシャルを確認します。

リスト サーバー
codex mcp list

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

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

サーバをプローブする
openclaw mcp doctor flashdata --probe

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

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

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

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

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

フレッシュプロセスアクセスチェック・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}'
)

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

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

アクセスを回復する

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

コネクションどこをリムークする
MCP OAuthSettings → Connected apps → アプリの助成金.
クレームエージェント API キーSettings → Connected apps → エージェント接続
口座名 API キーAPI Keys → この統合で使用されるキー。

失敗したチェックを修正

結果発表アクション
accessVerified: falseフェーズとnextCommandを読みます。 ピンディングプロファイルは、キーが使用可能になる前に、ok: trueを返すことができます。 保存された登録またはクレームを完了します。同じプロファイルを保持します。
access: blockedHTTP応答が200であった場合でも、停止します。 コンソールでアカウントや接続を確認する; クエリへの許可として、アイデンティティの応答を扱いません。
accountType: temporaryワンオフワークの資格試験を使用してください。 scheduling の前にそれを主張して下さい; 新しい OAuth 関係はこのプロフィールを要求しません。
installed: false所有者の承認後、元のプロファイルと状態ディレクトリでフラッシュデータauth finish --waitを実行します。 チェックを繰り返します。
401 / invalid_grant元のホストで期限切れまたは再発された資格を再接続します。 別のトライアルをバイパスしないようにしてください。
403 / source_forbiddenキーのスコープまたは OAuth ソースリストを確認してください。 YouTube Download は、API キーの所有者を使用します。
有効なアクセス、ゼロ バランス認証作業。 有料の作業の前に Billing を確認してください。有効なキーを交換しないでください。