Explorar documentación
Integraciones
Añade herramientas de Google Search y YouTube a Codex para programar e investigar.
En esta página
Antes de empezar
Comprueba que Codex CLI esté instalado y funcione. Esta conexión MCP remota usa OAuth para Google Search, YouTube Search, Metadata y Transcripts. Puedes crear una cuenta de FlashData al iniciar sesión.
1. Añade el servidor MCP
Añade esta entrada a ~/.codex/config.toml, o al archivo config.toml de CODEX_HOME si lo has personalizado. Mantén el ID de cliente y la URL de retorno exactamente como aparecen.
[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. Inicia sesión
Ejecuta el comando de inicio de sesión. En el navegador, inicia sesión o crea y verifica una cuenta, y autoriza el acceso. Espera a que la terminal confirme la conexión. Las consultas usan los créditos de esa cuenta.
codex mcp login flashdata --scopes mcp:researchComprueba la conexión gratis
Abre una nueva sesión de Codex y comprueba que flashdata aparece en /mcp. Envía este mensaje: ambas llamadas deben completarse sin errores. Un saldo de cero también confirma que la conexión funciona.
Usa la conexión MCP flashdata.
Llama a get_balance con {} y a get_pricing con {"source":"google_search","request_count":1}.
Indica los créditos disponibles y el precio estimado. No ejecutes ninguna búsqueda.3. Ejecuta tu primera tarea
Envía este mensaje al agente conectado. Las comprobaciones son gratuitas; la búsqueda consume créditos.
Usa el servidor MCP flashdata. Consulta mi saldo y el precio de una búsqueda de Google.
Si hay créditos suficientes, llama a google_search una sola vez con query "site:docs.python.org/3/library/venv.html create virtual environment", num 5 y mode "realtime".
Explica cómo crear un entorno virtual de Python a partir de las fuentes obtenidas.
Cita las fuentes e indica los créditos realmente utilizados. Detente al terminar esta tarea.Comprueba el resultado
Comprueba que la llamada a google_search termina con status: done, devuelve enlaces en results[].organic y permite responder a partir de esas fuentes. El consumo se indica en usage.credits; no es el número de resultados. Si no hay resultados, el agente debe indicarlo.
Tareas que puedes pedir
Esta conexión OAuth da acceso a las herramientas de investigación. Para YouTube Download, usa la API o la CLI con una clave API del titular y un destino de almacenamiento.
| Tarea | Herramienta MCP |
|---|---|
| Buscar fuentes para responder o implementar una función | google_search |
| Buscar vídeos relevantes en YouTube | youtube_search |
| Leer títulos de vídeo, canales y metadatos | youtube_metadata |
| Obtener la transcripción de un vídeo para resumirlo | youtube_transcript |
| Consultar el saldo y el coste de una solicitud | get_balance · get_pricing |
Reutiliza el acceso en tareas recurrentes
Usa el mismo perfil de Codex, usuario del sistema y almacén de credenciales. Programa la tarea en la aplicación de tu agente o en tu programador habitual. FlashData proporciona las herramientas de datos.
Comprueba el acceso guardado
Ejecuta esta comprobación gratuita en una nueva sesión, dentro del entorno donde se ejecutará la tarea programada. Ambas llamadas deben completarse sin errores y sin volver a iniciar sesión en el navegador.
Reutiliza la conexión MCP flashdata existente.
Llama a get_balance con {} y a get_pricing con {"source":"google_search","request_count":1}.
Indica si ambas llamadas se completaron sin errores. No busques ni crees un nuevo acceso.Programar la tarea recurrente
En el programador de tu agente, elige la hora y la zona horaria; por ejemplo, cada día a las 09:00 en Asia/Shanghai. Usa el texto siguiente como instrucciones de la tarea. Ejecútala una vez en ese entorno y revisa el informe guardado antes de activar la repetición.
Reutiliza la conexión MCP flashdata existente. Consulta get_balance y get_pricing para una búsqueda de Google.
Si tienes permiso y créditos suficientes, ejecuta google_search una sola vez para "site:docs.python.org/3/library/venv.html create virtual environment" con num 5 y mode "realtime".
Guarda un informe con fecha, URL de las fuentes, extractos y créditos realmente utilizados.
Detente si el acceso está revocado o faltan créditos; respeta Retry-After. No crees una prueba ni solicites una nueva autorización. No repitas una solicitud cuyo resultado se desconoce.Almacenamiento y renovación de credenciales
Codex guarda los tokens OAuth en su almacén de credenciales configurado. Otro usuario del sistema, perfil o entorno de ejecución puede necesitar una conexión autorizada propia.
El cliente renueva los tokens de acceso OAuth, válidos durante una hora, mediante tokens de renovación rotatorios. Vuelve a conectar cuando la autorización de 90 días caduque o se revoque. Cada instalación guarda sus propios tokens; no compartas archivos de tokens de renovación entre clientes.
Revocar o volver a conectar
- Pausa las tareas programadas y revoca la conexión OAuth correspondiente en FlashData: Settings → Connected apps.
- Pide al agente que llame a get_balance una sola vez con la conexión guardada. La autenticación debe fallar o pedir que vuelvas a conectar. No autorices un nuevo inicio de sesión durante esta comprobación.
- Elimina las credenciales OAuth locales con el comando siguiente. Para volver a conectar más adelante, repite el paso 2 con la aprobación del titular y ejecuta la comprobación gratuita.
codex mcp logout flashdataMás opciones de configuración
Añade skills a tu conexión MCP, o elige el acceso por CLI o un servidor MCP local.
Añadir la skill MCP
La skill flashdata-mcp enseña a tu agente a usar las herramientas conectadas. Reutiliza la conexión anterior.
Ejecuta los comandos desde tu proyecto. Elige la CLI nativa de FlashData v1.2.1 o el instalador de skills con Node.js 22.20+ y npm. Después, abre una nueva sesión de Codex y pide que use flashdata-mcp.
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcpnpx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent codex --copyUsar skills de la CLI o iniciar una prueba
Instala la CLI de FlashData v1.2.1 y ejecuta los comandos desde tu proyecto. Elige una pestaña de acceso. Los ejemplos usan el perfil predeterminado de la CLI, separado de OAuth para MCP. Si ya usas --profile y --state-dir personalizados, conserva esos valores.
El comando setup instala las skills de la CLI en .agents/skills. Después de la instalación, abre una nueva sesión de Codex y pide que use google-search.
Pega una clave con permiso google_search cuando el comando la solicite; la entrada no se muestra en pantalla. Para importarla sin interacción, pásala desde tu gestor de secretos a la entrada estándar de flashdata auth login --api-key-stdin --non-interactive.
flashdata auth login
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactiveflashdata 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
# Continúa solo si accessVerified y estimateAvailable son true,
# google_search está permitido y availableCredits cubre estimatedCredits.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
# Lee el archivo guardado: status, results[].organic, usage.credits.
# El JSON de la terminal indica la ruta de salida; conserva el ID de ejecución para recuperar el resultado.Reutiliza tu clave o prueba existente. Si FLASHDATA_API_KEY está definida, tiene prioridad sobre la clave guardada. Comprueba la cuenta que muestra flashdata auth status.
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactiveflashdata 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
# Continúa solo si accessVerified y estimateAvailable son true,
# google_search está permitido y availableCredits cubre estimatedCredits.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
# Lee el archivo guardado: status, results[].organic, usage.credits.
# El JSON de la terminal indica la ruta de salida; conserva el ID de ejecución para recuperar el resultado.Reutiliza una prueba existente o regístrala una sola vez si cumples los requisitos. Si ha caducado, se ha agotado o está revocada, recupérala o vincúlala a tu cuenta. Antes de programar tareas con la CLI, vincula la prueba y confirma recurringAllowed: true en flashdata auth status.
flashdata setup --agent codex --non-interactive
flashdata auth status --json --non-interactiveflashdata 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
# Continúa solo si accessVerified y estimateAvailable son true,
# google_search está permitido y availableCredits cubre estimatedCredits.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
# Lee el archivo guardado: status, results[].organic, usage.credits.
# El JSON de la terminal indica la ruta de salida; conserva el ID de ejecución para recuperar el resultado.Usar MCP local con una clave API
Necesitas Node.js 22.18+, npm y una clave API con permiso google_search para la primera tarea. Esta opción ejecuta @flashdata-dev/mcp 0.2.0. No lee la clave guardada por la CLI de FlashData ni los tokens OAuth de MCP.
Define la clave en una terminal. Sustituye toda la entrada flashdata anterior, incluida su sección OAuth, por la configuración siguiente. Después, inicia Codex desde esa terminal. El agente también puede usar una variable de entorno ya inyectada, sin introducir la clave manualmente.
Después de configurar el servidor, ejecuta el mensaje de comprobación gratuita en una nueva sesión del agente. Cuando ambas llamadas funcionen, usa el mensaje de la primera tarea. El acceso con clave API no requiere mcp login.
# 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[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]codex# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey[mcp_servers.flashdata]
command = "npx.cmd"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]codexSolución de problemas
| Problema | Qué hacer |
|---|---|
| Lista vacía | Si no aparecen las herramientas de FlashData, ejecuta codex mcp list y abre /mcp en una nueva sesión. Revisa el archivo de configuración y completa el inicio de sesión. |
| Falta la skill | Comprueba .agents/skills en este proyecto. Si instalaste la skill MCP con la CLI nativa, ejecuta flashdata skills verify --agent codex --skill flashdata-mcp. Reinicia la sesión. |
| invalid_client / callback | Compara la configuración con el paso 1. Completa la autorización en un navegador que pueda acceder a la URL de retorno del equipo que inició la conexión. |
| 401 | Comprueba si la conexión o la clave ha caducado o está revocada. Para OAuth, vuelve a iniciar sesión con la aprobación del titular. Para la CLI, ejecuta flashdata auth status. Añadir créditos no corrige la autenticación. |
| 403 | Comprueba el permiso de la fuente solicitada. OAuth de investigación no incluye YouTube Download; usa la configuración con clave API de ese producto. Corrige el permiso antes de volver a intentarlo. |
| 402 | Consulta get_balance o flashdata account balance. Añade créditos en Billing o detén la tarea. Volver a iniciar sesión no añade créditos. |
| 429 | Espera el tiempo indicado en Retry-After y reduce la concurrencia. Conserva el perfil y la prueba de registro actuales. No crees pruebas nuevas para sustituir la existente. |
| MCP no lee la clave | Define FLASHDATA_API_KEY en el entorno donde se inicia el proceso del cliente y reinícialo. Una clave guardada con flashdata auth login no se exporta automáticamente al MCP local. |
| El archivo ya existe | Lee ./codex-first-search.json. Para exportar de nuevo el resultado guardado, usa flashdata runs show codex-first-search-001 --result --output codex-first-search-copy.json con el perfil original. Usa un ID de ejecución nuevo solo si quieres hacer otra búsqueda. |
| Falla la tarea periódica | Ejecuta la comprobación gratuita de reutilización dentro de ese entorno. Usa el mismo usuario del sistema, perfil del cliente, almacén de credenciales y permisos de herramientas. |
| Resultado incierto | Si se agota el tiempo de espera o desconoces el resultado, conserva el ID de la solicitud o del trabajo y consulta History antes de volver a enviarla. Usa get_result con los identificadores de continuación recibidos. |
Verificación de OAuth
El inicio de sesión OAuth, la URL de retorno, las credenciales guardadas, una consulta gratuita de precios, la renovación y la revocación se verificaron en Windows con Codex 0.163.0-alpha.10.2 el 2026-10-21. Esa prueba no verificó consultas de pago ni ejecuciones programadas. Las instrucciones de configuración se contrastaron con la documentación del cliente el 2026-11-05.