Conectar o GitHub Copilot à Postal

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

   VS Code (Copilot Chat): crie .vscode/mcp.json no projeto (ou rode o comando "MCP: Add Server" e escolha HTTP) com o primeiro bloco.

2. 2

   Clique em Start sobre o servidor no arquivo; o VS Code abre o login OAuth da Postal. Escolha o time e clique em Permitir.

3. 3

   No Copilot Chat, selecione o modo Agent e confira a lista de ferramentas (MCP: List Servers).

4. 4

   Com chave de API no VS Code, use o segundo bloco: o VS Code pergunta a chave ao iniciar o servidor.

5. 5

   Copilot CLI: rode o comando do terceiro trecho. Agente de nuvem do Copilot (GitHub): em Settings > Copilot > MCP servers do repositório, cole o JSON do quarto trecho e crie o segredo (ou variável) COPILOT_MCP_POSTAL_API_KEY nas configurações de Agents do repositório (só nomes que começam com COPILOT_MCP_ ficam disponíveis); esse agente não suporta servidores remotos com OAuth.

{
  "servers": {
    "postal": {
      "type": "http",
      "url": "https://api.postal.so/mcp"
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "postal-api-key",
      "description": "Postal API key",
      "password": true
    }
  ],
  "servers": {
    "postal": {
      "type": "http",
      "url": "https://api.postal.so/mcp",
      "headers": {
        "Authorization": "Bearer ${input:postal-api-key}"
      }
    }
  }
}

copilot mcp add --transport http --header "Authorization: Bearer ps_..." postal https://api.postal.so/mcp

{
  "mcpServers": {
    "postal": {
      "type": "http",
      "url": "https://api.postal.so/mcp",
      "tools": [
        "list_domains",
        "get_domain",
        "list_emails",
        "get_email",
        "get_usage"
      ],
      "headers": {
        "Authorization": "Bearer $COPILOT_MCP_POSTAL_API_KEY"
      }
    }
  }
}

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

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

O que foi testado e o que não foi