# FlashData MCP

Geben Sie Ihrem Agenten Google Search und YouTube Tools. Verbinden Sie Ihren Gastgeber und fragen Sie nach Ihrem ersten Ergebnis.

Kanonische Referenz: https://flashdata.dev/de/docs/integrations/mcp-clients
Test: 2026-11-05 von FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Offizieller MCP Server
- [MCP](https://flashdata.dev/de/docs/mcp/reference.md) — Tools, Parameter und Antworten
- [API-Schlüssel erstellen](https://flashdata.dev/app/api-keys) — Für Hosts, die Header-Authentifizierung verwenden

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

## 1. Verbinden und anmelden

Wählen Sie Codex oder OpenClaw für browserbasiertes OAuth. Wählen Sie für einen anderen Host den Remote / API-Schlüssel, wenn er Streamable HTTP und benutzerdefinierte Header unterstützt, oder Local / stdio, wenn er MCP-Prozesse startet. Der Hosted Server benötigt keine lokale Installation.

### Codex

Fügen Sie die Konfiguration unten in ~/.codex/config.toml zusammen und führen Sie dann den Login-Befehl aus. Komplette FlashData-Anmeldung oder -Anmeldung und Zustimmung im Browser. Starten Sie eine neue Codex-Sitzung nach dem Login.

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

#### Anmelden

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


### OpenClaw

Führen Sie diese Befehle im OpenClaw-Profil aus, das Ihr Agent verwendet. Vollständige Anmeldung oder Anmeldung und Zustimmung im Browser, dann starten Sie eine neue Sitzung. Die Arztsonde überprüft die gespeicherte Verbindung.

#### Konfigurieren, Anmelden und Überprüfen · 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
```


### Fernbedienung / API Schlüssel

Erstellen Sie einen Schlüssel mit der Google Search-Berechtigung oder verwenden Sie einen erneut. Fügen Sie einen Server in den MCP-Einstellungen Ihres Hosts mit den folgenden Feldern hinzu. Legen Sie den Schlüssel in sein geschütztes Header-Feld und verbinden Sie es erneut; es wird kein OAuth-Befehl benötigt.

#### MCP Einstellungen

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

- [Erstellen Sie einen API-Schlüssel](https://flashdata.dev/app/api-keys)

### Lokal / Stdio

Erfordert Node.js 22.18+ und einen API Schlüssel mit Google Search Berechtigung. Fügen Sie dies zu einem Host zusammen, der mcpServers JSON unterstützt. Ersetzen Sie YOUR_API_KEY in seiner lokalen geschützten Konfiguration und starten Sie dann den Host neu. Verwenden Sie npx.cmd auf Windows, wenn der Host einen ausführbaren Dateinamen benötigt.

Das angeheftete npm-Paket führt den lokalen MCP-Server aus. Die eigenständige FlashData CLI ist eine separate ausführbare Datei.

#### MCP Konfiguration

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

- [Erstellen Sie einen API-Schlüssel](https://flashdata.dev/app/api-keys)
- [Lokale Serverdokumentation](https://github.com/flashdatadev/flashdata-mcp)


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

## 2. Überprüfen Sie die Verbindung

Senden Sie dies in einer frischen Agentensitzung. Erwarten Sie erfolgreiche get_pricing und get_balance Anrufe, einen verfügbaren Preis für google_search und Ihr verfügbares Guthaben. Ein Nullsaldo bedeutet, dass Sie Credits für die Suche benötigen; es bedeutet nicht, dass die Authentifizierung fehlgeschlagen ist.

### Anschlussprüfung

```text
Verwenden Sie die vorhandene Flashdata MCP-Verbindung.
Rufen Sie get_pricing mit {"source":"google_search","request_count":1} an.
Rufen Sie get_balance mit {} an.
Geben Sie an, ob beide Anrufe erfolgreich waren, ob die Quelle einen verfügbaren Preis hat;
und den verfügbaren Kreditsaldo. Ein Nullsaldo ist kein Authentifizierungsfehler.
Führen Sie keine Suche aus oder laden Sie sie herunter, erstellen Sie eine Testversion oder ändern Sie Ihre Anmeldeinformationen.
```


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

## 3. Fragen Sie nach Ihrer ersten Aufgabe

Fügen Sie dies in Ihren Connected Agent ein. Die Saldo- und Preisprüfungen sind kostenlos; Die Suche verwendet Kontogutschriften.

### Erste Aufgabe prompt

```text
Verwenden Sie FlashData, um mein Guthaben und den Preis einer Google-Suche zu überprüfen. Wenn genügend Credits vorhanden sind, rufen Sie google_search einmal mit der Abfrage "battery recycling research", num 5 und Modus "realtime" auf. Rückgabetitel, Quelle URLs, kurze Auszüge und tatsächliche Credits verwendet. Stoppen Sie nach dieser Aufgabe.
```


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

### Ergebnis prüfen

Ihr Agent sollte Quellenlinks und Auszüge sowie die tatsächlich verwendeten Credits zurückgeben. Das zugrunde liegende Suchergebnis hat status: done und results[].organic. Ein leeres Ergebnis ist gültig; der Agent sollte es melden. Das folgende Beispiel ist illustrativ.

#### Beispielantwort

```text
Eine Google Suche abgeschlossen.
1. Batterierecyclingforschung — https://example.org/recycling
   Ein Beispiel-Suchauszug.
Verwendete Credits: 0.02
```


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

## Verfügbare Werkzeuge

API-Schlüsselaufrufe verwenden die Berechtigungen, die diesem Schlüssel gewährt wurden. Entdecken Sie die Tools und Eingabeschemata des Servers für den vollständigen aktuellen Katalog.

| Aufgabe | Werkzeug | Zugang |
| --- | --- | --- |
| Suche nach Google | google_search | mcp:research / API key |
| Finden Sie YouTube Videos | youtube_search | mcp:research / API key |
| Video-Metadaten lesen | youtube_metadata | mcp:research / API key |
| Bestehende Bildunterschriften abrufen | youtube_transcript | mcp:research / API key |
| Herunterladen von Video oder Audio | youtube_download | Besitzer API Schlüssel + Zielspeicherung |
| Konto prüfen und Preisgestaltung | get_balance, get_pricing, get_limits, get_usage | Kostenloses Konto liest |

- [Alle Werkzeuge und Parameter](https://flashdata.dev/de/docs/mcp/reference.md#parameters)
- [Download-Einrichtung](https://flashdata.dev/de/docs/guides/youtube-download-guide/reference.md)

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

## Über OAuth, Berechtigungen und Testversionen

OAuth verbindet Ihr verifiziertes Besitzerkonto und lässt den Host Token speichern und aktualisieren. Der mcp:research-Zuschuss deckt die vier oben genannten Forschungsquellen ab. API-Schlüsselverbindungen verwenden einen geschützten X-API-Key-Header und können andere autorisierte Quellen enthalten.

Um FlashData auszuprobieren, bevor Sie ein Konto erstellen, verwenden Sie den Testablauf von CLI. MCP OAuth verbindet ein Besitzerkonto; es registriert oder beansprucht keine Testversion. Ein CLI-Profil wird nicht automatisch mit Ihrem MCP-Host geteilt.

- [Starten Sie eine Agent Trial](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md#access)
- [Beanspruchung und Übergabe von Berechtigungsnachweisen](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md#claim)
- [Gespeicherter Zugriff wiederverwenden](https://flashdata.dev/de/docs/guides/agent-access/reference.md#refresh)
- [Zugang widerrufen](https://flashdata.dev/de/docs/guides/agent-access/reference.md#revoke)

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

## Fehlerbehebung

| Problem | Probieren Sie dies aus |
| --- | --- |
| Keine FlashData-Tools | Beenden Sie die Zustimmung, verbinden Sie sich wieder und starten Sie eine neue Sitzung. Überprüfen Sie den URL und den Streamable HTTP Transport. |
| invalid_client / callback error | Verwenden Sie für Codex oder OpenClaw die genaue Clientkonfiguration und einen Browser, der den lokalen Rückruf erreichen kann. Verwenden Sie für einen anderen Host die oben genannte API-Taste oder Stdio-Einrichtung. |
| 401 | Der OAuth-Zugriff wurde erneut verbunden oder widerrufen, oder überprüfen Sie den API-Schlüssel, der dem Host zugeführt wurde. Wiederholen Sie den kostenlosen Check. |
| 403 | Überprüfen Sie die angeforderten Quell- und Schlüsselberechtigungen. YouTube Download erfordert einen Besitzer-API-Schlüssel mit youtube_download und Zielspeicherung; mcp:research enthält ihn nicht. |
| 402 | Überprüfen Sie Billing und den aktuellen Preis. Das Wiederverbinden eines gültigen Anmelders fügt keine Credits hinzu. |
| 429 | Folgen Sie Retry-After. Behalten Sie einen vorhandenen Job oder ein Ergebnis ID, bevor Sie entscheiden, ob Sie die Aufgabe erneut versuchen möchten. |
| Timeout oder unvollständige Antwort | Behalten Sie die Anforderung ID und überprüfen Sie History. Lesen Sie Fortsetzungen mit großem Ergebnis mit get_result, anstatt die Suche zu wiederholen. |

- [Billing](https://flashdata.dev/app/billing)
- [Anfrageverlauf](https://flashdata.dev/app/jobs)

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

## Weiter gehen

- [Erstellen Sie einen eigenen MCP Client](https://flashdata.dev/de/docs/guides/mcp-custom-client/reference.md)
- [Codex Setup Details](https://flashdata.dev/de/docs/integrations/codex/reference.md)
- [OpenClaw Setup Details](https://flashdata.dev/de/docs/integrations/openclaw/reference.md)
- [Wiederkehrende Aufgaben](https://flashdata.dev/de/docs/guides/recurring-tasks/reference.md)
