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

Conectar Bolt con Postal

Añade Postal como conector personalizado de Bolt para consultar y enviar correos electrónicos mientras construyes el proyecto.

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 Bolt. Evitan la mayoría 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.

Lo que exige Bolt

Elige el transporte HTTP, no SSE. Muchos conectores pueden hacer que Bolt sea más lento y gaste más tokens (aviso de la propia documentación). La documentación no indica plan ni versión.

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. Donde aparezca ps_..., usa tu clave de API: el valor mostrado es solo un ejemplo.

  1. 1

    En el chat de Bolt, haz clic en el icono + y luego en Conectores (Connectors) y Gestionar conectores (Manage connectors).

  2. 2

    En la página Connectors (MCP), haz clic en "Custom MCP server".

  3. 3

    Indica un nombre, la URL https://api.postal.so/mcp, el tipo de transporte HTTP y la autenticación MCP OAuth.

  4. 4

    Haz clic en Connect, completa el inicio de sesión de Postal (elige el equipo y haz clic en Permitir) y espera al estado "Connected". Opcional: activa "Auto-enable for all projects".

  5. 5

    Alternativa sin OAuth: autenticación API key, pegando una clave de API de Postal (ps_...).

URL del servidor

Texto
https://api.postal.so/mcp
3

Accesos que necesita la herramienta

Postal separa el acceso en tres niveles, explicados en la tabla de ámbitos. Para Bolt:

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.

Para que Bolt consulte dominios y plantillas (mcp:read) y envíe un correo de prueba (mcp:send). Todas las herramientas del conector quedan activas por defecto en Bolt y valen para todos los proyectos; evita mcp:full y, si es posible, usa una clave sending_access.

4

Cómo confirmar que funcionó

La prueba más sencilla es pedir algo de lectura dentro del propio Bolt. 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 prueba que el servidor de Postal responde. No prueba Bolt en sí. El paso a paso completo 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 Bolt.

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

La documentación de Bolt ofrece los tipos de transporte "HTTP" (predeterminado) y "SSE" y las autenticaciones API key, MCP OAuth y None, pero no menciona URL de retorno de OAuth, planes ni límites. Postal solo ofrece Streamable HTTP, que es lo que Bolt llama HTTP; la opción SSE no funciona con Postal. La vía de la clave de API se verificó con el SDK; OAuth es el flujo estándar con registro dinámico, no probado con el Bolt real.

Preguntas frecuentes

¿Necesito una clave de API para conectar Bolt?

No es obligatoria. Bolt 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 de solo envío (sending_access) expone únicamente send_email y track_event.

¿Puedo limitar lo que hace Bolt en mi cuenta?

Para que Bolt consulte dominios y plantillas (mcp:read) y envíe un correo de prueba (mcp:send). Todas las herramientas del conector quedan activas por defecto en Bolt y valen para todos los proyectos; evita mcp:full y, si es posible, usa una clave sending_access. Puedes revocar la conexión en cualquier momento en Configuración › Conexiones de IA.

¿Listo para usar Postal en Bolt?

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