# Codex

Dê Codex Google Search e YouTube ferramentas para codificação e pesquisa.

Referência canônica: https://flashdata.dev/pt/docs/integrations/codex
2026-11-05 por FlashData

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

## Antes de começar

Mande instalar e trabalhar o Codex CLI. Esta configuração MCP hospedada usa OAuth para Google Search, YouTube Search, Metadados e Transcritos. Você pode criar uma conta FlashData durante o login.

- [Use habilidades CLI ou comece um teste](https://flashdata.dev/pt/docs/integrations/codex/reference.md#cli)
- [Instale Codex CLI](https://learn.chatgpt.com/docs/codex/cli)

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

## 1. Adicione o servidor MCP

Mesclar esta entrada em ~/.codex/config.toml (ou config.toml sob CODEX_HOME). Mantenha o cliente registrado ID e chamada URL como mostrado.

### ~/.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. Entre na sua conta

Execute o comando de login. No navegador, entre ou crie e verifique uma conta, e então aprove o acesso. Espere o terminal confirmar o login. Consultas usam os créditos da conta.

### Entrar

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


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

### Verifique a conexão de graça

Comece uma nova sessão Codex e verifique /mcp para dados flash. Envie este alerta, ambas as chamadas devem ter sucesso. Um equilíbrio zero ainda confirma uma conexão de trabalho.

#### Colar em seu agente

```text
Use os dados da conexão MCP.
Chame get_balance com {} e get_pricing com {"source":"google_search","request_count":1}.
Relate os créditos disponíveis e o preço estimado. Não faça uma busca.
```


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

## 3. Execute sua primeira tarefa

Envie isso para seu agente conectado. Os verificações são grátis, a única busca usa créditos.

### Primeiro pedido de tarefa

```text
Use o servidor flashdata MCP. Verifique meu saldo e o preço de uma busca Google.
Se financiado, ligue para google_search uma vez com consulta "site:docs.python.org/3/library/venv.html create virtual environment", num 5 e modo "realtime".
Explique como criar um ambiente virtual Python usando as fontes devolvidas.
Cite fontes e relate créditos usados. Pare depois dessa tarefa.
```


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

### O que você deveria ver

Procure uma chamada completa da ferramenta google_search com status: done, links de fonte de results[].organic e uma resposta baseada nessas fontes. O uso vem do usage.credits, não é o número de resultados. Os resultados vazios devem ser relatados como vazios.

- [Inspecione o histórico de pedidos](https://flashdata.dev/app/jobs)

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

## O que você pode pedir

Esta conexão OAuth cobre ferramentas de pesquisa. YouTube Download usa uma chave API proprietária e armazenamento de destino através do API ou CLI.

| Tarefa | MCP ferramenta |
| --- | --- |
| Encontre fontes para uma resposta ou implementação | google_search |
| Encontre vídeos relevantes de YouTube | youtube_search |
| Leia títulos de vídeo, canais e metadados | youtube_metadata |
| Recupere uma transcrição de vídeo para um resumo | youtube_transcript |
| Verifique os créditos disponíveis e o custo do pedido | get_balance · get_pricing |

- [Ferramentas e esquemas MCP](https://flashdata.dev/pt/docs/mcp/reference.md)
- [Prepare YouTube Download](https://flashdata.dev/pt/docs/guides/youtube-download-guide/reference.md)

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

## Reutilize o acesso para tarefas recorrentes

Use o mesmo perfil Codex, usuário OS e loja de credenciais. Crie a agenda em seu host de agente ou agendador existente; FlashData fornece as ferramentas de dados.


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

### Verifique o acesso salvo

Faça esse verificação grátis em uma nova sessão no ambiente programado. Ambas as chamadas devem ter sucesso sem um novo login no navegador.

#### Reutilizar verificação

```text
Reutilize a conexão existente com o MCP.
Chame get_balance com {} e get_pricing com {"source":"google_search","request_count":1}.
Relate se ambos conseguiram. Não procurem ou criem novos acessos.
```


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

### Crie a tarefa recorrente

Na agenda do seu anfitrião, escolha um fuso horário e horário, por exemplo, diariamente em 09:00 Asia/Shanghai. Use isso como o corpo de tarefas. Examine uma vez lá e verifique o relatório antes de permitir a recorrência.

#### Corpo de Tarefas

```text
Reutilize a conexão existente com o MCP. Verifique get_balance e get_pricing para uma busca Google.
Se for permitido e financiado, execute google_search uma vez para "site:docs.python.org/3/library/venv.html create virtual environment" com 5 e modo "realtime".
Guarde um relatório datado com fonte URLs, trechos e créditos usados.
Pare com o acesso revogado ou créditos insuficientes, respeite Retry-After. Não crie um teste, peça nova autorização ou repita um pedido cujo resultado é desconhecido.
```

- [Guia de tarefas recorrente](https://flashdata.dev/pt/docs/guides/recurring-tasks/reference.md)
- [CLI agendamento e recuperação](https://flashdata.dev/pt/docs/guides/cli-automation/reference.md#recurring)

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

### Armazenamento e atualização de credenciais

Codex mantém os símbolos OAuth em sua loja de credenciais configurada. Um outro usuário OS, perfil ou ambiente de execução pode precisar de sua própria conexão aprovada.

O host atualiza fichas de acesso OAuth de uma hora usando fichas rotativas de atualização. Reconecte-se quando o subsídio de 90 expirar ou for revogado. Cada instalação possui sua loja de fichas, não compartilhe arquivos de atualização entre os anfitriões.


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

### Revogar ou reconectar

1. Pause as tarefas agendadas, então revogue a chamada conexão OAuth em FlashData Settings → Connected apps.
2. Peça ao agente para ligar para get_balance uma vez com a conexão salva. Deve falhar na autenticação ou pedir para se reconectar. Não aprove um novo login durante este verificação.
3. Remova as credenciais locais OAuth com o comando abaixo. Para se reconectar mais tarde, repita o passo 2 com aprovação do proprietário e execute a verificação de conexão livre.

#### Remova credenciais salvas de OAuth

```bash
codex mcp logout flashdata
```

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

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

## Mais opções de configuração

Adicione habilidades de fluxo de trabalho à sua conexão MCP, ou escolha acesso CLI ou um servidor MCP local.


<a id="skills"></a>

### Adicione a habilidade MCP

A habilidade flashdata-mcp ensina seu agente a usar as ferramentas conectadas. Reutiliza a conexão acima.

Fuja do seu projeto. Escolha o FlashData CLI v1.2.1, ou o instalador de habilidades com Node.js 22.20+ e npm. Comece uma nova sessão Codex e peça para usar flashdata-mcp.

#### FlashData CLI

##### Em seu projeto

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


#### Node.js / npm

##### Em seu projeto

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


- [Instalação CLI](https://flashdata.dev/pt/docs/guides/flashdata-cli/reference.md#install)
- [Leia a habilidade MCP](https://github.com/flashdatadev/flashdata-skills/tree/main/skills/flashdata-mcp)
- [Atualize ou remova habilidades](https://flashdata.dev/pt/docs/guides/agent-skill-management/reference.md)

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

### Use habilidades CLI ou comece um teste

Instale FlashData CLI v1.2.1 e corra de Seu projeto. Escolha uma guia de acesso. Exemplos usam o perfil padrão CLI, separado do MCP OAuth; mantenha seu --profile e --state-dir existentes se você usar os personalizados.

Setup instala habilidades CLI em .agents/skills. Inicie uma nova sessão Codex após a instalação e peça para usar o Google-search.

#### Chave API existente

Cola uma chave com permissão google_search no alerta oculto. Para importação sem supervisão, desvie do seu gerente secreto para auth login --api-key-stdin --non-interactive.

##### 1. Importar e verificar a chave

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

##### 2. Verifique o saldo e o custo, sem buscas

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

# Continue apenas se accessVerified e estimateAvailable forem verdade,
# google_search é permitido, e availableCredits cobre estimatedCredits.
```

##### 3. Corra uma 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

# Leia o arquivo salvo: status, results[].organic, usage.credits.
# Terminal JSON relata o caminho de saída, mantenha o ID em execução para recuperação.
```


#### Acesso salvo para CLI

Reutilize sua chave ou teste. Se FLASHDATA_API_KEY for definido, tem precedência sobre a chave salva; verifique a conta mostrada por auth status.

##### 1. Reutilize e verifique o acesso salvo

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

##### 2. Verifique o saldo e o custo, sem buscas

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

# Continue apenas se accessVerified e estimateAvailable forem verdade,
# google_search é permitido, e availableCredits cobre estimatedCredits.
```

##### 3. Corra uma 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

# Leia o arquivo salvo: status, results[].organic, usage.credits.
# Terminal JSON relata o caminho de saída, mantenha o ID em execução para recuperação.
```


#### teste elegível

Reutilize um teste ou registre-se uma vez. Se expirado, esgotado ou revogado, recupere ou reivindique. Antes das tarefas CLI recorrentes, reivindique a conta e confirme recurringAllowed: true em auth status.

##### 1. Prepare e verifique o acesso ao teste

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

##### 2. Verifique o saldo e o custo, sem buscas

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

# Continue apenas se accessVerified e estimateAvailable forem verdade,
# google_search é permitido, e availableCredits cobre estimatedCredits.
```

##### 3. Corra uma 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

# Leia o arquivo salvo: status, results[].organic, usage.credits.
# Terminal JSON relata o caminho de saída, mantenha o ID em execução para recuperação.
```


- [Baixar CLI](https://github.com/flashdatadev/flashdata-cli/releases/tag/v1.2.1)
- [Instalação CLI](https://flashdata.dev/pt/docs/guides/flashdata-cli/reference.md#install)
- [Recupere um resultado salvo](https://flashdata.dev/pt/docs/guides/cli-automation/reference.md#recover)
- [vinculação antes de tarefas CLI recorrentes](https://flashdata.dev/pt/docs/guides/agent-onboarding/reference.md)

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

### Corra MCP local com uma chave API

Requer Node.js 22.18+, npm e uma chave API com permissão google_search para a primeira tarefa. Isto roda @flashdata-dev/mcp 0.2.0; não lê as chaves salvas de FlashData CLI ou as fichas MCP OAuth.

Coloque a chave em um terminal, substitua toda a entrada de dados flash anteriores (incluindo sua subseção OAuth) com a configuração abaixo, e comece Codex a partir desse terminal. Um agente pode usar uma variável de ambiente injetado existente em vez de um prompt oculto.

Depois da configuração, execute o prompt de conexão livre em uma nova sessão de agentes. Uma vez que os dois verificações passarem, use o primeiro alerta de tarefa. API-chave de acesso não requer login MCP.

#### Bash

##### 1. Defina a chave sem imprimi-la

```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. Substitua a entrada em ~/.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. Comece uma nova sessão neste terminal

```bash
codex
```


#### PowerShell 7 (Windows)

##### 1. Defina a chave sem imprimi-la

```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. Substitua a entrada em ~/.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. Comece uma nova sessão neste terminal

```powershell
codex
```


- [Faça a verificação de conexão livre](https://flashdata.dev/pt/docs/integrations/codex/reference.md#connection-check)
- [Crie uma chave API](https://flashdata.dev/app/api-keys)
- [Documentação local do MCP](https://github.com/flashdatadev/flashdata-mcp)

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

## Solução de problemas

| Problema | Tente isso |
| --- | --- |
| Sem ferramentas FlashData | Execute a lista de códigos MCP, e depois /mcp em uma nova sessão. Verifique o arquivo de configuração e o login do finish. |
| Falta a habilidade | Verifique .agents/skills neste projeto. Para uma instalação nativa de habilidades MCP, execute habilidades de flashdata verificar o código --agent --skill flashdata-mcp. Reinicie a sessão. |
| invalid_client / callback | Compare o passo 1 exatamente. Autorização completa em um navegador que pode chegar ao retorno do anfitrião iniciante. |
| 401 | Verifique se a conexão ou chave foi revogada ou expirada. Para OAuth, repita o sinal com aprovação do proprietário; para CLI, execute flashdata auth status. Adicionar créditos não vai reparar a autenticação. |
| 403 | Verifique a permissão de origem solicitada. Pesquisa OAuth não inclui YouTube Download; use sua configuração API-chave. Conserte a permissão antes de tentar novamente. |
| 402 | Verifique get_balance ou saldo de contas flashdata. Adicione créditos em Billing ou pare a tarefa; assinar novamente não adiciona créditos. |
| 429 | Espere pelo Retry-After e reduza a concorrência. Preservar o perfil atual e a prova de registro, não criar testes de substituição. |
| MCP local não pode ler a chave | Defina FLASHDATA_API_KEY onde o processo do host começa e reiniciá-lo. Uma chave salva por flashdata auth login não é automaticamente exportada para MCP local. |
| O arquivo de saída CLI já existe | Leia ./codex-first-search.json. Para exportar o sucesso salvo novamente, use flashdata runs show codex- primeira pesquisa...001 --result --output codex-first-search-copy.json com o perfil original. Use uma nova corrida ID apenas para uma nova busca pretendida. |
| A tarefa agendada falhou | Faça a verificação de reutilização gratuita dentro daquele ambiente. Combine com o usuário OS, perfil de host, a loja de credenciais e permissões de ferramentas. |
| Tempo limite ou resultado desconhecido | Mantenha o pedido ou trabalho ID e verifique History antes de reenviar. Use get_result para continuar IDs. |

- [Guia de recuperação](https://flashdata.dev/pt/docs/guides/agent-recovery/reference.md)
- [Codex MCP documentação](https://learn.chatgpt.com/docs/extend/mcp)

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

## Notas de validação do OAuth

OAuth login, callback, credenciais salvas, uma chamada de preços grátis, atualização e revogação foram verificadas no Windows com Codex 0.163.0-alpha.10.2 no 2026-10-21. Essa corrida não validou as consultas pagas ou a execução agendada. As instruções de configuração foram verificadas com a documentação do host no 2026-11-05.

- [Habilidades oficiais](https://github.com/flashdatadev/flashdata-skills)
- [Pacote MCP e fonte](https://github.com/flashdatadev/flashdata-mcp)
