Novedad: campañas, automatizaciones y correos del producto en la misma cuenta. Conoce Postal
Iniciar sesión Crear cuenta
Línea de comandosCompatible según la especificaciónComprobado el 28/10/2026

Conectar Codex a Postal

Configura Postal en Codex (CLI, extensión de IDE y app) con unas pocas líneas en config.toml.

Ver cómo conectar
Cómo se accede
Cuenta o clave
Transporte
HTTP
Accesos recomendados
Lectura y envío
1

Antes de empezar

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

Qué necesita Codex

Codex con soporte para servidores MCP de Streamable HTTP y OAuth (la documentación no indica versión mínima ni plan). Timeouts predeterminados: 10 s para iniciar y 60 s por llamada de herramienta (tool_timeout_sec). La app web de ChatGPT no lee el config.toml: ahí usa el conector de ChatGPT.

2

Conectar

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.

  1. 1

    Edita ~/.codex/config.toml (o .codex/config.toml en un proyecto de confianza) y añade el bloque de abajo.

  2. 2

    Ejecuta: codex mcp login postal. Codex abre el navegador para el inicio de sesión de Postal (elige el equipo y haz clic en Permitir).

  3. 3

    Comprueba con: codex mcp list. La CLI, la extensión de IDE y la app usan la misma configuración.

  4. 4

    Para usar una clave de API, usa el segundo bloque y exporta POSTAL_API_KEY en el entorno.

  5. 5

    Para pedir menos alcances, añade scopes = ["mcp:read", "mcp:send"] al bloque del servidor.

OAuth (recomendado)

~/.codex/config.toml
[mcp_servers.postal]
url = "https://api.postal.so/mcp"

Clave de API

~/.codex/config.toml
[mcp_servers.postal]
url = "https://api.postal.so/mcp"
bearer_token_env_var = "POSTAL_API_KEY"

Inicio de sesión

Terminal
codex mcp login postal
3

Accesos que necesita la herramienta

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

Necesario
Leer tus datosmcp:read

Ver correos, dominios, contactos, segmentos, temas, plantillas, campañas, automatizaciones, formularios, conversaciones de los buzones de entrada, métricas y uso.

Recomendado
Enviar correos y eventosmcp:send

Enviar y programar correos de dominios verificados y registrar eventos para automatizaciones.

Solo si quieres
Gestionar todomcp:full

Todo lo anterior, más crear, modificar y borrar contactos y plantillas, crear y enviar campañas (send_broadcast exige confirm: true), cancelar correos programados y trabajar en los buzones de entrada (organizar, responder, crear borrador).

Sin la clave scopes, Codex usa los alcances que anuncia el servidor (los tres). Para uso de desarrollo, mcp:read + mcp:send cubren consultar entregas y enviar correos electrónicos de prueba; mcp:full solo para que el agente modifique plantillas, contactos y campañas.

4

Cómo confirmar que funcionó

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

Ejemplo ilustrativo

Lista mis dominios en Postal.
Encontré 2 dominios en el equipo Aurora Cosméticos: exemplo.com.br (verificado) y loja.exemplo.com.br (en verificación).

Para quien quiere la prueba técnica

Terminal: lista de herramientas con una clave de API
npx @modelcontextprotocol/inspector --cli https://api.postal.so/mcp \
  --transport http \
  --header "Authorization: Bearer ps_..." \
  --method tools/list
34Herramientas esperadas con clave de acceso total

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

5

Si hay algún problema

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

Comprueba

  • La dirección es exactamente https://api.postal.so/mcp, con /mcp al final.
  • El tipo de conexión es HTTP (Streamable HTTP). Postal no ofrece SSE: si la herramienta te da a elegir, usa HTTP.
  • El equipo tiene el recurso "Servidor MCP" en el plan. Sin él, el servidor responde 403 plan_limit_reached.
  • Para enviar correos electrónicos, el equipo tiene al menos un dominio verificado.
  • Cada conexión actúa en un único equipo. Para usar otro, conecta de nuevo y elige el otro.
  • Respuesta 429 (rate_limit_exceeded): se alcanzó el límite de solicitudes por segundo del plan. Espera un poco y vuelve a intentarlo.
  • Si la herramienta se queja del tamaño de la respuesta, pide listas más pequeñas (máximo 100 elementos por llamada; el valor predeterminado es 20).
  • Para empezar de cero, revoca la conexión en Configuración › Conexiones de IA y conecta de nuevo.

Qué se probó y qué no

Compatible según la especificaciónComprobado el 28/10/2026

Seguimos la especificación y la documentación de la app, pero todavía no la probamos con la app real. A continuación, la nota completa de lo que se verificó y lo que no.

Detalle de la prueba

Verificado con una prueba: la redirección predeterminada de Codex (http://127.0.0.1:PORTA/callback) se acepta en el registro dinámico y en el flujo completo; la clave de API en Bearer es el mismo camino verificado con el SDK. Codex también puede usar Client ID Metadata Document cuando el servidor lo anuncia, pero no encontramos la URL ni el contenido de su documento, así que ese camino no se probó; el registro dinámico (que Codex usa como alternativa) sí. No probado con el Codex real.

Preguntas frecuentes

¿Necesito una clave de API para conectar Codex?

No es obligatorio. Codex puede entrar con tu cuenta de Postal (OAuth) o con una clave de API. Camino recomendado: entrar con tu cuenta (OAuth). La clave de API es la alternativa. La clave solo de envío (sending_access) expone únicamente send_email y track_event.

¿Puedo limitar lo que hace Codex en mi cuenta?

Sin la clave scopes, Codex usa los alcances que anuncia el servidor (los tres). Para uso de desarrollo, mcp:read + mcp:send cubren consultar entregas y enviar correos electrónicos de prueba; mcp:full solo para que el agente modifique plantillas, contactos y campañas. Puedes revocar la conexión en cualquier momento en Configuración › Conexiones de IA.

Documentación oficial de CodexServidor MCP de PostalAutenticación y clavesTodas las herramientas

Sigue por aquí

Otras herramientas

Cada herramienta tiene su paso a paso. Mira también la lista completa en IA.

GitHub Copilot

Usa Postal en GitHub Copilot: en VS Code con OAuth, y en Copilot CLI y en el agente de nube de Copilot con una clave de API.

Ver cómo conectar

Gemini

Conecta Postal a Gemini CLI (y a Antigravity, que lo sustituye para quien no tiene un plan de pago) para consultar y enviar correos electrónicos desde la terminal.

Ver cómo conectar

v0

Conecta Postal a v0 para que consulte tus dominios y plantillas y envíe correos electrónicos de prueba mientras genera la app.

Ver cómo conectar

¿Listo para usar Postal en Codex?

Crea tu cuenta y conecta. Si necesitas ayuda, habla con nosotros por el formulario de contacto.

Crear cuentaVer todas las herramientas