Conectar Gemini a Postal

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

   Gemini CLI: ejecuta el primer comando (crea la entrada en .gemini/settings.json del proyecto; para que valga en todos los proyectos, edita ~/.gemini/settings.json con el segundo fragmento).

2. 2

   Dentro de Gemini CLI, ejecuta /mcp auth postal. El navegador abre el inicio de sesión de Postal; elige el equipo y haz clic en Permitir. El inicio de sesión necesita un navegador local (no funciona en SSH sin X11 ni en un contenedor sin navegador).

3. 3

   Para usar una clave de API, usa el tercer comando.

4. 4

   Antigravity (Google): edita ~/.gemini/config/mcp_config.json con el cuarto fragmento (el campo es serverUrl; url y httpUrl no valen ahí). En Agent settings > Customizations, haz clic en Authenticate, completa el inicio de sesión y pega el código de autorización en el panel.

gemini mcp add --transport http postal https://api.postal.so/mcp

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

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

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

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

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

Qué se probó y qué no