Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Primeiros passos

FlashData MCP

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

Nesta página

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.

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
[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
codex mcp login flashdata --scopes mcp:research

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

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

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

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.

TarefaFerramentaAcesso
Pesquisar no Googlegoogle_searchmcp:research / API key
Encontre vídeos YouTubeyoutube_searchmcp:research / API key
Leia os metadados de vídeoyoutube_metadatamcp:research / API key
Recupere legendas existentesyoutube_transcriptmcp:research / API key
Baixe vídeo ou áudioyoutube_downloadChave API + armazenamento de destino
Verifique a conta e os preçosget_balance, get_pricing, get_limits, get_usageConta livre lê

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.

Solução de problemas

ProblemaTente isso
Sem ferramentas FlashDataTermine o consentimento, reconecte-se e comece uma nova sessão. Verifique o URL e transporte de HTTP.
invalid_client / callback errorPara 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.
401Reconectar o acesso OAuth expirado ou revogado, ou verificar a chave API fornecida ao hospedeiro. Repita o verificação grátis.
403Verifique 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.
402Verifique Billing e o preço atual. Reconectar uma credencial válida não adiciona créditos.
429Siga Retry-After. Mantenha qualquer trabalho existente ou resultado ID antes de decidir se tentar novamente a tarefa.
Tempo limite ou resposta incompletaMantenha o pedido ID e verifique History. Leia continuaçãos de resultados grandes com get_result em vez de repetir a busca.

Vá mais longe