본문으로 건너뛰기
KO
API 키 받기
문서 둘러보기

연동

Agent 인증 옵션

API 키 또는 MCP OAuth와 연결하여 유료 쿼리없이 액세스 확인하고 나중에 작업을 재사용하십시오.

이 페이지의 내용

1. 선택 및 연결

이미 연결되었습니까? 단계 2에서 무료 체크로 이동합니다. 그렇지 않으면, 당신의 신청 또는 대리인 필요를 접근하십시오.

연결하기제품 정보누가 압도적입니까?
응용 프로그램, SDK, CLI 또는 예정된 스크립트소유자 API 키서버의 비밀 저장소 또는 CLI 프로필
Codex 또는 OpenClaw 연구 도구MCP OAuth이용 후기 로딩중
계정없이 FlashData를 시도하는 대리인임시 API 열쇠에이전트의 저장된 체험 프로필, 그 후 소유자 액세스 청구 후

API Keys의 키를 생성하여 작업의 필요성을 유지하거나 기존 키를 재사용합니다. SDK에 그것을 공급하거나 당신의 백엔드에서 X-API-Key로 보내십시오. Bash와 PowerShell는 API와 직접 단계 2에서 검사합니다; CLI 임명이 요구되지 않습니다.

어떤 소스는이 자격 사용 할 수 있습니까?

일반 HTTP 요청 및 API 키 MCP 연결을 위해 X-API-Key를 사용하십시오. OAuth Bearer 토큰은 호스팅된 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를 공급하는 경우 숨겨진 키 프롬프트를 건너 뛸 수 있습니다. 같은 터미널에서 읽기 명령을 실행합니다.

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 ID 필드는 최고 수준입니다. CLI JSON에서 data.identity.identity를 읽고 data.accessVerified: true가 필요합니다. HTTP 200 또는 CLI ok: true는 혼자서 충분하지 않습니다.

확인Required 결과
계정 개설accountId와 apiKeyId는 당신이 사용하는 것을 의미하는 계정과 열쇠를 확인합니다.
자주 묻는 질문access: ready
작업 권한범위는 google_search와 같은 소스를 포함합니다. CLI는 또한 data.identity.permittedSources에서 허용되는 소스를 나열합니다.
업무 수행accountType: owned · installed: true · recurringAllowed: true

Active Trial은 유효한 연결입니다

시험은 recurringAllowed가 false인 동안 1-off 작업 체크를 통과할 수 있습니다. 실제 범위와 만료를 읽으십시오; 스케줄링 작업 전에 기존의 평가판을 주장합니다.

정체성 · illustrative 필드
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}

Codex의 연결 찾기

구성된 서버 목록에서 /mcp를 신선한 Codex 세션에서 사용하세요. 자격 증명을 확인하려면 위의 MCP 체크를 실행하십시오.

서버 목록
codex mcp list

OpenClaw의 연결을 확인

저장된 서버가 Probe를 사용하면 활성 대화에서 MCP 체크를 실행합니다.

서버 Probe
openclaw mcp doctor flashdata --probe

3. 나중에의 작업에 대한 액세스 재사용

프로세스 재시작을 통해 자격점 개인 및 지속성을 유지하십시오. 스케줄러를 활성화하기 전에 신선한 프로세스에 대한 액세스를 재확인합니다.

주요 특징다음 작업을 위해
소유자 API 키저장된 키를 재사용합니다. OAuth가 상쾌한 단계가 없습니다. 만료되거나 수정되면 교체하십시오.
MCP OAuth호스트는 회전식 갱신 토큰을 사용하여 유효 기간이 1시간인 OAuth 액세스 토큰을 갱신합니다. 90일 권한 부여가 만료되거나 취소되면 다시 연결하세요. 각 설치는 자체 토큰 저장소를 사용합니다. 호스트 간에 갱신 토큰 파일을 공유하지 마세요.
임시 API 열쇠반복 작업 전에 소유자 계정 연결과 인증 정보 전달을 완료하세요. 원래 프로필을 재사용하고 매번 새로 등록하지 마세요.

CLI 작업을 스케줄링하기 전에 확인하십시오

Bash와 jq를 요구합니다. 작업의 소스에 SOURCE를 설정합니다. 스크립트는 기본적으로 연구를 사용합니다. 다른 프로파일 또는 state 디렉토리에 FLASHDATA_PROFILE 및 FLASHDATA_STATE_DIR를 설정합니다. 정체성 JSON를 가진 0 출구는 소유자 열쇠가 준비되어 있고, 이 근원을 위해 설치되고 허용됩니다. 다른 출구에서 스케줄러가 멈춘다. 질문은 제출되지 않습니다.

Fresh-process 액세스 체크 · 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를 usable 돌려보낼 수 있습니다. 저장 된 등록 또는 청구를 완료하십시오. 동일한 프로필을 유지합니다.
access: blockedHTTP 응답이 200이어도 중지하세요. 콘솔에서 계정이나 연결을 확인하세요. 식별 정보가 반환되었다고 쿼리 실행 권한이 있는 것은 아닙니다.
accountType: temporary1-off 작업에 대한 자격이 된 평가판을 사용하십시오. 스케줄링 전에 결정; 새로운 OAuth 연결이 프로파일을 주장하지 않습니다.
installed: false소유자 승인 후, Flashdata auth finish --wait를 원래 프로필 및 상태 디렉토리로 실행하십시오. 그런 다음 체크를 반복합니다.
401 / invalid_grant원래 호스트에서 만료되거나 취소된 인증 정보를 다시 연결하세요. 이를 우회하려고 다른 체험을 시작하지 마세요.
403 / source_forbidden키의 범위 또는 OAuth 소스 목록을 확인하십시오. YouTube Download는 소유자 API 열쇠를 사용합니다.
유효한 접근, 0 균형인증은 성공했습니다. 유료 작업 전에 Billing을 확인하세요. 유효한 키를 교체하지 마세요.