# FlashData MCP

Geef uw agent Google Search en YouTube tools. Sluit uw host aan en vraag dan om uw eerste resultaat.

Canonische referentie: https://flashdata.dev/nl/docs/integrations/mcp-clients
Beoordeeld: 2026-11-05 door FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Officiële MCP-server
- [MCP-referentie](https://flashdata.dev/nl/docs/mcp/reference.md) — Hulpmiddelen, parameters en reacties
- [Een API-sleutel aanmaken](https://flashdata.dev/app/api-keys) — Voor hosts die header-authenticatie gebruiken

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

## 1. Verbinden en aanmelden

Kies Codex of OpenClaw voor browser-gebaseerde OAuth. Voor een andere host, kies Remote / API sleutel als het streamable HTTP en aangepaste headers ondersteunt, of Lokale / stdio als het MCP processen start. De gehoste server heeft geen lokale installatie nodig.

### Codex

Voeg de configuratie hieronder samen in ~/.codex/config.toml en voer vervolgens het aanmeldcommando uit. Complete FlashData aanmelding of aanmelding en toestemming in de browser. Start een nieuwe Codex sessie na inloggen.

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

#### Inloggen

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


### OpenClaw

Voer deze commando's uit in het OpenClaw-profiel dat uw agent gebruikt. Volledige aanmelding of aanmelding en toestemming in de browser, start dan een nieuwe sessie. De dokter onderzoekt de opgeslagen verbinding.

#### Configureren, aanmelden en controleren · 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
```


### Remote / API sleutel

Maak een sleutel aan met Google Search-permissie, of hergebruik er een. Voeg een server toe aan de MCP-instellingen van uw host met onderstaande velden. Plaats de sleutel in het beveiligde headerveld en herverbinding; er is geen OAuth commando nodig.

#### MCP-instellingen

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

- [Een API-sleutel aanmaken](https://flashdata.dev/app/api-keys)

### Lokale / stdio

Vereist Node.js 22.18+ en een API sleutel met Google Search toestemming. Dit samenvoegen tot een host die mcpServers JSON ondersteunt. Vervang YOUR_API_KEY in zijn lokale beveiligde configuratie en herstart de host. Gebruik npx.cmd op Windows als de host een uitvoerbare bestandsnaam nodig heeft.

Het gepinde npm pakket draait op de lokale MCP server. De standalone FlashData CLI is een apart uitvoerbaar bestand.

#### MCP configuratie

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

- [Een API-sleutel aanmaken](https://flashdata.dev/app/api-keys)
- [Lokale serverdocumentatie](https://github.com/flashdatadev/flashdata-mcp)


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

## 2. Controleer de verbinding

Stuur dit in een nieuwe agent sessie. Verwacht succesvolle get_pricing en get_balance-gesprekken, een beschikbare prijs voor google_search en uw beschikbare kredietsaldo. Een nulbalans betekent dat je credits nodig hebt voor de zoekopdracht; het betekent niet dat authenticatie mislukt is.

### Verbindingscontrole

```text
Gebruik de bestaande flashdata MCP-verbinding.
Bel get_pricing met {"source":"google_search","request_count":1}.
Bel get_balance met {}.
Rapporteren of beide oproepen zijn geslaagd, of de bron een beschikbare prijs heeft,
en het beschikbare kredietsaldo. Een nulbalans is geen authenticatiefout.
Voer geen zoekopdracht of download uit, maak een proefversie aan of wijzig de referenties.
```


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

## 3. Vraag naar je eerste taak

Plak dit in je verbonden agent. Het saldo en de prijscontroles zijn gratis; de zoekopdracht maakt gebruik van rekeningkredieten.

### Eerste taakprompt

```text
Gebruik FlashData om mijn saldo en de prijs van een Google zoekopdracht te controleren. Als er genoeg credits zijn, bel dan eens google_search met query "battery recycling research", num 5 en mode "realtime". Geef titels, bron URLs, korte fragmenten en werkelijke credits gebruikt. Stop na deze taak.
```


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

### Het resultaat controleren

Je agent moet bronlinks en fragmenten teruggeven, plus de gebruikte credits. Het onderliggende zoekresultaat heeft status: done en results[].organic. Een leeg resultaat is geldig; de agent moet het melden. Het voorbeeld hieronder is illustratief.

#### Voorbeeld antwoord

```text
Een Google-zoekopdracht voltooid.
1. Onderzoek naar de recycling van accu's https://example.org/recycling
   Een voorbeeld zoekfragment.
Gebruikte kredieten: 0.02
```


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

## Beschikbare instrumenten

API-key calls gebruiken de rechten die aan die sleutel zijn verleend. Ontdek de tools van de server en invoerschema's voor de volledige huidige catalogus.

| Taak | Hulpmiddel | Toegang |
| --- | --- | --- |
| Google doorzoeken | google_search | mcp:research / API key |
| Zoek YouTube video's | youtube_search | mcp:research / API key |
| Videometadata lezen | youtube_metadata | mcp:research / API key |
| Bestaande bijschriften ophalen | youtube_transcript | mcp:research / API key |
| Video of audio downloaden | youtube_download | Eigenaar API sleutel + bestemmingsopslag |
| Account en prijzen controleren | get_balance, get_pricing, get_limits, get_usage | Gratis account leest |

- [Alle gereedschappen en parameters](https://flashdata.dev/nl/docs/mcp/reference.md#parameters)
- [Download setup](https://flashdata.dev/nl/docs/guides/youtube-download-guide/reference.md)

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

## Over OAuth, machtigingen en proeven

OAuth verbindt uw geverifieerde eigenaar account en laat de host store en verfrissen tokens. De mcp:research-subsidie heeft betrekking op de vier bovengenoemde onderzoeksbronnen. API-sleutelverbindingen maken gebruik van een beschermde X-API-Key-header en kunnen andere geautoriseerde bronnen bevatten.

Om FlashData te proberen voordat u een account aanmaakt, gebruikt u de CLI trial flow. MCP OAuth verbindt een eigenaaraccount; het registreert of claimt geen proefversie. Een CLI-profiel wordt niet automatisch gedeeld met uw MCP-host.

- [Start een proef met stoffen](https://flashdata.dev/nl/docs/guides/agent-onboarding/reference.md#access)
- [Claims en credential handoff](https://flashdata.dev/nl/docs/guides/agent-onboarding/reference.md#claim)
- [Opgeslagen toegang hergebruiken](https://flashdata.dev/nl/docs/guides/agent-access/reference.md#refresh)
- [Toegang ongedaan maken](https://flashdata.dev/nl/docs/guides/agent-access/reference.md#revoke)

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

## Problemen oplossen

| Probleem | Probeer dit eens |
| --- | --- |
| Geen FlashData-gereedschappen | Voltooi toestemming, opnieuw verbinden en start een nieuwe sessie. Controleer het URL en streamable HTTP transport. |
| invalid_client / callback error | Voor Codex of OpenClaw, gebruik de exacte configuratie van de client en een browser die de lokale callback kan bereiken. Voor een andere host, gebruik de ondersteunde API-toets of stdio-instellingen hierboven. |
| 401 | Vervallen of ingetrokken OAuth-toegang opnieuw verbinden, of de API-sleutel controleren die aan de host wordt geleverd. Herhaal de gratis cheque. |
| 403 | Controleer de gevraagde bron en sleutelrechten. YouTube Download vereist een eigenaar API sleutel met youtube_download en bestemmingsopslag; mcp:research bevat deze niet. |
| 402 | Controleer Billing en de huidige prijs. Het opnieuw verbinden van een geldige credential voegt geen credits toe. |
| 429 | Volg Retry-After. Houd een bestaande baan of resultaat ID voordat u beslist of u de taak opnieuw wilt proberen. |
| Timeout of onvolledig antwoord | Houd de aanvraag ID en controleer History. Lees grote resultaten met get_result in plaats van de zoekopdracht te herhalen. |

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

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

## Ga verder

- [Bouw een aangepaste MCP-client](https://flashdata.dev/nl/docs/guides/mcp-custom-client/reference.md)
- [Codex setup details](https://flashdata.dev/nl/docs/integrations/codex/reference.md)
- [OpenClaw setup details](https://flashdata.dev/nl/docs/integrations/openclaw/reference.md)
- [Terugkerende taken](https://flashdata.dev/nl/docs/guides/recurring-tasks/reference.md)
