# Agent 인증 옵션

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

Canonical 참고: https://flashdata.dev/ko/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는 API와 직접 단계 2에서 검사합니다; CLI 임명이 요구되지 않습니다.

- [API Keys](https://flashdata.dev/app/api-keys)
- [CLI에서 키를 저장](https://flashdata.dev/ko/docs/guides/agent-access/reference.md#import-key)
- [SDK 및 HTTP 키 설정](https://flashdata.dev/ko/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/ko/docs/integrations/codex/reference.md#setup)
- [OpenClaw 연결](https://flashdata.dev/ko/docs/integrations/openclaw/reference.md#setup)
- [다른 MCP 클라이언트](https://flashdata.dev/ko/docs/integrations/mcp-clients/reference.md#connect)

### 에이전트 시험

키가 없는 에이전트를 위해, discover는 등록하기 전에 현재 시험 자격입니다. 기존의 시험과 그 프로필을 재사용합니다. YouTube Download 및 재순환 작업은 소유자의 접근을 요구합니다.

#### 등록없이 발견

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

- [시험 시작 및 청구](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md)
- [Agent 인증 프로토콜](https://flashdata.dev/auth.md)


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

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

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

#### 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가 이미 설정되면 숨겨진 키 프롬프트를 건너 뛰십시오. 같은 터미널에서 읽기 명령을 실행합니다.

#### 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는 저장된 열쇠를 overrides. ok: true 및 data.accessVerified: true를 기대하십시오; 그 때 아래에 ID 필드를 검사합니다.

#### 무료 계정 읽기

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

- [키 설정](https://flashdata.dev/ko/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에 {}를 전달해 호출하세요.
두 호출의 성공 여부, 해당 소스의 요금 제공 여부, 사용 가능한 크레딧 잔액을 보고하세요.
잔액이 0인 것은 인증 실패가 아닙니다.
검색이나 다운로드를 실행하거나 체험을 생성하거나 인증 정보를 변경하지 마세요.
```



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

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

- [스케줄링 전에 이러한 체크를 자동화하십시오](https://flashdata.dev/ko/docs/guides/agent-access/reference.md#recurring-check)

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

### Active Trial은 유효한 연결입니다

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

#### 정체성 · illustrative 필드

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

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

### OpenClaw의 연결을 확인

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

#### 서버 Probe

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

- [OpenClaw 설정 및 첫 번째 작업](https://flashdata.dev/ko/docs/integrations/openclaw/reference.md)

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

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

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

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

- [작업 흐름을 반복](https://flashdata.dev/ko/docs/guides/recurring-tasks/reference.md)

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

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

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

#### 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/ko/docs/guides/recurring-tasks/reference.md#prepare)

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

### 액세스가 여전히 예심

시험 및 청구 가이드를 원본 프로파일로 완료하십시오. 소유자 승인 및 자격 취득 후, 무료 체크는 소유 된 액세스 및 recurringAllowed: true를 표시해야합니다. 계속 요청은 소유자의 공유 잔액을 사용합니다. 사용하지 않은 체험 크레딧은 전송하지 않습니다. MCP OAuth 로그인은 별도의 연결이며이 체험을 주장하지 않습니다.

- [시험 및 청구 명령](https://flashdata.dev/ko/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)
- [Troubleshoot 액세스 오류](https://flashdata.dev/ko/docs/guides/troubleshooting/reference.md#credentials)

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

## 실패한 체크를 수정

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

- [Billing](https://flashdata.dev/app/billing)
- [중단된 연결을 복구](https://flashdata.dev/ko/docs/guides/agent-recovery/reference.md)
