Criador de appsCompatível pela especificaçãoConferido em 28/10/2026

Conectar o Bolt à Postal

Adicione a Postal como conector personalizado do Bolt para consultar e enviar e-mails enquanto você constrói o projeto.

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

Escolha o transporte HTTP, não SSE. Muitos conectores podem deixar o Bolt mais lento e gastar mais tokens (aviso da própria documentação). A documentação não informa plano nem versão.

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. Onde aparece ps_..., use a sua chave de API: o valor mostrado é só um exemplo.

1
No chat do Bolt, clique no ícone + e depois em Conectores (Connectors) e Gerenciar conectores (Manage connectors).
2
Na página Connectors (MCP), clique em "Custom MCP server".
3
Informe um nome, a URL https://api.postal.so/mcp, o tipo de transporte HTTP e a autenticação MCP OAuth.
4
Clique em Connect, conclua o login da Postal (escolha o time e clique em Permitir) e espere o status "Connected". Opcional: ative "Auto-enable for all projects".
5
Alternativa sem OAuth: autenticação API key, colando uma chave de API da Postal (ps_...).

URL do servidor

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 Bolt:

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.

Para o Bolt consultar domínios e templates (mcp:read) e enviar um e-mail de teste (mcp:send). Todas as ferramentas do conector ficam ativas por padrão no Bolt e valem para todos os projetos; evite mcp:full e, se possível, use uma chave sending_access.

Como confirmar que funcionou

A prova mais simples é pedir algo de leitura dentro do próprio Bolt. 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 Bolt 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 Bolt.

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

A documentação do Bolt oferece os tipos de transporte "HTTP" (padrão) e "SSE" e as autenticações API key, MCP OAuth e None, mas não cita URLs de retorno do OAuth, planos nem limites. A Postal só oferece Streamable HTTP, que é o que o Bolt chama de HTTP; a opção SSE não funciona com a Postal. O caminho de chave de API foi verificado com o SDK; o OAuth é o fluxo padrão com registro dinâmico, não testado com o Bolt real.

Perguntas frequentes

Preciso de uma chave de API para conectar o Bolt?

Não é obrigatório. O Bolt 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 Bolt faz na minha conta?

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

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