Переглянути документацію
Початок роботи
Подаруйте агента Google Search і YouTube. З'єднайте свій хост, потім запитайте про свій перший результат.
На цій сторінці
1. Підключіть і зареєструйте
Виберіть Codex або OpenClaw для браузера на базі OAuth. Для іншого хосту виберіть Дистанцію / API ключ, якщо він підтримує потокові HTTP та спеціальні заголовки, або локальні / стаціонарні, якщо він запускає MCP-процеси. На сервері розміщено не локальну установку.
Займіть настройку нижче в ~ /.codex/config.toml, потім запустіть команду входу. Повна підписка FlashData або підписка та згода в браузері. Запуск свіжої сесії Codex після входу.
[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"codex mcp login flashdata --scopes mcp:researchЗапустіть ці команди в профілі OpenClaw, який використовує ваш агент. Повна підписка або підписка та згода в браузері, після чого запустіть свіжу сеанс. Лікар, який перевіряє збережене з'єднання.
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Створіть ключ з дозволом Google Search або повторно користуйтеся. Додайте сервер у налаштуваннях MCP за допомогою поля нижче. Поставте ключ в захищене поле заголовка і відключіть; не потрібно команду OAuth.
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEYВимагає Node.js 22.18+ і ключ API з дозволом Google Search. Зайдіть це в хост, який підтримує mcpServers JSON. Замініть YOUR_API_KEY в локальній конфігураційній конфігурації, потім перезавантажте господаря. Використовуйте npx.cmd на Windows, якщо ведучий необхідний файл.
Пакет npm працює на локальному сервері MCP. Автономний FlashData CLI є окремою виконуваною.
{
"mcpServers": {
"flashdata": {
"command": "npx",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "YOUR_API_KEY"
}
}
}
}2. Перевірити підключення
Відправте це в свіжому агенту сеанс. Визначити успішний get_pricing і get_balance виклики, доступна ціна за google_search і ваш доступний кредитний баланс. Нульовий баланс означає, що вам потрібно кредити для пошуку; це не означає автентифікації.
Використовуйте існуючі флешки MCP з'єднання.
Зателефонуйте get_pricing з {"source":"google_search","request_count":1}.
Зателефонуйте get_balance з {}.
Повідомляємо, чи є у вас вихідне джерело,
і наявний кредитний баланс. Нульовий баланс не є автентифікаційною недостатністю.
Не запустіть пошук або завантажити, створіть пробну або змінну облікові дані.3. Запитайте про своє перше завдання
Вставте це в свій підключений агент. Безкоштовні перевірки балансу та ціноутворення; пошук використовує кредити рахунків.
Використовуйте FlashData для перевірки балансу та ціни одного пошуку Google. Якщо є достатні кредити, зателефонуйте google_search раз з запитом "battery recycling research", num 5 і режим "realtime". Повернути назви, джерело URLs, короткі викрутки та фактичні кредити, які використовуються. Стоп після цього завдання.Перевірте результат
Ваш агент повинен повернути посилання на джерело та вишукування, а також фактичні кредитні кошти, що використовуються. В основі результатів пошуку status: done і results[].organic. Порожній результат діє; агент повинен повідомити його. Приклад нижче ілюстративний.
Заповнений Google пошук.
1. Дослідження переробки акумуляторів — https://example.org/recycling
Приклад пошуку шийки матки
Кредитування, що використовуються: 0.02Доступні інструменти
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 | Безкоштовні читання облікового запису |
Про OAuth, дозволи та випробування
OAuth підключає ваш перевірений обліковий запис власника і дозволяє зберігати в магазині і освіжати токени. Надано грант mcp:research на чотирьох джерелах. API-ключа використовується захищений заголовок X-API-Key і може включати інші уповноважені джерела.
Щоб спробувати FlashData перед створенням облікового запису, використовуйте тестовий потік CLI. MCP OAuth підключений до облікового запису власника; він не реєструє або стверджує про це. Профіль CLI не автоматично розповсюджується з вашим хостом MCP.
Виправлення несправностей
| Проблема | Написати нам |
|---|---|
| Немає інструментів 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 замість повторення пошуку. |