Conectar o Windsurf à Postal

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

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

1. 1

   Abra o arquivo mcp_config.json pelo painel MCP do Cascade (a documentação atual indica ~/.config/devin/mcp_config.json no macOS/Linux e %APPDATA%\devin\mcp_config.json no Windows; instalações mais antigas usam ~/.codeium/windsurf/mcp_config.json).

2. 2

   Adicione o bloco abaixo. No Windsurf o campo da URL remota é serverUrl.

3. 3

   Para chave de API, use o segundo bloco e defina POSTAL_API_KEY no ambiente (a sintaxe ${env:NOME} é substituída pelo valor da variável).

4. 4

   Atualize a lista de servidores no painel MCP. Com OAuth, o login da Postal abre no primeiro uso: escolha o time e clique em Permitir.

{
  "mcpServers": {
    "postal": {
      "serverUrl": "https://api.postal.so/mcp"
    }
  }
}

{
  "mcpServers": {
    "postal": {
      "serverUrl": "https://api.postal.so/mcp",
      "headers": {
        "Authorization": "Bearer ${env:POSTAL_API_KEY}"
      }
    }
  }
}

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

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

Para quem quer a prova técnica

npx @modelcontextprotocol/inspector --cli https://api.postal.so/mcp \
  --transport http \
  --header "Authorization: Bearer ps_..." \
  --method tools/list

O Inspector prova que o servidor da Postal responde. Ele não testa o Windsurf em si. O passo a passo completo está em Valide a conexão.

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

O que foi testado e o que não foi