Conectar Claude Code a Postal

Revisa estos puntos antes de abrir la configuración de Claude Code. 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

   Ejecuta el comando de abajo (--scope user vale para todos los proyectos; sin la opción, vale solo para el proyecto actual).

2. 2

   Dentro de Claude Code, escribe /mcp, elige "postal" y sigue el inicio de sesión en el navegador. En una terminal sin navegador usa: claude mcp login postal.

3. 3

   En la pantalla de Postal, elige el equipo y haz clic en Permitir. Claude Code guarda y renueva los tokens.

4. 4

   Para usar una clave de API, usa el segundo comando (la clave queda en tu archivo de configuración local; no la pongas en un .mcp.json versionado, usa ${POSTAL_API_KEY}).

5. 5

   Para limitar el acceso a lectura y envío, fija los alcances en el .mcp.json (tercer fragmento).

claude mcp add --transport http --scope user postal https://api.postal.so/mcp

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

{
  "mcpServers": {
    "postal": {
      "type": "http",
      "url": "https://api.postal.so/mcp",
      "oauth": {
        "scopes": "mcp:read mcp:send"
      }
    }
  }
}

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

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

Qué se probó y qué no