O Codex armazena as configurações de MCP no arquivo config.toml, e a CLI, a extensão para IDE e o aplicativo desktop usam o mesmo arquivo — basta configurar uma vez. O arquivo global fica em ~/.codex/config.toml; a configuração de um projeto específico pode ser colocada em .codex/config.toml, mas ela só será carregada em um projeto confiável (trusted).

Opção 1 — via CLI (recomendado)

  1. Adicione o servidor:
codex mcp add emailmassivo --url https://mcp.emailmassivo.com/mcp

  1. Verifique se ele foi gravado: codex mcp list (detalhes de um servidor específico — codex mcp get emailmassivo).

  2. Faça a autorização:

codex mcp login emailmassivo

  1. O navegador abre com a página de autorização do Email Massivo — entre na sua conta e clique em "Permitir".

  2. Execute codex e rode /mcp — o Email Massivo deve aparecer na lista de servidores ativos.

Se codex mcp login falhar ou o Codex travar na inicialização com o erro missing field command in mcp_servers.emailmassivo, a versão do Codex está desatualizada e não suporta servidores remotos diretamente. Atualize o Codex — nas versões atuais o streamable HTTP funciona sem configuração adicional. Como solução temporária, adicione no início de ~/.codex/config.toml o bloco: [features] experimental_use_rmcp_client = true

Opção 2 — edição do config.toml

Adicione um bloco ao arquivo ~/.codex/config.toml (no macOS e Linux — ~/.codex/config.toml, no Windows — %USERPROFILE%.codex\config.toml, ou seja, C:\Users<nome do usuário>.codex\config.toml). Se o arquivo ainda não existir, crie-o.

[mcp_servers.emailmassivo]
url = "https://mcp.emailmassivo.com/mcp"

Em seguida, execute codex mcp login emailmassivo e faça a autorização.

Opção 3 — via configurações do aplicativo desktop do ChatGPT

O aplicativo desktop separado "Codex Desktop" foi descontinuado: a mesma funcionalidade (MCP, plugins, hooks, Git, worktrees) agora está integrada ao aplicativo desktop do ChatGPT — fica nas configurações dele, nas seções "Integrações" e "Código". Abaixo está descrito exatamente esse caminho atual.

  1. Abra as configurações do aplicativo ChatGPT e, na seção "Integrações", selecione "Plugins".

  2. Na página "Plugins", mude para a aba "MCP" (o contador ao lado mostra quantos servidores já estão conectados — não confunda com as abas "Plugins", "Habilidades" e "Loja").

  3. Clique em "Adicionar" → no menu suspenso selecione "Adicionar servidor MCP" (não "Criar plugin" nem "Adicionar marketplace").


Configurações do ChatGPT: "Plugins" (1) → "Adicionar" (2) → "Adicionar servidor MCP" (3); no formulário — "Nome" (4), "Tipo" (5), "URL" (6), "Salvar" (7)

  1. No campo "Nome", digite Email Massivo.

  2. No campo "Tipo", selecione "Streaming HTTP" (não STDIO).

  3. No campo "URL", cole:

https://mcp.emailmassivo.com/mcp

  1. Deixe os campos "Variável de ambiente do token Bearer" e "Cabeçalhos" vazios — o Email Massivo autoriza via OAuth, não por token estático.

  2. Clique em "Salvar".

  3. Na lista da aba MCP aparecerá a linha "email_massivo" com o botão "Autenticar" à direita (ao lado — o ícone de configurações e o interruptor de ativação do servidor).


Linha email_massivo na lista MCP: botão "Autenticar", ícone de configurações e interruptor de ativação do servidor

  1. Clique em "Autenticar" — o navegador abre com a página de autorização do Email Massivo. Entre na sua conta e clique em "Permitir".


Página de autorização do Email Massivo — botão "Permitir