Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Integrações

Codex

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

Nesta página

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.

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
[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. 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
codex mcp login flashdata --scopes mcp:research

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

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

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.

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.

TarefaMCP ferramenta
Encontre fontes para uma resposta ou implementaçãogoogle_search
Encontre vídeos relevantes de YouTubeyoutube_search
Leia títulos de vídeo, canais e metadadosyoutube_metadata
Recupere uma transcrição de vídeo para um resumoyoutube_transcript
Verifique os créditos disponíveis e o custo do pedidoget_balance · get_pricing

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.

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

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

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.

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
codex mcp logout flashdata

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.

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.

Em seu projeto
flashdata skills install --agent codex --skill flashdata-mcp
flashdata skills verify --agent codex --skill flashdata-mcp

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.

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

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.

1. Defina a chave sem imprimi-la
# 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
[mcp_servers.flashdata]
command = "npx"
args = ["--yes", "--package=@flashdata-dev/[email protected]", "flashdata-mcp"]
env_vars = ["FLASHDATA_API_KEY"]
3. Comece uma nova sessão neste terminal
codex

Solução de problemas

ProblemaTente isso
Sem ferramentas FlashDataExecute 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 habilidadeVerifique .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 / callbackCompare o passo 1 exatamente. Autorização completa em um navegador que pode chegar ao retorno do anfitrião iniciante.
401Verifique 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.
403Verifique 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.
402Verifique get_balance ou saldo de contas flashdata. Adicione créditos em Billing ou pare a tarefa; assinar novamente não adiciona créditos.
429Espere 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 chaveDefina 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á existeLeia ./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 falhouFaç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 desconhecidoMantenha o pedido ou trabalho ID e verifique History antes de reenviar. Use get_result para continuar IDs.

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.