AssistenteTestado por nósConferido em 28/10/2026

Conectar o Claude à Postal

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 conectar

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

Servidor acessível pela internet pública (a Anthropic conecta a partir de 160.79.104.0/21; libere no firewall/WAF se houver). Free, Pro, Max, Team e Enterprise podem adicionar conectores personalizados (Free: um). Em Team/Enterprise só Owners adicionam. Resultado de ferramenta até cerca de 150 mil caracteres e 240 s por chamada; o OAuth precisa responder em 10 s (30 s no refresh). A Anthropic guarda os metadados de descoberta em cache por cerca de 5 minutos.

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
Planos Pro e Max: em Personalizar (Customize) > Conectores, clique em + Adicionar e em "Adicionar conector personalizado". Free: um conector personalizado.
2
Dê um nome (por exemplo, Postal), informe a URL https://api.postal.so/mcp e continue.
3
Confira a autenticação detectada (OAuth) e escolha "Entrar agora" (Sign in now). Em "Cliente OAuth" deixe a opção padrão: o Claude se identifica sozinho.
4
Na tela da Postal, escolha o time e clique em Permitir; depois clique em Adicionar.
5
Team e Enterprise: um Owner adiciona o conector em Configurações da organização > Conectores > Adicionar > Personalizado > Web, com a mesma URL; cada pessoa depois abre Personalizar > Conectores e clica em Conectar.
6
Em cada conversa, ative o conector no botão + > Conectores.

URL do conector

Texto

https://api.postal.so/mcp

Acessos que a ferramenta precisa

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

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

Para perguntar "como foram os envios de hoje?" basta mcp:read. Para o Claude enviar e-mails é preciso mcp:send. mcp:full é necessário para criar templates, contatos e broadcasts e para responder inboxes. O Claude pede os três escopos anunciados pela Postal e, se uma ferramenta exigir mais do que a conexão tem, refaz a autorização (resposta 403 insufficient_scope).

Como confirmar que funcionou

A prova mais simples é pedir algo de leitura dentro do próprio Claude. 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: Inspector com interface web

npx @modelcontextprotocol/inspector

O Inspector prova que o servidor da Postal responde. Ele não testa o Claude 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 Claude.

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

Testado por nósConferido em 28/10/2026

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

Verificado por teste: o documento de metadados que a Anthropic publica para o Claude (https://claude.ai/oauth/mcp-oauth-client-metadata, com os grants authorization_code, refresh_token e jwt-bearer) é aceito, o fluxo completo (consentimento, token, refresh) funciona com o redirecionamento https://claude.ai/api/mcp/auth_callback, e o registro dinâmico também. Isso exigiu uma correção na Postal em 2026-10-28: antes, o grant jwt-bearer fazia o documento ser recusado e a conexão falharia. Não testado dentro do Claude real, e não foi possível confirmar qual dos dois caminhos (documento ou registro) o Claude escolhe: a documentação diz que ele usa o documento quando o servidor anuncia client_id_metadata_document_supported e "none" nos métodos do token endpoint, o que a Postal faz.

Perguntas frequentes

Preciso de uma chave de API para conectar o Claude?

Não. O Claude 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 Claude faz na minha conta?

Documentação oficial do Claude 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 Claude?

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