Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Pierwsze kroki

FlashData MCP

Podaj agentowi narzędzia Google Search i YouTube. Połącz hosta, a następnie poproś o swój pierwszy wynik.

Na tej stronie

1. Podłącz i podpisz

Wybrać Codex lub OpenClaw dla przeglądarki opartej na OAuth. Dla innego hosta, wybierz Zdalny / API jeśli obsługuje Streamable HTTP i niestandardowe nagłówki, lub Local / stdio jeśli uruchamia procesy MCP. Serwer hostowany nie wymaga lokalnej instalacji.

Połącz poniższy plik konfiguracyjny w ~ /.codex/config.toml, a następnie uruchom polecenie logowania. Wypełnij FlashData logowanie lub logowanie i wyrażaj zgodę w przeglądarce. Po zalogowaniu rozpocząć nową sesję 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"
Zaloguj się
codex mcp login flashdata --scopes mcp:research

2. Sprawdź połączenie

Wyślij to na świeżą sesję agentów. Oczekuj udanych połączeń get_pricing i get_balance, dostępnej ceny za google_search i dostępnego salda kredytowego. Bilans zerowy oznacza, że potrzebne są kredyty do wyszukiwania; nie oznacza to, że uwierzytelnienie nie powiodło się.

Kontrola połączenia
Użyj istniejącego połączenia flashdata MCP.
Zadzwoń do get_pricing z {"source":"google_search","request_count":1}.
Zadzwoń do get_balance z {}.
Proszę podać, czy oba połączenia zakończyły się sukcesem, czy źródło ma dostępną cenę,
oraz dostępne saldo kredytowe. Saldo zerowe nie jest wadą uwierzytelniania.
Nie uruchamiaj wyszukiwania ani pobierania, nie twórz prób ani nie zmieniaj referencji.

3. Poproś o pierwsze zadanie

Wklej to swojemu powiązanemu agentowi. Saldo i kontrola cen są darmowe; w wyszukiwarce wykorzystuje się kredyty na konto.

Pierwszy sygnał zadania
Użyj FlashData, aby sprawdzić moje saldo i cenę jednego wyszukiwania Google. Jeśli jest wystarczająco dużo kredytów, zadzwoń raz do google_search z zapytaniem "battery recycling research", num 5 i tryb "realtime". Zwróć tytuły, źródło URLs, krótkie fragmenty i rzeczywiste kredyty używane. Przestań po tym zadaniu.

Sprawdź wynik

Twój agent powinien zwrócić linki źródłowe i fragmenty, plus rzeczywiste kredyty używane. Podstawowy wynik wyszukiwania ma status: done i results[].organic. Pusty wynik jest ważny; agent powinien go zgłosić. Poniższy przykład jest ilustrujący.

Przykład odpowiedzi
Ukończył jedno wyszukiwanie Google.
1. Badania recyklingu baterii - https://example.org/recycling
   Przykład wyszukiwanie fragmentu.
Używane zasługi: 0.02

Dostępne narzędzia

API-key połączenia korzystać z uprawnień przyznanych do tego klucza. Odkryj narzędzia serwera i schematy wejściowe dla pełnego bieżącego katalogu.

ZadanieNarzędzieDostęp
Szukaj Googlegoogle_searchmcp:research / API key
Znajdź filmy YouTubeyoutube_searchmcp:research / API key
Odczytywanie metadanych wideoyoutube_metadatamcp:research / API key
Odzyskiwanie istniejących zapisówyoutube_transcriptmcp:research / API key
Pobierz wideo lub audioyoutube_downloadWłaściciel API klucz + miejsce przeznaczenia
Sprawdź rachunek i ustalanie cenget_balance, get_pricing, get_limits, get_usageBezpłatne czytanie konta

O OAuth, uprawnienia i próby

OAuth łączy zweryfikowane konto właściciela i pozwala na przechowywanie i odświeżenie żetonów. Dotacja mcp:research obejmuje cztery wyżej wymienione źródła badawcze. API-key połączenia używać chronionego nagłówka X-API-Key i może zawierać inne autoryzowane źródła.

Aby wypróbować FlashData przed utworzeniem konta, użyj przepływu próbnego CLI. MCP OAuth łączy konto właściciela; nie rejestruje się ani nie wnosi o przeprowadzenie procesu. Profil CLI nie jest automatycznie udostępniany z hostem MCP.

Rozwiązywanie problemów

ProblemSpróbuj tego
Brak narzędzi FlashDataZakończ zgodę, ponownie połącz się i rozpocznij nową sesję. Sprawdź transport URL i Streamable HTTP.
invalid_client / callback errorW przypadku Codex lub OpenClaw, użyj jego dokładnej konfiguracji klienta i przeglądarki, która może dotrzeć do lokalnego połączenia zwrotnego. Dla innego hosta, użyj obsługiwanego klucza API- lub stdio powyżej.
401Uzyskiwanie dostępu do OAuth wygasło lub cofnięto go lub sprawdź klucz API dostarczony hostowi. Powtórzyć bezpłatny czek.
403Sprawdź wymagane prawa źródłowe i klucze. YouTube Download wymaga właściciela klucza API z youtube_download i miejsca przeznaczenia; mcp:research nie zawiera go.
402Sprawdź Billing i bieżącą cenę. Utworzenie ważnego kredytu nie dodaje kredytów.
429Podążaj za Retry-After. Przed podjęciem decyzji o ponownym wykonaniu zadania należy zachować dotychczasowe zadanie lub wynik ID.
Czas lub niekompletna odpowiedźNależy zachować zapytanie ID i sprawdzić History. Czytaj kontinuacje wyników dużych wyników za pomocą get_result zamiast powtarzania wyszukiwania.

Idź dalej