Parcourir la documentation
Premiers pas
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.
[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"codex mcp login flashdata --scopes mcp:researchExécutez ces commandes dans le profil OpenClaw utilisé par votre agent. Inscrivez-vous ou connectez-vous et autorisez l’accès dans le navigateur, puis démarrez une nouvelle session. Le contrôle doctor vérifie la connexion enregistrée.
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 --probeCréez ou réutilisez une clé autorisant Google Search. Ajoutez un serveur dans les paramètres MCP de votre hôte avec les champs ci-dessous. Placez la clé dans le champ d’en-tête protégé, puis reconnectez-vous. Aucune commande OAuth n’est nécessaire.
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEYNécessite Node.js 22.18+ et une clé API autorisant Google Search. Ajoutez cette configuration à un hôte acceptant le format JSON mcpServers. Remplacez YOUR_API_KEY dans sa configuration locale protégée, puis redémarrez l’hôte. Sous Windows, utilisez npx.cmd si l’hôte exige un nom de fichier exécutable.
Le paquet npm à version fixe exécute le serveur MCP local. La CLI FlashData autonome est un exécutable distinct.
{
"mcpServers": {
"flashdata": {
"command": "npx",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "YOUR_API_KEY"
}
}
}
}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.
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.
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.
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.02Outils 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âche | Outil | Accès |
|---|---|---|
| Rechercher sur Google | google_search | mcp:research / API key |
| Trouver des vidéos YouTube | youtube_search | mcp:research / API key |
| Lire les métadonnées d’une vidéo | youtube_metadata | mcp:research / API key |
| Récupérer les sous-titres existants | youtube_transcript | mcp:research / API key |
| Télécharger une vidéo ou une piste audio | youtube_download | Clé API propriétaire et stockage de destination |
| Consulter le compte et les tarifs | get_balance, get_pricing, get_limits, get_usage | Consultation 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ème | Solution |
|---|---|
| Aucun outil FlashData | Terminez l’autorisation, reconnectez-vous et démarrez une nouvelle session. Vérifiez l’URL et le transport Streamable HTTP. |
| invalid_client / callback error | Pour 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. |
| 401 | Reconnectez 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. |
| 403 | Vé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. |
| 402 | Consultez la facturation et le tarif actuel. Reconnecter des identifiants valides n’ajoute pas de crédits. |
| 429 | Respectez 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ète | Conservez 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. |