Conectar o ChatGPT à Postal
Adicione a Postal como servidor MCP personalizado no ChatGPT e converse com seus dados de e-mail.
- Como entra
- Conta (OAuth)
- Transporte
- HTTP
- Acessos recomendados
- Leitura e envio
Antes de começar
Confira estes pontos antes de abrir a configuração do ChatGPT. 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 403plan_limit_reached. - Para enviar e-mails é preciso ter ao menos um domínio verificado no time.
- 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 ChatGPT exige
A OpenAI limita servidores MCP personalizados por plano e papel: segundo a Central de Ajuda (consultada por resumo de busca; a página recusou acesso automático), o suporte completo é de Business e Enterprise/Edu (em Business, só administradores e owners criam), e o Pro conecta servidores com permissões de leitura/busca. Confira no seu workspace, pois a interface mudou para "Plugins" e não exige mais o modo desenvolvedor. Endpoint HTTPS público com Streamable HTTP em /mcp. Políticas do workspace se aplicam.
Conectar
Siga os passos na ordem. O endereço do servidor é sempre https://api.postal.so/mcp. Esta ferramenta entra com a sua conta (OAuth).
- 1
Abra a página de Plugins do ChatGPT (
https://chatgpt.com/plugins), clique no botão + e escolha "Add custom MCP server". - 2
Dê um nome e uma descrição. Em Connection (servidor público), informe
https://api.postal.so/mcp, com o caminho/mcp. - 3
Configure a autenticação como OAuth, leia o aviso de risco e marque "I understand and want to continue".
- 4
Clique em "Create as a plugin" e conclua o login da Postal (escolha o time e clique em Permitir). Revise as ferramentas descobertas (34 com
mcp:full). - 5
Use em uma conversa. O ChatGPT pede confirmação manual antes de ações de escrita (enviar e-mail, criar templates...); mantenha a aprovação ligada.
URL do servidor
https://api.postal.so/mcpAcessos que a ferramenta precisa
A Postal separa o acesso em três níveis, explicados na tabela de escopos. Para o ChatGPT:
mcp:readVer e-mails, domínios, contatos, segmentos, tópicos, templates, broadcasts, automações, formulários, conversas das inboxes, métricas e uso.
mcp:sendEnviar e agendar e-mails de domínios verificados e registrar eventos para automações.
mcp:fullTudo 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).
O ChatGPT pede os escopos anunciados pela Postal (os três) e os concede por inteiro na tela de consentimento. mcp:read permite perguntar sobre entregas, mcp:send enviar e-mails e mcp:full criar e enviar broadcasts e mexer em contatos e templates. Como o ChatGPT confirma cada ação de escrita, mantenha a aprovação ligada.
Como confirmar que funcionou
A prova mais simples é pedir algo de leitura dentro do próprio ChatGPT. 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
Para quem quer a prova técnica
npx @modelcontextprotocol/inspectorO Inspector prova que o servidor da Postal responde. Ele não testa o ChatGPT 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 ChatGPT.
Confira
- O endereço é exatamente
https://api.postal.so/mcp, com/mcpno 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
Rodamos testes automatizados da Postal com os documentos e os endereços de retorno reais que o app publica, e com o cliente oficial do SDK do MCP. Não é um teste dentro do aplicativo de verdade. Abaixo, a nota completa do que foi e do que não foi verificado.
Detalhe do teste
Era uma lacuna e foi corrigida em 2026-10-28: o documento que o ChatGPT publica (https://chatgpt.com/oauth/client.json) declara token_endpoint_auth_method private_key_jwt (e lista none e private_key_jwt), e a Postal recusava qualquer valor diferente de none, então a autorização falhava com "cliente inválido". Agora o documento é aceito quando também lista none (a Postal sempre trata esse cliente como público com PKCE, que é o que a documentação da OpenAI diz que o ChatGPT escolhe na interseção dos métodos). Verificado por teste com o documento real, o redirecionamento https://chatgpt.com/connector_platform_oauth_redirect, resource nos pedidos de autorização e token, refresh e registro dinâmico (incluindo https://chatgpt.com/connector/oauth/{id}). Não testado dentro do ChatGPT real. O ChatGPT apresenta um certificado mTLS da OpenAI; a Postal não o exige (é opcional) e não o valida.
Perguntas frequentes
Preciso de uma chave de API para conectar o ChatGPT?
Não. O ChatGPT entra com a sua conta da Postal (OAuth), escolhendo o time na tela de permissão. Nesta página não documentamos um caminho com chave de API para ele.
Posso limitar o que o ChatGPT faz na minha conta?
O ChatGPT pede os escopos anunciados pela Postal (os três) e os concede por inteiro na tela de consentimento. mcp:read permite perguntar sobre entregas, mcp:send enviar e-mails e mcp:full criar e enviar broadcasts e mexer em contatos e templates. Como o ChatGPT confirma cada ação de escrita, mantenha a aprovação ligada. Você pode revogar a conexão a qualquer momento em Configurações › Conexões de IA.
Continue por aqui
Outras ferramentas
Cada ferramenta tem o seu passo a passo. Veja também a lista completa em IA.
Windsurf
Conecte a Postal ao Cascade do Windsurf (agora na documentação do Devin Desktop) com um bloco no mcp_config.json.
Ver como conectarCursor
Conecte o editor Cursor à Postal para consultar domínios, entregas e templates e enviar e-mails de teste sem sair do código.
Ver como conectarClaude
Adicione a Postal como conector personalizado no Claude (web, desktop e celular) e peça para ele consultar e enviar e-mails em linguagem natural.
Ver como conectarPronto para usar a Postal no ChatGPT?
Crie a sua conta e conecte. Se precisar de ajuda, fale com a gente pelo formulário de contato.