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
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 403plan_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.
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
En el chat de Bolt, haz clic en el icono + y luego en Conectores (Connectors) y Gestionar conectores (Manage connectors).
- 2
En la página Connectors (MCP), haz clic en "Custom MCP server".
- 3
Indica un nombre, la URL
https://api.postal.so/mcp, el tipo de transporte HTTP y la autenticación MCP OAuth. - 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
Alternativa sin OAuth: autenticación API key, pegando una clave de API de Postal (
ps_...).
URL del servidor
https://api.postal.so/mcpAccesos que necesita la herramienta
Postal separa el acceso en tres niveles, explicados en la tabla de ámbitos. Para Bolt:
mcp:readVer correos, dominios, contactos, segmentos, temas, plantillas, campañas, automatizaciones, formularios, conversaciones de los buzones de entrada, métricas y uso.
mcp:sendEnviar 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.
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
Para quien quiere la prueba técnica
npx @modelcontextprotocol/inspector --cli https://api.postal.so/mcp \
--transport http \
--header "Authorization: Bearer ps_..." \
--method tools/listEl Inspector prueba que el servidor de Postal responde. No prueba Bolt en sí. El paso a paso completo está en Valida la conexión.
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/mcpal 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
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.
Sigue por aquí
Otras herramientas
Cada herramienta tiene su paso a paso. Mira también la lista completa en IA.
Lovable
Conecta Postal a Lovable como servidor MCP personalizado para usar tus datos de correo en el chat del proyecto.
Ver cómo conectarReplit
Añade Postal como servidor MCP en Replit Agent y usa tus dominios, plantillas y envíos en el proyecto.
Ver cómo conectarChatGPT
Añade Postal como servidor MCP personalizado en ChatGPT y conversa con tus datos de correo.
Ver cómo conectar¿Listo para usar Postal en Bolt?
Crea tu cuenta y conecta. Si necesitas ayuda, habla con nosotros por el formulario de contacto.