Linha de comandoCompatível pela especificaçãoConferido em 28/10/2026

Conectar o Codex à Postal

Configure a Postal no Codex (CLI, extensão de IDE e app) com algumas linhas no config.toml.

Como entra: Conta ou chave
Transporte: HTTP
Acessos recomendados: Leitura e envio

Antes de começar

Confira estes pontos antes de abrir a configuração do Codex. Eles evitam a maior parte das falhas de conexão.

Time com o recurso de plano "Servidor MCP" (mcp_access); sem ele o servidor responde 403 plan_limit_reached.
Para enviar e-mails é preciso ter ao menos um domínio verificado no time.
Se for usar chave de API: crie a chave no painel, em Chaves de API. Ela começa com ps_; uma chave só de envio basta para quem só vai enviar.
Cada conexão age em um único time. Para usar outro time, conecte de novo escolhendo o outro.
As conexões ficam em Configurações › Conexões de IA no painel, onde podem ser revogadas a qualquer momento.

O que o Codex exige

Codex com suporte a servidores MCP de Streamable HTTP e OAuth (a documentação não informa versão mínima nem plano). Timeouts padrão: 10 s para iniciar e 60 s por chamada de ferramenta (tool_timeout_sec). O app web do ChatGPT não lê o config.toml: lá use o conector do ChatGPT.

Conectar

Siga os passos na ordem. O endereço do servidor é sempre https://api.postal.so/mcp. Caminho recomendado: entrar com a sua conta (OAuth). A chave de API é a alternativa.

1
Edite ~/.codex/config.toml (ou .codex/config.toml em um projeto confiável) e adicione o bloco abaixo.
2
Rode: codex mcp login postal. O Codex abre o navegador para o login da Postal (escolha o time e clique em Permitir).
3
Confira com: codex mcp list. A CLI, a extensão de IDE e o app usam a mesma configuração.
4
Para chave de API, use o segundo bloco e exporte POSTAL_API_KEY no ambiente.
5
Para pedir menos escopos, acrescente scopes = ["mcp:read", "mcp:send"] ao bloco do servidor.

OAuth (recomendado)

~/.codex/config.toml

[mcp_servers.postal]
url = "https://api.postal.so/mcp"

Chave de API

~/.codex/config.toml

[mcp_servers.postal]
url = "https://api.postal.so/mcp"
bearer_token_env_var = "POSTAL_API_KEY"

Terminal

codex mcp login postal

Acessos que a ferramenta precisa

A Postal separa o acesso em três níveis, explicados na tabela de escopos. Para o Codex:

Necessário

Ler seus dadosmcp:read

Ver e-mails, domínios, contatos, segmentos, tópicos, templates, broadcasts, automações, formulários, conversas das inboxes, métricas e uso.

Recomendado

Enviar e-mails e eventosmcp:send

Enviar e agendar e-mails de domínios verificados e registrar eventos para automações.

Só se quiser

Gerenciar tudomcp:full

Tudo dos anteriores, mais criar, alterar e apagar contatos e templates, criar e enviar broadcasts (send_broadcast exige confirm: true), cancelar e-mails agendados e trabalhar nas inboxes (organizar, responder, criar rascunho).

Sem a chave scopes, o Codex usa os escopos que o servidor anuncia (os três). Para uso de desenvolvimento, mcp:read + mcp:send cobrem consultar entregas e enviar e-mails de teste; mcp:full só para o agente alterar templates, contatos e broadcasts.

Como confirmar que funcionou

A prova mais simples é pedir algo de leitura dentro do próprio Codex. A conexão também aparece em Configurações › Conexões de IA, no painel da Postal, com o app, o time e a última utilização.

Exemplo ilustrativo

Liste os meus domínios na Postal.

Encontrei 2 domínios no time Aurora Cosméticos: exemplo.com.br (verificado) e loja.exemplo.com.br (em verificação).

Para quem quer a prova técnica

Terminal: lista de ferramentas com uma chave de API

npx @modelcontextprotocol/inspector --cli https://api.postal.so/mcp \
  --transport http \
  --header "Authorization: Bearer ps_..." \
  --method tools/list

34Ferramentas esperadas com chave de acesso total

O Inspector prova que o servidor da Postal responde. Ele não testa o Codex em si. O passo a passo completo está em Valide a conexão.

Se der problema

Percorra a lista na ordem. Depois, leia o que sabemos (e o que não sabemos) sobre o Codex.

Confira

O endereço é exatamente https://api.postal.so/mcp, com /mcp no fim.
O tipo de conexão é HTTP (Streamable HTTP). A Postal não oferece SSE: se a ferramenta der a escolha, use HTTP.
O time tem o recurso "Servidor MCP" no plano. Sem ele, o servidor responde 403 plan_limit_reached.
Para enviar e-mails, o time tem ao menos um domínio verificado.
Cada conexão age em um único time. Para usar outro, conecte de novo e escolha o outro.
Resposta 429 (rate_limit_exceeded): o limite de requisições por segundo do plano foi atingido. Espere um pouco e tente de novo.
Se a ferramenta reclamar do tamanho da resposta, peça listas menores (no máximo 100 itens por chamada; o padrão é 20).
Para recomeçar do zero, revogue a conexão em Configurações › Conexões de IA e conecte de novo.

O que foi testado e o que não foi

Compatível pela especificaçãoConferido em 28/10/2026

Seguimos a especificação e a documentação do app, mas ainda não testamos com o app de verdade. Abaixo, a nota completa do que foi e do que não foi verificado.

Detalhe do teste

Verificado por teste: o redirecionamento padrão do Codex (http://127.0.0.1:PORTA/callback) é aceito no registro dinâmico e no fluxo completo; a chave de API em Bearer é o mesmo caminho verificado com o SDK. O Codex também pode usar Client ID Metadata Document quando o servidor o anuncia, mas não encontramos a URL nem o conteúdo do documento dele, então esse caminho não foi testado; o registro dinâmico (que o Codex usa como alternativa) foi. Não testado com o Codex real.

Perguntas frequentes

Preciso de uma chave de API para conectar o Codex?

Não é obrigatório. O Codex pode entrar com a sua conta da Postal (OAuth) ou com uma chave de API. Caminho recomendado: entrar com a sua conta (OAuth). A chave de API é a alternativa. A chave só de envio (sending_access) expõe apenas send_email e track_event.

Posso limitar o que o Codex faz na minha conta?

Documentação oficial do Codex Servidor MCP da Postal Autenticação e chaves Todas as ferramentas

Continue por aqui

Outras ferramentas

Cada ferramenta tem o seu passo a passo. Veja também a lista completa em IA.

Pronto para usar a Postal no Codex?

Crie a sua conta e conecte. Se precisar de ajuda, fale com a gente pelo formulário de contato.

Criar conta Ver todas as ferramentas