Conectar GitHub Copilot a Postal

Revisa estos puntos antes de abrir la configuración de GitHub Copilot. Evitan la mayor parte de los fallos de conexión.

• Un equipo con el recurso de plan "Servidor MCP" (mcp_access); sin él, el servidor responde 403 plan_limit_reached.
• Para enviar correos electrónicos hace falta tener al menos un dominio verificado en el equipo.
• Si vas a usar una clave de API: crea la clave en el panel, en Claves de API. Empieza por ps_; una clave de solo envío basta para quien solo va a enviar.
• Cada conexión actúa en un único equipo. Para usar otro equipo, conecta de nuevo eligiendo el otro.
• Las conexiones están en Configuración › Conexiones de IA en el panel, donde se pueden revocar en cualquier momento.

Sigue los pasos en orden. La dirección del servidor es siempre https://api.postal.so/mcp. Camino recomendado: entrar con tu cuenta (OAuth). La clave de API es la alternativa. Donde aparezca ps_..., usa tu clave de API: el valor mostrado es solo un ejemplo.

1. 1

   VS Code (Copilot Chat): crea .vscode/mcp.json en el proyecto (o ejecuta el comando "MCP: Add Server" y elige HTTP) con el primer bloque.

2. 2

   Haz clic en Start sobre el servidor en el archivo; VS Code abre el inicio de sesión OAuth de Postal. Elige el equipo y haz clic en Permitir.

3. 3

   En Copilot Chat, selecciona el modo Agent y comprueba la lista de herramientas (MCP: List Servers).

4. 4

   Con clave de API en VS Code, usa el segundo bloque: VS Code te pide la clave al iniciar el servidor.

5. 5

   Copilot CLI: ejecuta el comando del tercer fragmento. Agente de nube de Copilot (GitHub): en Settings > Copilot > MCP servers del repositorio, pega el JSON del cuarto fragmento y crea el secreto (o variable) COPILOT_MCP_POSTAL_API_KEY en la configuración de Agents del repositorio (solo los nombres que empiezan por COPILOT_MCP_ quedan disponibles); este agente no admite servidores remotos con 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"
      }
    }
  }
}

Postal separa el acceso en tres niveles, que se explican en la tabla de alcances. Para GitHub Copilot:

La prueba más sencilla es pedir algo de lectura dentro de GitHub Copilot. La conexión también aparece en Configuración › Conexiones de IA, en el panel de Postal, con la app, el equipo y el último uso.

Para quien quiere la prueba técnica

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

El Inspector demuestra que el servidor de Postal responde. No prueba GitHub Copilot en sí. La guía paso a paso completa está en Valida la conexión.

Recorre la lista en orden. Después, lee lo que sabemos (y lo que no sabemos) sobre GitHub Copilot.

Qué se probó y qué no