# FlashData MCP

Подаруйте агента Google Search і YouTube. З'єднайте свій хост, потім запитайте про свій перший результат.

Канонічне посилання: https://flashdata.dev/uk/docs/integrations/mcp-clients
Переглянуто: 2026-11-05 від FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Офіційний сервер MCP
- [MCP посилання](https://flashdata.dev/uk/docs/mcp/reference.md) — Інструменти, параметри та відповіді
- [Отримайте API-ключ](https://flashdata.dev/app/api-keys) — Для гостей, які використовують автентифікацію головки

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

## 1. Підключіть і зареєструйте

Виберіть Codex або OpenClaw для браузера на базі OAuth. Для іншого хосту виберіть Дистанцію / API ключ, якщо він підтримує потокові HTTP та спеціальні заголовки, або локальні / стаціонарні, якщо він запускає 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)

### Місцеве / стило

Вимагає Node.js 22.18+ і ключ API з дозволом Google Search. Зайдіть це в хост, який підтримує mcpServers JSON. Замініть YOUR_API_KEY в локальній конфігураційній конфігурації, потім перезавантажте господаря. Використовуйте npx.cmd на Windows, якщо ведучий необхідний файл.

Пакет 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 і ваш доступний кредитний баланс. Нульовий баланс означає, що вам потрібно кредити для пошуку; це не означає автентифікації.

### Перевірка підключення

```text
Використовуйте існуючі флешки MCP з'єднання.
Зателефонуйте get_pricing з {"source":"google_search","request_count":1}.
Зателефонуйте get_balance з {}.
Повідомляємо, чи є у вас вихідне джерело,
і наявний кредитний баланс. Нульовий баланс не є автентифікаційною недостатністю.
Не запустіть пошук або завантажити, створіть пробну або змінну облікові дані.
```


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

## 3. Запитайте про своє перше завдання

Вставте це в свій підключений агент. Безкоштовні перевірки балансу та ціноутворення; пошук використовує кредити рахунків.

### Перший запит завдання

```text
Використовуйте FlashData для перевірки балансу та ціни одного пошуку Google. Якщо є достатні кредити, зателефонуйте google_search раз з запитом "battery recycling research", num 5 і режим "realtime". Повернути назви, джерело URLs, короткі викрутки та фактичні кредити, які використовуються. Стоп після цього завдання.
```


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

### Перевірте результат

Ваш агент повинен повернути посилання на джерело та вишукування, а також фактичні кредитні кошти, що використовуються. В основі результатів пошуку status: done і results[].organic. Порожній результат діє; агент повинен повідомити його. Приклад нижче ілюстративний.

#### Приклад відповіді

```text
Заповнений Google пошук.
1. Дослідження переробки акумуляторів — https://example.org/recycling
   Приклад пошуку шийки матки
Кредитування, що використовуються: 0.02
```


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

## Доступні інструменти

API-ключа використовується для користувача дозволів, наданих цим ключем. Відкрийте інструменти сервера та вхідні щілини для повноцінного поточного каталогу.

| Заява | КОМПЛЕКС | Доступний |
| --- | --- | --- |
| Пошук Google | google_search | mcp:research / API key |
| Знайти YouTube відео | youtube_search | mcp:research / API key |
| Читати метадані відео | 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/uk/docs/mcp/reference.md#parameters)
- [Завантажити налаштування](https://flashdata.dev/uk/docs/guides/youtube-download-guide/reference.md)

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

## Про OAuth, дозволи та випробування

OAuth підключає ваш перевірений обліковий запис власника і дозволяє зберігати в магазині і освіжати токени. Надано грант mcp:research на чотирьох джерелах. API-ключа використовується захищений заголовок X-API-Key і може включати інші уповноважені джерела.

Щоб спробувати FlashData перед створенням облікового запису, використовуйте тестовий потік CLI. MCP OAuth підключений до облікового запису власника; він не реєструє або стверджує про це. Профіль CLI не автоматично розповсюджується з вашим хостом MCP.

- [Почати тест агента](https://flashdata.dev/uk/docs/guides/agent-onboarding/reference.md#access)
- [Клеймування та достовірність](https://flashdata.dev/uk/docs/guides/agent-onboarding/reference.md#claim)
- [Запобігання збереженого доступу](https://flashdata.dev/uk/docs/guides/agent-access/reference.md#refresh)
- [Відновити доступ](https://flashdata.dev/uk/docs/guides/agent-access/reference.md#revoke)

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

## Виправлення несправностей

| Проблема | Написати нам |
| --- | --- |
| Немає інструментів FlashData | Згода, відключення і початок свіжої сесії. Перевірити URL і потоковий HTTP транспорт. |
| invalid_client / callback error | Для Codex або OpenClaw використовують його точну конфігурацію клієнтів і браузер, який може досягати локального зворотного зв'язку. Для іншого хосту використовуйте його підтримувані API-key або stdio налаштування вище. |
| 401 | Відключення відключення або відкликання доступу OAuth, або перевірте ключ API, що надходить до господаря. Повторити вільний контроль. |
| 403 | Перевірити джерело запиту та ключі дозволи. YouTube Download вимагає власника API ключ з youtube_download і зберігання призначення; mcp:research не включає його. |
| 402 | Перевірте Billing і поточну ціну. Відключення дійсного облікового запису не додає кредитів. |
| 429 | Перейдіть за допомогою Retry-After. Зберігайте будь-яку наявну роботу або введіть ID перед тим, як вирішити, чи переробляти завдання. |
| Відповідність або неповна відповідь | Зареєструйтеся на ID і перевірте History. Читання великих свердловин з продовженням get_result замість повторення пошуку. |

- [Billing](https://flashdata.dev/app/billing)
- [Історія запиту](https://flashdata.dev/app/jobs)

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

## Далі

- [Створіть користувальницький клієнт MCP](https://flashdata.dev/uk/docs/guides/mcp-custom-client/reference.md)
- [Деталі налаштування Codex](https://flashdata.dev/uk/docs/integrations/codex/reference.md)
- [Деталі налаштування OpenClaw](https://flashdata.dev/uk/docs/integrations/openclaw/reference.md)
- [Регулярні завдання](https://flashdata.dev/uk/docs/guides/recurring-tasks/reference.md)
