# FlashData MCP

Dare al vostro agente Google Ricerca e strumenti YouTube. Collega il tuo host, quindi chiedi il tuo primo risultato.

Riferimento canonico: https://flashdata.dev/it/docs/integrations/mcp-clients
Recensito: 2026-11-05 da FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Server ufficiale MCP
- [Riferimento MCP](https://flashdata.dev/it/docs/mcp/reference.md) — Strumenti, parametri e risposte
- [Ottieni una chiave API](https://flashdata.dev/app/api-keys) — Per gli host che utilizzano l'autenticazione dell'intestazione

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

## 1. Collegare e firmare

Scegliere Codex o OpenClaw per il browser basato OAuth. Per un altro host, scegliere Remote / API chiave se supporta Streamable HTTP e intestazioni personalizzate, o Local / stdio se lancia processi MCP. Il server ospitato non ha bisogno di installazione locale.

### Codex

Unire la configurazione qui sotto in ~/.codex/config.toml, quindi eseguire il comando di login. Completare l'iscrizione FlashData o l'accesso e il consenso nel browser. Avviare una nuova sessione Codex dopo il 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"
```

#### Accedi

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


### OpenClaw

Eseguire questi comandi nel profilo OpenClaw utilizzato dall'agente. Registrazione completa o registrazione e consenso nel browser, quindi avviare una sessione fresca. La sonda del medico controlla la connessione salvata.

#### Configurare, firmare e controllare · 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
```


### Chiave a distanza / API

Creare una chiave con il permesso di ricerca Google, o riutilizzarne uno. Aggiungi un server nelle impostazioni MCP del tuo host utilizzando i campi sottostanti. Metta la chiave nel suo campo di intestazione protetto e ricollega; non è necessario alcun comando OAuth.

#### Impostazioni MCP

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

- [Creare una chiave API](https://flashdata.dev/app/api-keys)

### Locale/Studio

Richiede Node.js 22.18+ e una chiave API con il permesso di ricerca Google. Unire questo in un host che supporta mcpServers JSON. Sostituire YOUR_API_KEY nella sua configurazione protetta locale, quindi riavviare l'host. Utilizzare npx.cmd su Windows se l'host richiede un nome file eseguibile.

Il pacchetto npm pinned esegue il server MCP locale. Lo standalone FlashData CLI è un eseguibile separato.

#### Configurazione MCP

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

- [Creare una chiave API](https://flashdata.dev/app/api-keys)
- [Documentazione del server locale](https://github.com/flashdatadev/flashdata-mcp)


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

## 2. Controllare la connessione

Mandalo in una sessione di agenti freschi. Aspettatevi chiamate get_pricing e get_balance di successo, un prezzo disponibile per google_search e il vostro saldo di credito disponibile. Un saldo zero significa che hai bisogno di crediti per la ricerca; non significa che l'autenticazione sia fallita.

### Controllo della connessione

```text
Utilizzare la connessione flashdata esistente MCP.
Chiama get_pricing con {"source":"google_search","request_count":1}.
Chiama get_balance con {}.
Se entrambe le chiamate sono succedute, se la fonte ha un prezzo disponibile,
e il saldo di credito disponibile. Un saldo zero non è un guasto di autenticazione.
Non eseguire una ricerca o scaricare, creare una prova, o modificare le credenziali.
```


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

## 3. Chiedi il tuo primo compito

Incolla questo nel tuo agente collegato. I controlli di bilancia e prezzi sono gratuiti; la ricerca utilizza crediti di conto.

### Primo prompt delle attività

```text
Utilizzare FlashData per controllare il mio saldo e il prezzo di una ricerca Google. Se ci sono abbastanza crediti, chiamare google_search una volta con query "battery recycling research", num 5 e la modalità "realtime". Titoli di ritorno, fonte URLs, brevi estratti e crediti reali utilizzati. Smettetela dopo questo compito.
```


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

### Verifica il risultato

Il tuo agente dovrebbe restituire i link e gli estratti delle fonti, oltre ai crediti effettivi utilizzati. Il risultato di ricerca sottostante ha status: done e results[].organic. Un risultato vuoto è valido; l'agente deve segnalarlo. L'esempio qui sotto è illustrativo.

#### Esempio di risposta

```text
Completato una ricerca Google.
1. Ricerca per il riciclaggio di batterie — https://example.org/recycling
   Un esempio di ricerca estratto.
Crediti utilizzati: 0.02
```


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

## Strumenti disponibili

Le chiamate API-chiave usano le autorizzazioni concesse a quella chiave. Scopri gli strumenti e gli schemi di input del server per il catalogo completo.

| Compiti | Strumento | Accesso |
| --- | --- | --- |
| Ricerca Google | google_search | mcp:research / API key |
| Trova video YouTube | youtube_search | mcp:research / API key |
| Leggi i metadati video | youtube_metadata | mcp:research / API key |
| Recuperare le didascalie esistenti | youtube_transcript | mcp:research / API key |
| Scarica video o audio | youtube_download | Proprietario API chiave + archiviazione di destinazione |
| Controllare il conto e i prezzi | get_balance, get_pricing, get_limits, get_usage | Leggi di account gratuito |

- [Tutti gli strumenti e i parametri](https://flashdata.dev/it/docs/mcp/reference.md#parameters)
- [Scarica la configurazione](https://flashdata.dev/it/docs/guides/youtube-download-guide/reference.md)

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

## Informazioni su OAuth, autorizzazioni e prove

OAuth collega il tuo account proprietario verificato e lascia il negozio host e rinfresca i gettoni. La sovvenzione mcp:research copre le quattro fonti di ricerca sopra. Le connessioni API-chiave utilizzano un'intestazione X-API-Key protetta e possono includere altre fonti autorizzate.

Per provare FlashData prima di creare un account, utilizzare il flusso di prova CLI. MCP OAuth collega un account proprietario; non registra o reclama una prova. Un profilo CLI non viene condiviso automaticamente con il tuo host MCP.

- [Avviare una prova di agente](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md#access)
- [Rivendicazione e consegna delle credenziali](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md#claim)
- [Riutilizzare l'accesso salvato](https://flashdata.dev/it/docs/guides/agent-access/reference.md#refresh)
- [Accesso di fatturazione](https://flashdata.dev/it/docs/guides/agent-access/reference.md#revoke)

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

## Risoluzione dei problemi

| Problematiche | Prova questo |
| --- | --- |
| Strumenti FlashData | Termina il consenso, ricollega e avvia una sessione nuova. Controlla il trasporto URL e Streamable HTTP. |
| invalid_client / callback error | Per Codex o OpenClaw, utilizzare la sua configurazione client esatta e un browser che può raggiungere il callback locale. Per un altro host, utilizzare la sua configurazione API-chiave o stdio supportata sopra. |
| 401 | Ricollegare l'accesso OAuth scaduto o revocato, oppure controllare la chiave API fornita all'host. Ripeti il controllo gratuito. |
| 403 | Controllare la fonte richiesta e le autorizzazioni chiave. YouTube Download richiede un tasto API proprietario con youtube_download e lo storage di destinazione; mcp:research non lo include. |
| 402 | Controllare Billing e il prezzo attuale. Ricollegare una valida credenziali non aggiunge crediti. |
| 429 | Seguire Retry-After. Mantenere qualsiasi lavoro esistente o risultato ID prima di decidere se riprova l'attività. |
| Risposta tempestiva o incompleta | Tenere la richiesta ID e controllare History. Leggere le prosecuzioni di grandi risultati con get_result invece di ripetere la ricerca. |

- [Billing](https://flashdata.dev/app/billing)
- [Richiedi la cronologia](https://flashdata.dev/app/jobs)

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

## Go ulteriore

- [Costruire un client MCP personalizzato](https://flashdata.dev/it/docs/guides/mcp-custom-client/reference.md)
- [Dettagli di configurazione Codex](https://flashdata.dev/it/docs/integrations/codex/reference.md)
- [Dettagli di configurazione OpenClaw](https://flashdata.dev/it/docs/integrations/openclaw/reference.md)
- [Attività ricorrenti](https://flashdata.dev/it/docs/guides/recurring-tasks/reference.md)
