Conectar Windsurf a Postal

Revisa estos puntos antes de abrir la configuración de Windsurf. 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: clave de API (la cuenta, por OAuth, también funciona).

1. 1

   Abre el archivo mcp_config.json desde el panel MCP de Cascade (la documentación actual indica ~/.config/devin/mcp_config.json en macOS/Linux y %APPDATA%\devin\mcp_config.json en Windows; las instalaciones más antiguas usan ~/.codeium/windsurf/mcp_config.json).

2. 2

   Añade el bloque de abajo. En Windsurf el campo de la URL remota es serverUrl.

3. 3

   Para usar una clave de API, usa el segundo bloque y define POSTAL_API_KEY en el entorno (la sintaxis ${env:NOME} se sustituye por el valor de la variable).

4. 4

   Actualiza la lista de servidores en el panel MCP. Con OAuth, el inicio de sesión de Postal se abre en el primer uso: elige el equipo y haz clic en Permitir.

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

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

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

La prueba más sencilla es pedir algo de lectura dentro de Windsurf. 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 Windsurf 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 Windsurf.

Qué se probó y qué no