# Codex

Añade herramientas de Google Search y YouTube a Codex para programar e investigar.

Referencia canónica: https://flashdata.dev/es/docs/integrations/codex
Revisado: 2026-11-05 por FlashData

<a id="choose"></a>

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

- [Usar skills de la CLI o iniciar una prueba](https://flashdata.dev/es/docs/integrations/codex/reference.md#cli)
- [Instalar Codex CLI](https://learn.chatgpt.com/docs/codex/cli)

<a id="setup"></a>

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

```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"
```


<a id="oauth"></a>

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

```bash
codex mcp login flashdata --scopes mcp:research
```


<a id="connection-check"></a>

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

```text
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.
```


<a id="first-task"></a>

## 3. Ejecuta tu primera tarea

Envía este mensaje al agente conectado. Las comprobaciones son gratuitas; la búsqueda consume créditos.

### Primera tarea

```text
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.
```


<a id="result"></a>

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

- [Ver el historial de solicitudes](https://flashdata.dev/app/jobs)

<a id="tools"></a>

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

- [Herramientas y esquemas MCP](https://flashdata.dev/es/docs/mcp/reference.md)
- [Configurar YouTube Download](https://flashdata.dev/es/docs/guides/youtube-download-guide/reference.md)

<a id="recurring"></a>

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


<a id="reuse-check"></a>

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

```text
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.
```


<a id="schedule"></a>

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

```text
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.
```

- [Guía de tareas recurrentes](https://flashdata.dev/es/docs/guides/recurring-tasks/reference.md)
- [Programación y recuperación con la CLI](https://flashdata.dev/es/docs/guides/cli-automation/reference.md#recurring)

<a id="credentials"></a>

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


<a id="revoke"></a>

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

```bash
codex mcp logout flashdata
```

- [Connected apps](https://flashdata.dev/app/settings/connections)

<a id="options"></a>

## 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 id="skills"></a>

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

##### En la carpeta de tu proyecto

```bash
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcp
```


#### Node.js / npm

##### En la carpeta de tu proyecto

```bash
npx skills add flashdatadev/flashdata-skills --skill flashdata-mcp --agent codex --copy
```


- [Instalar la CLI](https://flashdata.dev/es/docs/guides/flashdata-cli/reference.md#install)
- [Leer la skill MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Actualizar o eliminar skills](https://flashdata.dev/es/docs/guides/agent-skill-management/reference.md)

<a id="cli"></a>

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

#### Clave API existente

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

```bash
flashdata auth login
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. Saldo y coste · sin buscar

```bash
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

```bash
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.
```


#### Acceso guardado

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.

##### 1. Verifica el acceso guardado

```bash
flashdata setup --agent codex --skip-auth --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. Saldo y coste · sin buscar

```bash
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

```bash
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.
```


#### Solicitar una prueba

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.

##### 1. Configura y verifica la prueba

```bash
flashdata setup --agent codex --non-interactive
flashdata auth status --json --non-interactive
```

##### 2. Saldo y coste · sin buscar

```bash
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

```bash
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.
```


- [Descargar la CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Instalar la CLI](https://flashdata.dev/es/docs/guides/flashdata-cli/reference.md#install)
- [Recuperar un resultado guardado](https://flashdata.dev/es/docs/guides/cli-automation/reference.md#recover)
- [Vincular la prueba antes de programar tareas](https://flashdata.dev/es/docs/guides/agent-onboarding/reference.md)

<a id="local"></a>

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

##### 1. Define la clave sin mostrarla

```bash
# 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

```toml
[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/mcp@0.2.0", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
```

##### 3. Inicia Codex en esta terminal

```bash
codex
```


#### PowerShell 7 (Windows)

##### 1. Define la clave sin mostrarla

```powershell
# 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
```

##### 2. Sustituye la entrada en ~/.codex/config.toml

```toml
[mcp_servers.flashdata]
command = "npx.cmd"
args = ["--yes", "--package=@flashdata-dev/mcp@0.2.0", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
```

##### 3. Inicia Codex en esta terminal

```powershell
codex
```


- [Comprobar la conexión gratis](https://flashdata.dev/es/docs/integrations/codex/reference.md#connection-check)
- [Crear una clave API](https://flashdata.dev/app/api-keys)
- [Documentación del MCP local](https://github.com/flashdatadev/flashdata-mcp)

<a id="help"></a>

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

- [Guía de recuperación](https://flashdata.dev/es/docs/guides/agent-recovery/reference.md)
- [Documentación de MCP en Codex](https://learn.chatgpt.com/docs/extend/mcp)

<a id="compatibility"></a>

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

- [Skills oficiales](https://github.com/flashdatadev/flashdata-skills)
- [Paquete y código fuente de MCP](https://github.com/flashdatadev/flashdata-mcp)
