# FlashData MCP

Dê ao seu agente Google Search e YouTube ferramentas. Conecte seu anfitrião, e peça seu primeiro resultado.

Referência canônica: https://flashdata.dev/pt/docs/integrations/mcp-clients
2026-11-05 por FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-mcp) — Servidor oficial MCP
- [Referência MCP](https://flashdata.dev/pt/docs/mcp/reference.md) — Ferramentas, parâmetros e respostas
- [Obtenha uma chave de API](https://flashdata.dev/app/api-keys) — Para hosts que usam autenticação de cabeçalho

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

## 1. Conecte e entre na sua conta

Escolha Codex ou OpenClaw para OAuth baseado em navegador. Para outro host, escolha a chave Remote / API se ele suporta o HTTP Streamable e cabeçalhos personalizados, ou Local / stdio se ele lança processos MCP. O servidor não precisa de instalação local.

### Codex

Mesclar a configuração abaixo em ~/.codex/config.toml e, em seguida, executar o comando de login. Complete o registro FlashData ou inscreva-se e consente no navegador. Comece uma nova sessão Codex após o 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"
```

#### Entrar

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


### OpenClaw

Execute esses comandos no perfil OpenClaw que seu agente usa. Inscrição completa ou inscrição e consentimento no navegador, então comece uma nova sessão. A sonda médica verifica a conexão salva.

#### Configure, inscreva-se e verifique. 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
```


### Tecla remota / API

Crie uma chave com permissão Google Search, ou reutilize uma. Adicione um servidor nas configurações MCP do seu host usando os campos abaixo. Coloque a chave em seu campo de cabeçalho protegido e reconecte-se; nenhum comando OAuth é necessário.

#### MCP configurações

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

- [Crie uma chave API](https://flashdata.dev/app/api-keys)

### Local / stdio

Requer Node.js 22.18+ e uma chave API com permissão Google Search. Mescle isso em um host que suporta mcpServers JSON. Substitua YOUR_API_KEY em sua configuração protegida local, e reinicie o host. Use npx.cmd em Windows se o host precisar de um nome de arquivo executável.

O pacote npm é executado pelo servidor local MCP. O FlashData CLI é um executável separado.

#### Configuração do MCP

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

- [Crie uma chave API](https://flashdata.dev/app/api-keys)
- [Documentação do servidor local](https://github.com/flashdatadev/flashdata-mcp)


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

## 2. Verifique a conexão

Mande isso para uma nova sessão de agentes. Espere chamadas get_pricing e get_balance bem sucedidas, um preço disponível para google_search e seu saldo de crédito disponível. Um saldo zero significa que você precisa de créditos para a busca, não significa que a autenticação falhou.

### Conexão checada

```text
Use os dados de conexão MCP existentes.
Chame get_pricing com {"source":"google_search","request_count":1}.
Chame get_balance com {}.
Relate se ambas as chamadas tiveram sucesso, se a fonte tem um preço disponível,
e o saldo de crédito disponível. Um equilíbrio zero não é uma falha de autenticação.
Não faça uma busca ou download, crie um teste ou mude de credenciais.
```


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

## 3. Peça sua primeira tarefa

Cole isso em seu agente conectado. O saldo e os preços são de graça, a busca usa créditos de conta.

### Primeiro pedido de tarefa

```text
Use FlashData para verificar meu saldo e o preço de uma busca Google. Se houver créditos suficientes, ligue para google_search uma vez com consulta "battery recycling research", num 5 e modo "realtime". Devolver títulos, fonte URLs, trechos curtos e créditos reais usados. Pare depois dessa tarefa.
```


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

### Confira o resultado

Seu agente deve devolver links e trechos, além dos créditos usados. O resultado da busca subjacente tem status: done e results[].organic. Um resultado vazio é válido, o agente deve reportar. O exemplo abaixo é ilustrativo.

#### Resposta de exemplo

```text
Completaram uma busca Google.
1. Pesquisa de reciclagem de baterias - https://example.org/recycling
   Um excerto de busca de exemplo.
Créditos usados: 0.02
```


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

## Ferramentas disponíveis

Chamadas API-chave usam as permissões concedidas para essa chave. Descubra as ferramentas do servidor e esquemas de entrada para o catálogo atual.

| Tarefa | Ferramenta | Acesso |
| --- | --- | --- |
| Pesquisar no Google | google_search | mcp:research / API key |
| Encontre vídeos YouTube | youtube_search | mcp:research / API key |
| Leia os metadados de vídeo | youtube_metadata | mcp:research / API key |
| Recupere legendas existentes | youtube_transcript | mcp:research / API key |
| Baixe vídeo ou áudio | youtube_download | Chave API + armazenamento de destino |
| Verifique a conta e os preços | get_balance, get_pricing, get_limits, get_usage | Conta livre lê |

- [Todas as ferramentas e parâmetros](https://flashdata.dev/pt/docs/mcp/reference.md#parameters)
- [Baixe a configuração](https://flashdata.dev/pt/docs/guides/youtube-download-guide/reference.md)

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

## Sobre OAuth, permissões e testes

OAuth conecta sua conta de proprietário verificada e permite que a loja de host e refresque fichas. A bolsa mcp:research cobre as quatro fontes de pesquisa acima. As conexões API usam um cabeçalho protegido X-API-Key e podem incluir outras fontes autorizadas.

Para tentar FlashData antes de criar uma conta, use o fluxo de teste CLI. MCP OAuth conecta uma conta de proprietário, não registra ou reivindica um teste. Um perfil CLI não é automaticamente compartilhado com seu anfitrião MCP.

- [Comece um teste de agente](https://flashdata.dev/pt/docs/guides/agent-onboarding/reference.md#access)
- [vinculação e transferência de credenciais](https://flashdata.dev/pt/docs/guides/agent-onboarding/reference.md#claim)
- [Reutilize o acesso salvo](https://flashdata.dev/pt/docs/guides/agent-access/reference.md#refresh)
- [Revogar o acesso](https://flashdata.dev/pt/docs/guides/agent-access/reference.md#revoke)

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

## Solução de problemas

| Problema | Tente isso |
| --- | --- |
| Sem ferramentas FlashData | Termine o consentimento, reconecte-se e comece uma nova sessão. Verifique o URL e transporte de HTTP. |
| invalid_client / callback error | Para Codex ou OpenClaw, use sua configuração exata de cliente e um navegador que pode chegar ao retorno local. Para outro hospedeiro, use a chave API ou a configuração Stdio acima. |
| 401 | Reconectar o acesso OAuth expirado ou revogado, ou verificar a chave API fornecida ao hospedeiro. Repita o verificação grátis. |
| 403 | Verifique a fonte e as permissões de chave solicitadas. YouTube Download requer uma chave API proprietário com youtube_download e armazenamento de destino; mcp:research não inclui. |
| 402 | Verifique Billing e o preço atual. Reconectar uma credencial válida não adiciona créditos. |
| 429 | Siga Retry-After. Mantenha qualquer trabalho existente ou resultado ID antes de decidir se tentar novamente a tarefa. |
| Tempo limite ou resposta incompleta | Mantenha o pedido ID e verifique History. Leia continuaçãos de resultados grandes com get_result em vez de repetir a busca. |

- [Billing](https://flashdata.dev/app/billing)
- [Requisito histórico](https://flashdata.dev/app/jobs)

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

## Vá mais longe

- [Construa um cliente MCP personalizado](https://flashdata.dev/pt/docs/guides/mcp-custom-client/reference.md)
- [Codex detalhes de configuração](https://flashdata.dev/pt/docs/integrations/codex/reference.md)
- [OpenClaw detalhes de configuração](https://flashdata.dev/pt/docs/integrations/openclaw/reference.md)
- [Tarefas recorrentes](https://flashdata.dev/pt/docs/guides/recurring-tasks/reference.md)
