Перейти к содержимому
RU
Ключ API
Обзор документации

Начало работы

FlashData MCP

Предоставьте вашему агенту инструменты Google Search и YouTube. Подключите хост, а затем попросите свой первый результат.

На этой странице

1. Подключайся и входи

Выберите Codex или OpenClaw для браузера OAuth. Для другого хоста выберите клавишу Remote / API, если она поддерживает потоковые HTTP и пользовательские заголовки, или Local / stdio, если она запускает процессы MCP. Размещенный сервер не нуждается в локальной установке.

Слить конфигурацию ниже в ~/.codex/config.toml, затем запустить команду входа. Заполните FlashData регистрацию или вход и согласие в браузере. Начните новый сеанс Codex после входа в систему.

config.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"
Войти
codex mcp login flashdata --scopes mcp:research

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-ключа используют разрешения, предоставленные этому ключу. Откройте инструменты сервера и схемы ввода для полного текущего каталога.

ЗаданиеИнструментДоступ
Поиск по Googlegoogle_searchmcp:research / API key
Найти видео YouTubeyoutube_searchmcp:research / API key
Читать видео метаданныеyoutube_metadatamcp:research / API key
Восстановление существующих подписейyoutube_transcriptmcp: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 вместо повторения поиска.

Иди дальше