# FlashData MCP

에이전트 Google Search 및 YouTube 도구를 제공합니다. 호스트를 연결하면 첫 번째 결과를 요청합니다.

Canonical 참고: https://flashdata.dev/ko/docs/integrations/mcp-clients
검토: 2026-11-05 FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — 공식 MCP 서버
- [MCP 참조](https://flashdata.dev/ko/docs/mcp/reference.md) — 도구, 매개 변수 및 응답
- [API 키 받기](https://flashdata.dev/app/api-keys) — header 인증을 사용하는 호스트

<a id="connect"></a>

## 1. 연결 및 로그인

브라우저 기반 OAuth를 위한 Codex 또는 OpenClaw를 선택하십시오. 다른 호스트의 경우, 원격 / API 키를 선택하면 스트림 가능한 HTTP 및 사용자 정의 헤더 또는 로컬 / stdio를 지원하면 MCP 프로세스를 시작합니다. 호스팅 서버는 로컬 설치가 필요 없습니다.

### Codex

~/.codex/config.toml에 아래의 구성을 병합하면 로그인 명령을 실행합니다. FlashData 등록 또는 로그인 및 브라우저에 동의. 로그인 후 신선한 Codex 세션을 시작합니다.

#### config.toml

```toml
[mcp_servers.flashdata]
url = "https://data.flashdata.dev/mcp"

[mcp_servers.flashdata.oauth]
client_id = "flashdata-codex"
callback_url = "http://127.0.0.1/callback"
```

#### 로그인

```bash
codex mcp login flashdata --scopes mcp:research
```


### OpenClaw

OpenClaw에서 이러한 명령을 실행하면 에이전트가 사용됩니다. 브라우저에서 로그인 또는 로그인 및 동의를 완료한 다음 신선한 세션을 시작합니다. 의사 조사는 저장된 연결을 확인합니다.

#### 구성, 로그인 및 확인 · Bash / PowerShell 7

```bash
openclaw mcp set flashdata '{"url":"https://data.flashdata.dev/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"mcp:research","clientMetadataUrl":"https://api.flashdata.dev/oauth/clients/openclaw.json"}}'
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```


### 리모트/API 열쇠

Google Search 권한으로 키 생성, 또는 재사용. 아래 필드를 사용하여 호스트의 MCP 설정에서 서버를 추가하십시오. 보호 된 헤더 필드와 재연결에 키를 넣어; OAuth 명령이 필요하지 않습니다.

#### MCP 설정

```text
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEY
```

- [API 키 생성](https://flashdata.dev/app/api-keys)

### 지역 / stdio

Node.js 22.18+와 API 키가 Google Search 권한으로 필요합니다. mcpServers JSON를 지원하는 호스트로 이 작업을 수행하십시오. 로컬 보호 설정에서 YOUR_API_KEY를 교체하고 호스트를 다시 시작합니다. 호스트가 실행 가능한 파일 이름을 필요로 하는 경우 Windows에서 npx.cmd를 사용하십시오.

핀 npm 패키지는 로컬 MCP 서버를 실행합니다. 독립 FlashData CLI는 별도의 실행이 가능합니다.

#### MCP 구성

```json
{
  "mcpServers": {
    "flashdata": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=@flashdata-dev/mcp@0.2.0",
        "flashdata-mcp"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

- [API 키 생성](https://flashdata.dev/app/api-keys)
- [로컬 서버 문서](https://github.com/flashdatadev/flashdata-mcp)


<a id="sign-in"></a>

## 2. 연결 확인

신선한 에이전트 세션에서 이것을 보내십시오. 성공적인 get_pricing 및 get_balance 통화, google_search 및 사용 가능한 신용 잔액에 대한 사용 가능한 가격 기대. 0 잔액은 검색에 대한 신용이 필요합니다. 인증이 실패하지 않습니다.

### 연결 체크

```text
기존 flashdata MCP 연결을 사용하세요.
get_pricing에 {"source":"google_search","request_count":1}을 전달해 호출하세요.
get_balance에 {}를 전달해 호출하세요.
두 호출의 성공 여부, 해당 소스의 요금 제공 여부, 사용 가능한 크레딧 잔액을 보고하세요.
잔액이 0인 것은 인증 실패가 아닙니다.
검색이나 다운로드를 실행하거나 체험을 생성하거나 인증 정보를 변경하지 마세요.
```


<a id="task"></a>

## 3. 당신의 첫 번째 작업에 대 한 질문

연결 대리인으로 이것을 붙여 넣으십시오. 균형과 가격표는 무료입니다. 검색은 계정 크레딧을 사용합니다.

### 첫 번째 작업 프롬프트

```text
FlashData를 사용하여 균형과 한 Google 검색의 가격을 확인하십시오. 충분한 신용이 있는 경우, 쿼리 "battery recycling research", num 5 및 모드 "realtime"로 한 번 google_search를 호출하십시오. 반환 제목, 소스 URLs, 짧은 발췌 및 실제 크레딧 사용. 이 작업을 중지합니다.
```


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

### 결과 확인

귀하의 에이전트는 소스 링크 및 발췌, 그리고 실제 크레딧을 사용. 아래 검색 결과에는 status: done 및 results[].organic.가 있습니다. 빈 결과는 유효합니다; 대리인은 그것을 보고해야 합니다. 아래 예제는 설명입니다.

#### 예시 답변

```text
한 Google 검색 완료.
1. 배터리 재활용 연구 — https://example.org/recycling
   예시 검색 발췌.
사용 된 크레딧 : 0.02
```


<a id="tools"></a>

## 사용 가능한 도구

API-key 통화는 해당 키에 부여된 권한을 사용합니다. 현재 카탈로그에 대한 서버 도구 및 입력 스키마를 발견하십시오.

| 의논하기 | 의 특징 | 오시는 길 |
| --- | --- | --- |
| 검색 Google | google_search | mcp:research / API key |
| YouTube 동영상 찾기 | youtube_search | mcp:research / API key |
| 비디오 metadata | youtube_metadata | mcp:research / API key |
| 기존의 캡션 검색 | youtube_transcript | mcp:research / API key |
| 동영상 또는 오디오 | youtube_download | 소유자 API 키 + 목적지 저장 |
| 계정 및 가격 확인 | get_balance, get_pricing, get_limits, get_usage | 무료 계정 읽기 |

- [모든 도구 및 매개 변수](https://flashdata.dev/ko/docs/mcp/reference.md#parameters)
- [다운로드 설정](https://flashdata.dev/ko/docs/guides/youtube-download-guide/reference.md)

<a id="authentication"></a>

## OAuth, 허가 및 시험에 대해

OAuth는 검증된 소유자 계정을 연결하고 호스트 저장소와 토큰을 새로 고침합니다. mcp:research 보조금은 4개의 연구 소스를 위에 덮습니다. API-key 연결은 보호한 X-API-Key 우두머리를 이용하고 다른 허가한 근원을 포함할 수 있습니다.

계정을 만들기 전에 FlashData를 시도하려면 CLI 시험 흐름을 사용하십시오. MCP OAuth는 소유자 계정을 연결합니다; 그것은 등록하거나 체험을 주장하지 않습니다. CLI 프로파일은 MCP 호스트와 자동으로 공유되지 않습니다.

- [에이전트 시험 시작](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md#access)
- [표정 및 자격](https://flashdata.dev/ko/docs/guides/agent-onboarding/reference.md#claim)
- [Reuse 저장된 접근](https://flashdata.dev/ko/docs/guides/agent-access/reference.md#refresh)
- [관련 링크](https://flashdata.dev/ko/docs/guides/agent-access/reference.md#revoke)

<a id="errors"></a>

## 관련 상품

| 의 의 | 이 글을 |
| --- | --- |
| FlashData 도구 없음 | 동의, 재연결 및 신선한 세션을 시작합니다. URL 및 Streamable HTTP 운송을 확인하십시오. |
| invalid_client / callback error | Codex 또는 OpenClaw의 경우 정확한 클라이언트 구성 및 로컬 콜백에 도달 할 수있는 브라우저를 사용하십시오. 다른 호스트의 경우, 지원된 API-key 또는 stdio 설정을 사용하십시오. |
| 401 | 재연결이 만료되거나 OAuth 액세스를 수정하거나 호스트에 공급된 API 키를 확인합니다. 무료 체크를 반복합니다. |
| 403 | 요청된 소스와 키 권한을 확인 합니다. YouTube Download는 youtube_download와 목적지 저장을 가진 소유자 API 열쇠를 요구합니다; mcp:research는 그것을 포함하지 않습니다. |
| 402 | Billing 및 현재 가격을 확인하십시오. 유효한 자격 증명을 다시 연결하면 크레딧을 추가하지 않습니다. |
| 429 | Retry-After를 따르십시오. 기존의 작업 또는 결과 ID를 유지하십시오. 작업을 재발행 여부를 결정하기 전에. |
| Timeout 또는 불완전한 응답 | ID 요청을 유지하고 History를 확인하십시오. 검색을 반복하는 대신 get_result로 큰 반복 윤곽을 읽으십시오. |

- [Billing](https://flashdata.dev/app/billing)
- [회사연혁](https://flashdata.dev/app/jobs)

<a id="client"></a>

## 더 보기

- [사용자 정의 MCP 클라이언트 구축](https://flashdata.dev/ko/docs/guides/mcp-custom-client/reference.md)
- [Codex 설정 세부 정보](https://flashdata.dev/ko/docs/integrations/codex/reference.md)
- [OpenClaw 설정 세부 정보](https://flashdata.dev/ko/docs/integrations/openclaw/reference.md)
- [정기 작업](https://flashdata.dev/ko/docs/guides/recurring-tasks/reference.md)
