Обзор документации
Начало работы
Предоставьте вашему агенту инструменты Google Search и YouTube. Подключите хост, а затем попросите свой первый результат.
На этой странице
1. Подключайся и входи
Выберите Codex или OpenClaw для браузера OAuth. Для другого хоста выберите клавишу Remote / API, если она поддерживает потоковые HTTP и пользовательские заголовки, или Local / stdio, если она запускает процессы 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-key используют защищенный заголовок X-API-Key и могут включать в себя другие авторизованные источники.
Чтобы попробовать FlashData до создания аккаунта, используйте пробный доступ через CLI. MCP OAuth подключает аккаунт владельца; он не регистрирует и не привязывает пробный доступ. Профиль CLI не передаётся вашему MCP-хосту автоматически.
устранение неполадок
| Проблема | Попробуйте |
|---|---|
| Нет инструментов FlashData | Заканчивайте согласие, подключайтесь и начинайте новую сессию. Проверьте URL и потоковый транспорт HTTP. |
| invalid_client / callback error | Для Codex или OpenClaw используйте его точную конфигурацию клиента и браузер, который может достичь локального обратного вызова. Для другого хоста используйте поддерживаемый API-ключ или настройку stdio выше. |
| 401 | Воссоединитесь с истекшим или отозванным доступом OAuth или проверьте ключ API, предоставленный хосту. Повторите бесплатный чек. |
| 403 | Проверьте запрашиваемый источник и ключевые разрешения. YouTube Download требует наличия ключа API у владельца с youtube_download и хранилищем назначения; mcp:research не включает его. |
| 402 | Проверьте Billing и текущую цену. Воссоединение действительного учетного данных не добавляет кредитов. |
| 429 | Следуйте за Retry-After. Сохраняйте любую существующую работу или результат ID, прежде чем принимать решение о повторном выполнении задачи. |
| Тайм-аут или неполный ответ | Запрос ID и проверка History. Прочитайте продолжение с большим результатом с помощью get_result вместо повторения поиска. |