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

Conectar o v0 à Postal

Conecte a Postal ao v0 para que ele consulte seus domínios e templates e envie e-mails de teste enquanto gera o app.

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

O v0 chama o servidor a partir da nuvem dele (HTTPS público; a Postal é). A documentação não informa plano, versão nem limites. A aprovação de cada chamada depende do modo de permissão do chat (Ask, Auto ou Full).

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 campo de mensagem do v0, abra o menu + e escolha MCPs.
2
Configure um servidor próprio: informe um nome e a URL https://api.postal.so/mcp.
3
Em autenticação escolha OAuth e conclua o login da Postal (escolha o time e clique em Permitir). Alternativa: Bearer Token, colando uma chave de API da Postal (ps_...).
4
Deixe o servidor ativado. O v0 usa as ferramentas durante a geração; o código gerado não chama as ferramentas MCP diretamente: para o app em produção use a API da Postal com variáveis de ambiente.

URL do servidor

Texto

https://api.postal.so/mcp

Cabeçalho (se escolher Bearer Token)

Texto

Authorization: Bearer ps_...

Acessos que a ferramenta precisa

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

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 v0 só usa as ferramentas durante a conversa: ler domínios, templates e e-mails (mcp:read) e mandar um e-mail de teste (mcp:send). Não há motivo para dar mcp:full a um gerador de código; com chave de API, uma sending_access basta para só enviar.

Como confirmar que funcionou

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

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 v0 lista OAuth, Bearer Token, cabeçalhos e sem autenticação, mas não diz o transporte, as URLs de retorno do OAuth, planos nem limites. O caminho de chave de API em Bearer foi verificado com o SDK; o OAuth é o fluxo padrão com registro dinâmico (qualquer URI de retorno HTTPS é aceita), não testado com o v0 real. Um guia da Platform API do v0 (não oficial da interface) cita https://api.v0.dev/v1/mcp-servers/oauth/callback, que a Postal também aceitaria.

Perguntas frequentes

Preciso de uma chave de API para conectar o v0?

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

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

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