Aller au contenu
FR
Obtenir une clé API
Parcourir la documentation

Premiers pas

MCP FlashData

Donnez à votre agent des outils Google Search et YouTube. Connectez votre hôte, puis demandez un premier résultat.

Sur cette page

1. Connecter l’hôte et s’authentifier

Choisissez Codex ou OpenClaw pour une connexion OAuth dans le navigateur. Pour un autre hôte, choisissez Distant / clé API s’il prend en charge Streamable HTTP et les en-têtes personnalisés, ou Local / stdio s’il lance des processus MCP. Le serveur hébergé ne nécessite aucune installation locale.

Ajoutez la configuration ci-dessous à ~/.codex/config.toml, puis exécutez la commande de connexion. Inscrivez-vous ou connectez-vous à FlashData et autorisez l’accès dans le navigateur. Démarrez ensuite une nouvelle session Codex.

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"
Se connecter
codex mcp login flashdata --scopes mcp:research

2. Vérifier la connexion

Envoyez cette consigne dans une nouvelle session de l’agent. Les appels get_pricing et get_balance doivent réussir et indiquer un tarif disponible pour google_search ainsi que votre solde. Un solde nul signifie que vous devez ajouter des crédits pour effectuer la recherche ; ce n’est pas un échec d’authentification.

Vérifier la connexion
Utilise la connexion MCP flashdata existante.
Appelle get_pricing avec {"source":"google_search","request_count":1}.
Appelle get_balance avec {}.
Indique si les deux appels ont réussi, si un tarif est disponible pour la source
et quel est le solde de crédits disponible. Un solde nul n’est pas un échec d’authentification.
Ne lance aucune recherche ni aucun téléchargement, ne crée pas d’essai et ne modifie pas les identifiants.

3. Demander votre première tâche

Collez cette consigne dans votre agent connecté. La consultation du solde et des tarifs est gratuite ; la recherche consomme des crédits du compte.

Consigne pour la première tâche
Utilise FlashData pour vérifier mon solde et le prix d’une recherche Google. Si les crédits sont suffisants, appelle google_search une seule fois avec query "battery recycling research", num 5 et mode "realtime". Renvoie les titres, les URL des sources, de courts extraits et les crédits réellement utilisés. Arrête-toi après cette tâche.

Vérifier le résultat

Votre agent doit renvoyer les liens des sources, leurs extraits et les crédits réellement utilisés. Le résultat de recherche sous-jacent contient status: done et results[].organic. Un résultat vide est valide ; l’agent doit le signaler. L’exemple ci-dessous est illustratif.

Exemple de réponse
Une recherche Google effectuée.
1. Recherche sur le recyclage des batteries — https://example.org/recycling
   Exemple d’extrait d’un résultat de recherche.
Crédits utilisés : 0.02

Outils disponibles

Les appels par clé API utilisent les autorisations accordées à cette clé. Consultez les outils et schémas d’entrée du serveur pour connaître le catalogue complet à jour.

TâcheOutilAccès
Rechercher sur Googlegoogle_searchmcp:research / API key
Trouver des vidéos YouTubeyoutube_searchmcp:research / API key
Lire les métadonnées d’une vidéoyoutube_metadatamcp:research / API key
Récupérer les sous-titres existantsyoutube_transcriptmcp:research / API key
Télécharger une vidéo ou une piste audioyoutube_downloadClé API propriétaire et stockage de destination
Consulter le compte et les tarifsget_balance, get_pricing, get_limits, get_usageConsultation gratuite du compte

OAuth, autorisations et essais

OAuth connecte votre compte propriétaire vérifié et permet à l’hôte de stocker et de renouveler les jetons. L’autorisation mcp:research couvre les quatre sources de recherche ci-dessus. Les connexions par clé API utilisent un en-tête X-API-Key protégé et peuvent inclure d’autres sources autorisées.

Pour essayer FlashData avant de créer un compte, utilisez le parcours d’essai de la CLI. OAuth MCP connecte un compte propriétaire ; il ne crée pas d’essai et ne rattache pas un essai à votre compte. Un profil CLI n’est pas automatiquement partagé avec votre hôte MCP.

Dépannage

ProblèmeSolution
Aucun outil FlashDataTerminez l’autorisation, reconnectez-vous et démarrez une nouvelle session. Vérifiez l’URL et le transport Streamable HTTP.
invalid_client / callback errorPour Codex ou OpenClaw, utilisez la configuration exacte du client et un navigateur capable de joindre l’adresse de retour locale. Pour un autre hôte, utilisez la configuration par clé API ou stdio prise en charge, décrite ci-dessus.
401Reconnectez l’accès OAuth expiré ou révoqué, ou vérifiez la clé API fournie à l’hôte. Répétez la vérification gratuite.
403Vérifiez la source demandée et les autorisations de la clé. YouTube Download nécessite une clé API propriétaire avec youtube_download et un stockage de destination ; mcp:research ne l’inclut pas.
402Consultez la facturation et le tarif actuel. Reconnecter des identifiants valides n’ajoute pas de crédits.
429Respectez Retry-After. Conservez tout identifiant de traitement ou de résultat existant avant de décider de relancer la tâche.
Délai dépassé ou réponse incomplèteConservez l’identifiant de requête et consultez l’historique. Récupérez la suite des résultats volumineux avec get_result au lieu de répéter la recherche.

Pour aller plus loin