Saltar al contenido
ES
Obtener clave API
Explorar documentación

Integraciones

Codex

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.

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

Iniciar sesión
codex mcp login flashdata --scopes mcp:research

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

Pega este mensaje en tu agente
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.

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

TareaHerramienta MCP
Buscar fuentes para responder o implementar una funcióngoogle_search
Buscar vídeos relevantes en YouTubeyoutube_search
Leer títulos de vídeo, canales y metadatosyoutube_metadata
Obtener la transcripción de un vídeo para resumirloyoutube_transcript
Consultar el saldo y el coste de una solicitudget_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.

Comprobar la reutilización
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.

Instrucciones de la tarea
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

  1. Pausa las tareas programadas y revoca la conexión OAuth correspondiente en FlashData: Settings → Connected apps.
  2. 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.
  3. 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.
Eliminar credenciales OAuth locales
codex mcp logout flashdata

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

En la carpeta de tu proyecto
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcp

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

1. Importa y verifica la clave
flashdata auth login
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactive
2. Saldo y coste · sin buscar
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

# Continúa solo si accessVerified y estimateAvailable son true,
# google_search está permitido y availableCredits cubre estimatedCredits.
3. Ejecuta una vez → ./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

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

1. Define la clave sin mostrarla
# 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. Sustituye la entrada en ~/.codex/config.toml
[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
3. Inicia Codex en esta terminal
codex

Solución de problemas

ProblemaQué hacer
Lista vacíaSi 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 skillComprueba .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 / callbackCompara 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.
401Comprueba 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.
403Comprueba 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.
402Consulta 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.
429Espera 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 claveDefine 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 existeLee ./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ódicaEjecuta 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 inciertoSi 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.