Novo: campanhas, automações e e-mails do produto na mesma conta. Conheça a Postal
Entrar Criar conta
Criador de appsCompatível pela especificaçãoConferido em 28/10/2026

Conectar o Replit à Postal

Adicione a Postal como servidor MCP no Replit Agent e use seus domínios, templates e envios no projeto.

Ver como conectar
Como entra
Conta ou chave
Transporte
Não informado
Acessos recomendados
Leitura e envio
1

Antes de começar

Confira estes pontos antes de abrir a configuração do Replit. 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 Replit exige

URL HTTPS pública. A documentação não informa plano, versão nem limites. Use o cabeçalho Authorization (a Postal não lê X-API-Key).

2

Conectar

Siga os passos na ordem. O endereço do servidor é sempre https://api.postal.so/mcp. Caminho recomendado: chave de API (a conta, por OAuth, também funciona). Onde aparece ps_..., use a sua chave de API: o valor mostrado é só um exemplo.

  1. 1

    No Replit, abra o painel MCP Servers e clique em "+ Add MCP server".

  2. 2

    Informe um nome (por exemplo, Postal) e a URL https://api.postal.so/mcp.

  3. 3

    Em "Advanced settings" adicione o cabeçalho Authorization com o valor Bearer ps_... (uma chave de API da Postal). Se preferir OAuth, deixe sem cabeçalho.

  4. 4

    Clique em "Test & save": o Replit conecta e, se o servidor exigir OAuth, guia o login da Postal (escolha o time e clique em Permitir).

  5. 5

    Atalho: o link de instalação abaixo preenche nome e URL.

URL do servidor

Texto
https://api.postal.so/mcp

Cabeçalho

Texto
Authorization: Bearer ps_...

Link de instalação

Texto
https://replit.com/integrations?mcp=eyJkaXNwbGF5TmFtZSI6IlBvc3RhbCIsImJhc2VVcmwiOiJodHRwczovL2FwaS5wb3N0YWwuc28vbWNwIn0=
3

Acessos que a ferramenta precisa

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

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.

O Replit Agent mostra uma confirmação antes de ferramentas que pedem aprovação. mcp:read + mcp:send cobrem consulta e e-mail de teste; com uma chave sending_access o servidor expõe só send_email e track_event.

4

Como confirmar que funcionou

A prova mais simples é pedir algo de leitura dentro do próprio Replit. 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 Replit em si. O passo a passo completo está em Valide a conexão.

5

Se der problema

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

Confira

  • O endereço é exatamente https://api.postal.so/mcp, com /mcp no fim.
  • A documentação do Replit não informa o transporte. Se ele só falar o transporte antigo (SSE), a Postal não conecta, e não foi possível confirmar isso.
  • 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

A documentação do Replit exige uma URL HTTPS e descreve cabeçalhos personalizados e registro dinâmico de cliente OAuth, mas não diz o transporte (os exemplos do catálogo terminam em /sse), nem as URLs de retorno, planos ou limites. Se o Replit só falar o transporte legado SSE, a Postal (que só oferece Streamable HTTP) não conectará: isso não foi possível confirmar. O cabeçalho Authorization: Bearer com chave de API foi verificado com o SDK. Não testado com o Replit real. Todo o tráfego MCP do Replit passa por um verificador de segurança dele, que pode bloquear ferramentas.

Perguntas frequentes

Preciso de uma chave de API para conectar o Replit?

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

Posso limitar o que o Replit faz na minha conta?

O Replit Agent mostra uma confirmação antes de ferramentas que pedem aprovação. mcp:read + mcp:send cobrem consulta e e-mail de teste; com uma chave sending_access o servidor expõe só send_email e track_event. Você pode revogar a conexão a qualquer momento em Configurações › Conexões de IA.

Documentação oficial do ReplitServidor MCP da PostalAutenticação e chavesTodas as ferramentas

Continue por aqui

Outras ferramentas

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

ChatGPT

Adicione a Postal como servidor MCP personalizado no ChatGPT e converse com seus dados de e-mail.

Ver como conectar

Windsurf

Conecte a Postal ao Cascade do Windsurf (agora na documentação do Devin Desktop) com um bloco no mcp_config.json.

Ver como conectar

Cursor

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 conectar

Pronto para usar a Postal no Replit?

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

Criar contaVer todas as ferramentas