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

Intégrations

Codex

Donnez à Codex des outils Google Search et YouTube pour programmer et effectuer des recherches.

Sur cette page

Avant de commencer

Installez la CLI Codex et vérifiez son fonctionnement. Cette configuration MCP hébergée utilise OAuth pour Google Search, YouTube Search, les métadonnées et les transcriptions. Vous pouvez créer un compte FlashData lors de la connexion.

1. Ajouter le serveur MCP

Ajoutez cette entrée à ~/.codex/config.toml (ou au fichier config.toml dans CODEX_HOME). Conservez l’identifiant client enregistré et l’URL de rappel indiqués.

~/.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"

2. Se connecter

Exécutez la commande de connexion. Dans le navigateur, connectez-vous ou créez un compte et vérifiez son adresse e-mail, puis approuvez l’accès. Attendez la confirmation de connexion dans le terminal. Les requêtes utilisent les crédits de ce compte.

Se connecter
codex mcp login flashdata --scopes mcp:research

Vérifier la connexion gratuitement

Démarrez une nouvelle session Codex et vérifiez la présence de flashdata dans /mcp. Envoyez cette consigne ; les deux appels doivent réussir. Un solde nul confirme tout de même que la connexion fonctionne.

À coller dans votre agent
Utilisez la connexion MCP flashdata.
Appelez get_balance avec {} et get_pricing avec {"source":"google_search","request_count":1}.
Indiquez les crédits disponibles et le coût estimé. Ne lancez aucune recherche.

3. Exécuter votre première tâche

Envoyez cette consigne à votre agent connecté. Les vérifications sont gratuites ; la recherche unique consomme des crédits.

Consigne pour la première tâche
Utilisez le serveur MCP flashdata. Vérifiez mon solde et le coût d’une recherche Google.
Si le solde est suffisant, appelez google_search une seule fois avec query "site:docs.python.org/3/library/venv.html create virtual environment", num 5 et mode "realtime".
Expliquez comment créer un environnement virtuel Python à partir des sources obtenues.
Citez les sources et indiquez les crédits réellement utilisés. Arrêtez après cette tâche.

Résultat attendu

Vérifiez que l’appel à google_search est terminé avec status: done, des liens sources dans results[].organic et une réponse fondée sur ces sources. La consommation figure dans usage.credits ; ce n’est pas le nombre de résultats. Signalez explicitement les résultats vides.

Ce que vous pouvez demander

Cette connexion OAuth donne accès aux outils de recherche. YouTube Download utilise une clé API propriétaire et un stockage de destination via l’API ou la CLI.

TâcheOutil MCP
Trouver des sources web pour une réponse ou une implémentationgoogle_search
Trouver des vidéos YouTube pertinentesyoutube_search
Lire les titres, les chaînes et les métadonnées des vidéosyoutube_metadata
Récupérer la transcription d’une vidéo pour la résumeryoutube_transcript
Vérifier les crédits disponibles et le coût d’une requêteget_balance · get_pricing

Réutiliser l’accès pour les tâches récurrentes

Utilisez le même profil Codex, le même utilisateur du système et le même stockage d’identifiants. Créez la planification dans votre hôte d’agent ou votre planificateur existant ; FlashData fournit les outils de données.

Vérifier l’accès enregistré

Exécutez cette vérification gratuite dans une nouvelle session, dans l’environnement qui exécutera les tâches planifiées. Les deux appels doivent réussir sans nouvelle connexion dans le navigateur.

Vérifier la réutilisation
Réutilisez la connexion MCP flashdata existante.
Appelez get_balance avec {} et get_pricing avec {"source":"google_search","request_count":1}.
Indiquez si les deux appels ont réussi. Ne lancez aucune recherche et ne créez pas de nouvel accès.

Créer la tâche récurrente

Dans le planificateur de votre hôte, choisissez une heure et un fuseau horaire, par exemple tous les jours à 09:00 Asia/Shanghai. Utilisez la consigne ci-dessous pour la tâche. Exécutez-la une fois dans cet environnement et vérifiez le rapport enregistré avant d’activer la récurrence.

Consigne de la tâche
Réutilisez la connexion MCP flashdata existante. Vérifiez get_balance et get_pricing pour une recherche Google.
Si l’accès est autorisé et le solde suffisant, appelez google_search une seule fois pour "site:docs.python.org/3/library/venv.html create virtual environment" avec num 5 et mode "realtime".
Enregistrez un rapport daté avec les URL sources, les extraits et les crédits réellement utilisés.
Arrêtez si l’accès est révoqué ou les crédits insuffisants ; respectez Retry-After. Ne créez pas d’essai, ne demandez pas de nouvelle autorisation et ne répétez pas une requête dont le résultat est inconnu.

Stockage et renouvellement des identifiants

Codex conserve les jetons OAuth dans son stockage d’identifiants configuré. Un autre utilisateur du système, profil ou environnement d’exécution peut nécessiter sa propre connexion approuvée.

L’hôte renouvelle les jetons d’accès OAuth valables une heure à l’aide de jetons de renouvellement rotatifs. Reconnectez-vous lorsque l’autorisation de 90 jours expire ou est révoquée. Chaque installation possède son propre stockage de jetons ; ne partagez pas les fichiers de jetons de renouvellement entre hôtes.

Révoquer l’accès ou se reconnecter

  1. Mettez les tâches planifiées en pause, puis révoquez la connexion OAuth concernée dans FlashData : Settings → Connected apps.
  2. Demandez à l’agent d’appeler get_balance une fois avec la connexion enregistrée. L’authentification doit échouer ou une reconnexion doit être demandée. N’approuvez pas de nouvelle connexion pendant cette vérification.
  3. Supprimez les identifiants OAuth locaux avec la commande ci-dessous. Pour vous reconnecter plus tard, répétez l’étape 2 avec l’approbation du propriétaire, puis lancez la vérification gratuite de la connexion.
Supprimer les identifiants OAuth enregistrés
codex mcp logout flashdata

Autres options de configuration

Ajoutez des skills à votre connexion MCP, ou choisissez l’accès par CLI ou un serveur MCP local.

Ajouter le skill MCP

Le skill flashdata-mcp explique à votre agent comment utiliser les outils connectés. Il réutilise la connexion configurée ci-dessus.

Exécutez ces commandes depuis votre projet. Choisissez la CLI native FlashData v1.2.1, ou l’installateur de skills avec Node.js 22.20+ et npm. Démarrez une nouvelle session Codex et demandez à utiliser flashdata-mcp.

Dans votre projet
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcp

Utiliser les skills CLI ou démarrer un essai

Installez la CLI FlashData v1.2.1 et exécutez les commandes depuis votre projet. Choisissez un onglet d’accès. Les exemples utilisent le profil CLI par défaut, distinct de la connexion MCP OAuth ; conservez vos options --profile et --state-dir si vous les avez personnalisées.

La configuration installe les skills CLI dans .agents/skills. Démarrez une nouvelle session Codex après l’installation et demandez à utiliser google-search.

Collez une clé disposant de la permission google_search à l’invite de saisie masquée. Pour un import sans interaction, transmettez-la depuis votre gestionnaire de secrets à auth login --api-key-stdin --non-interactive via l’entrée standard.

1. Importer et vérifier la clé
flashdata auth login
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactive
2. Vérifier le solde et le coût — sans recherche
flashdata account balance --json --non-interactive
flashdata search "site:docs.python.org/3/library/venv.html create virtual environment" --num 5 --dry-run --json --non-interactive

# Continue only if accessVerified and estimateAvailable are true,
# google_search is permitted, and availableCredits covers estimatedCredits.
3. Exécuter une fois → ./codex-first-search.json
flashdata search "site:docs.python.org/3/library/venv.html create virtual environment" --num 5 --run-id codex-first-search-001 --output codex-first-search.json --json --non-interactive

# Read the saved file: status, results[].organic, usage.credits.
# Terminal JSON reports the output path; keep the run ID for recovery.

Exécuter MCP localement avec une clé API

Nécessite Node.js 22.18+, npm et une clé API disposant de la permission google_search pour la première tâche. Cette configuration exécute @flashdata-dev/mcp 0.2.0 ; elle ne lit ni la clé enregistrée par la CLI FlashData ni les jetons MCP OAuth.

Définissez la clé dans un terminal, remplacez toute l’entrée flashdata précédente (y compris sa sous-section OAuth) par la configuration ci-dessous, puis démarrez Codex depuis ce terminal. Un agent peut utiliser une variable d’environnement déjà injectée à la place de la saisie masquée.

Après la configuration, envoyez la consigne de vérification gratuite ci-dessus dans une nouvelle session de l’agent. Lorsque les deux vérifications réussissent, envoyez la consigne de première tâche. L’accès par clé API ne nécessite pas mcp login.

1. Définir la clé sans l’afficher
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
2. Remplacer l’entrée dans ~/.codex/config.toml
[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
3. Démarrer une nouvelle session dans ce terminal
codex

Dépannage

ProblèmeSolution
Aucun outil FlashDataExécutez codex mcp list, puis /mcp dans une nouvelle session. Vérifiez le fichier de configuration et terminez la connexion.
Skill absentVérifiez .agents/skills dans ce projet. Si vous avez installé le skill MCP avec la CLI native, exécutez flashdata skills verify --agent codex --skill flashdata-mcp. Redémarrez la session.
invalid_client / callbackComparez votre configuration avec l’étape 1. Terminez l’autorisation dans un navigateur capable d’atteindre l’URL de rappel de l’hôte ayant lancé la connexion.
401Vérifiez si la connexion ou la clé a été révoquée ou a expiré. Pour OAuth, reconnectez-vous avec l’approbation du propriétaire ; pour la CLI, exécutez flashdata auth status. L’ajout de crédits ne corrige pas l’authentification.
403Vérifiez la permission de la source demandée. La connexion OAuth de recherche ne couvre pas YouTube Download ; utilisez sa configuration par clé API. Corrigez la permission avant de réessayer.
402Vérifiez get_balance ou flashdata account balance. Ajoutez des crédits dans Billing ou arrêtez la tâche ; une nouvelle connexion n’ajoute pas de crédits.
429Respectez le délai Retry-After et réduisez le nombre de requêtes simultanées. Conservez le profil et la preuve d’inscription existants ; ne créez pas d’autres essais.
Le serveur MCP local ne peut pas lire la cléDéfinissez FLASHDATA_API_KEY dans l’environnement de lancement de l’hôte, puis redémarrez-le. Une clé enregistrée par flashdata auth login n’est pas automatiquement exportée vers le serveur MCP local.
Le fichier de sortie CLI existe déjàLisez ./codex-first-search.json. Pour exporter à nouveau le résultat réussi enregistré, utilisez flashdata runs show codex-first-search-001 --result --output codex-first-search-copy.json avec le profil d’origine. Utilisez un nouvel identifiant d’exécution uniquement pour lancer volontairement une nouvelle recherche.
Échec de la tâche planifiéeExécutez la vérification gratuite de réutilisation dans cet environnement. Utilisez le même utilisateur du système, le même profil d’hôte, le même stockage d’identifiants et les mêmes autorisations d’outils.
Délai dépassé ou résultat inconnuConservez l’identifiant de requête ou de tâche et consultez History avant de soumettre à nouveau. Utilisez get_result pour les identifiants de continuation reçus.

Notes de validation OAuth

La connexion OAuth, l’URL de rappel, l’enregistrement des identifiants, un appel gratuit de tarification, le renouvellement et la révocation ont été vérifiés sous Windows avec Codex 0.163.0-alpha.10.2 le 2026-10-21. Ce test ne couvrait ni les requêtes payantes ni l’exécution planifiée. Les instructions de configuration ont été vérifiées dans la documentation de l’hôte le 2026-11-05.