# FlashData MCP

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

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/integrations/mcp-clients
Przegląd: 2026-11-05 przez FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Oficjalny serwer MCP
- [MCP odniesienia](https://flashdata.dev/pl/docs/mcp/reference.md) — Narzędzia, parametry i odpowiedzi
- [Uzyskaj klucz API](https://flashdata.dev/app/api-keys) — Dla komputerów, które używają uwierzytelniania nagłówka

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

## 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.

### Codex

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

```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ę

```bash
codex mcp login flashdata --scopes mcp:research
```


### OpenClaw

Uruchom te polecenia w profilu OpenClaw, którego używa Twój agent. Pełna rejestracja lub logowanie i zgoda w przeglądarce, a następnie rozpocząć nową sesję. Sonda lekarska sprawdziła uratowane połączenie.

#### Konfiguracja, wpisanie i sprawdzenie · 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
```


### Klawisz zdalny / API

Utwórz klucz za zgodą Google Search lub ponownie go użyj. Dodaj serwer w ustawieniach MCP hosta za pomocą pól poniżej. Umieścić klucz w chronionym polu nagłówka i ponownie połączyć; nie jest potrzebne polecenie OAuth.

#### Ustawienia MCP

```text
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEY
```

- [Utwórz klucz API](https://flashdata.dev/app/api-keys)

### Lokalne / stdio

Wymaga Node.js 22.18 + i klawisza API z pozwoleniem Google Search. Połącz to z hostem, który obsługuje mcpServers JSON. Zastąp YOUR_API_KEY w swojej lokalnej konfiguracji chronionej, a następnie ponownie uruchom hosta. Użyj npx.cmd na Windows, jeśli host wymaga nazwy pliku wykonywalnego.

Pakiet npm jest obsługiwany przez lokalny serwer MCP. Samodzielny FlashData CLI jest oddzielnym wykonywalnym.

#### Konfiguracja MCP

```json
{
  "mcpServers": {
    "flashdata": {
      "command": "npx",
      "args": [
        "--yes",
        "--package=@flashdata-dev/mcp@0.2.0",
        "flashdata-mcp"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

- [Utwórz klucz API](https://flashdata.dev/app/api-keys)
- [Dokumentacja serwera lokalnego](https://github.com/flashdatadev/flashdata-mcp)


<a id="sign-in"></a>

## 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

```text
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.
```


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

## 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

```text
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.
```


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

### 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

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


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

## 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.

| Zadanie | Narzędzie | Dostęp |
| --- | --- | --- |
| Szukaj Google | google_search | mcp:research / API key |
| Znajdź filmy YouTube | youtube_search | mcp:research / API key |
| Odczytywanie metadanych wideo | youtube_metadata | mcp:research / API key |
| Odzyskiwanie istniejących zapisów | youtube_transcript | mcp:research / API key |
| Pobierz wideo lub audio | youtube_download | Właściciel API klucz + miejsce przeznaczenia |
| Sprawdź rachunek i ustalanie cen | get_balance, get_pricing, get_limits, get_usage | Bezpłatne czytanie konta |

- [Wszystkie narzędzia i parametry](https://flashdata.dev/pl/docs/mcp/reference.md#parameters)
- [Pobierz konfigurację](https://flashdata.dev/pl/docs/guides/youtube-download-guide/reference.md)

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

## 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.

- [Rozpocząć proces agenta](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md#access)
- [Twierdzenie i przekazanie uprawnień](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md#claim)
- [Ponowne użycie zapisanego dostępu](https://flashdata.dev/pl/docs/guides/agent-access/reference.md#refresh)
- [Dostęp ponownie](https://flashdata.dev/pl/docs/guides/agent-access/reference.md#revoke)

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

## Rozwiązywanie problemów

| Problem | Spróbuj tego |
| --- | --- |
| Brak narzędzi FlashData | Zakończ zgodę, ponownie połącz się i rozpocznij nową sesję. Sprawdź transport URL i Streamable HTTP. |
| invalid_client / callback error | W 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. |
| 401 | Uzyskiwanie dostępu do OAuth wygasło lub cofnięto go lub sprawdź klucz API dostarczony hostowi. Powtórzyć bezpłatny czek. |
| 403 | Sprawdź 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. |
| 402 | Sprawdź Billing i bieżącą cenę. Utworzenie ważnego kredytu nie dodaje kredytów. |
| 429 | Podąż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. |

- [Billing](https://flashdata.dev/app/billing)
- [Poproś o historię](https://flashdata.dev/app/jobs)

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

## Idź dalej

- [Zbuduj własny klient MCP](https://flashdata.dev/pl/docs/guides/mcp-custom-client/reference.md)
- [Szczegóły konfiguracji Codex](https://flashdata.dev/pl/docs/integrations/codex/reference.md)
- [Szczegóły konfiguracji OpenClaw](https://flashdata.dev/pl/docs/integrations/openclaw/reference.md)
- [Zadania cykliczne](https://flashdata.dev/pl/docs/guides/recurring-tasks/reference.md)
