Conecte sua caixa de entrada ao OpenAI Codex
com um único comando

Em 27 de outubro de 2026, o app de desktop nem sempre faz login num servidor adicionado à mão (nas versões atuais, em Plugins, Add, Add MCP server). O formulário não tem etapa de login, e em algumas versões nenhum botão Authenticate aparece depois de reiniciar, ou as ferramentas nunca chegam a um chat. A OpenAI tem relatos abertos sobre isso, então pode estar corrigido quando você ler isto. Até lá, faça login pelo terminal: instale o CLI com npm i -g @openai/codex se ainda não tiver, rode codex mcp login mcpemails (use o nome que você digitou no campo Name), aprove o acesso no navegador, depois reinicie o app e abra um chat novo. O app e o CLI compartilham uma configuração, então o app usa esse login.

O Codex pede os escopos do nosso desafio 401, que é read:email, então em alguns registros a tela de consentimento abre em Somente leitura. Isso basta para triagem. Se você quer que o Codex rascunhe ou envie, escolha Padrão ou Acesso total antes de clicar em Permitir. Para ampliar depois, rode codex mcp login mcpemails de novo e escolha a opção mais ampla, ou informe os escopos com --scopes, por exemplo --scopes read:email,search:email,manage:drafts.

Na mesma máquina, os três leem o mesmo ~/.codex/config.toml, então adicionar o servidor em um faz ele aparecer nos outros. Um projeto também pode ter seu próprio .codex/config.toml, que o Codex só lê em projetos confiáveis. O ChatGPT na web não lê esse arquivo; para ele, use a configuração do ChatGPT.

Num servidor que você acessa por SSH, rode codex mcp login mcpemails --no-browser: o Codex mostra o link de login, você abre em qualquer máquina e cola de volta o endereço em que o navegador parar. Em CI, crie uma chave com escopo no painel, em Chaves de API, exporte-a e defina bearer_token_env_var na entrada do servidor com o nome dessa variável (ou passe --bearer-token-env-var para codex mcp add). O Codex então envia a chave no header Authorization, e ela nunca fica no arquivo de configuração.

Por padrão, o Codex espera 60 segundos por uma chamada de ferramenta (tool_timeout_sec). Isso basta até para trabalho em massa: mover ou excluir numa pasta grande para no limite de tempo do próprio servidor antes disso e devolve um resultado marcado como partial, com as mensagens não processadas listadas em remaining_message_ids, para que o Codex chame de novo com esses ids. Baixar muito o timeout pode cortar uma chamada antes de esse resultado chegar.

• As solicitações têm limite de 100 por minuto, 1.000 por hora e 10.000 por dia por chave.
• O servidor funciona só com solicitação e resposta. Não há webhooks nem eventos iniciados pelo servidor, então um e-mail novo nunca acorda seu agente sozinho. Para reagir a e-mails que chegam, faça polling em intervalos programados.
• Os e-mails são buscados ao vivo no seu provedor a cada chamada e nunca armazenados. Só o token OAuth ou a senha de app criptografados ficam guardados, então um token revogado ou uma senha da caixa de correio alterada encerra o acesso na hora.