Conectar Replit a Postal
Añade Postal como servidor MCP en Replit Agent y usa tus dominios, plantillas y envíos en el proyecto.
- Cómo se accede
- Cuenta o clave
- Transporte
- No indicado
- Accesos recomendados
- Lectura y envío
Antes de empezar
Revisa estos puntos antes de abrir la configuración de Replit. 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 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.
Qué necesita Replit
URL HTTPS pública. La documentación no indica plan, versión ni límites. Usa la cabecera Authorization (Postal no lee X-API-Key).
Conectar
Sigue los pasos en orden. La dirección del servidor es siempre https://api.postal.so/mcp. Camino recomendado: clave de API (la cuenta, por OAuth, también funciona). Donde aparece ps_..., usa tu clave de API: el valor que se muestra es solo un ejemplo.
- 1
En Replit, abre el panel MCP Servers y haz clic en "+ Add MCP server".
- 2
Indica un nombre (por ejemplo, Postal) y la URL
https://api.postal.so/mcp. - 3
En "Advanced settings" añade la cabecera Authorization con el valor Bearer
ps_...(una clave de API de Postal). Si prefieres OAuth, déjalo sin cabecera. - 4
Haz clic en "Test & save": Replit se conecta y, si el servidor exige OAuth, guía el inicio de sesión de Postal (elige el equipo y haz clic en Permitir).
- 5
Atajo: el enlace de instalación de abajo rellena el nombre y la URL.
URL del servidor
https://api.postal.so/mcpEncabezado
Authorization: Bearer ps_...Enlace de instalación
https://replit.com/integrations?mcp=eyJkaXNwbGF5TmFtZSI6IlBvc3RhbCIsImJhc2VVcmwiOiJodHRwczovL2FwaS5wb3N0YWwuc28vbWNwIn0=Accesos que necesita la herramienta
Postal separa el acceso en tres niveles, que se explican en la tabla de alcances. Para Replit:
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.
Replit Agent muestra una confirmación antes de las herramientas que piden aprobación. mcp:read + mcp:send cubren la consulta y el correo electrónico de prueba; con una clave sending_access el servidor expone solo send_email y track_event.
Cómo confirmar que funcionó
La prueba más sencilla es pedir algo de lectura dentro de Replit. 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 demuestra que el servidor de Postal responde. No prueba Replit en sí. La guía paso a paso completa 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 Replit.
Comprueba
- La dirección es exactamente
https://api.postal.so/mcp, con/mcpal final. - La documentación de Replit no indica el transporte. Si solo habla el transporte antiguo (SSE), Postal no conecta, y no fue posible confirmarlo.
- 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 Replit exige una URL HTTPS y describe cabeceras personalizadas y registro dinámico de cliente OAuth, pero no dice el transporte (los ejemplos del catálogo terminan en /sse), ni las URL de retorno, los planes o los límites. Si Replit solo habla el transporte heredado SSE, Postal (que solo ofrece Streamable HTTP) no conectará: no fue posible confirmarlo. La cabecera Authorization: Bearer con clave de API se verificó con el SDK. No probado con el Replit real. Todo el tráfico MCP de Replit pasa por un verificador de seguridad propio, que puede bloquear herramientas.
Preguntas frecuentes
¿Necesito una clave de API para conectar Replit?
No es obligatorio. Replit puede entrar con tu cuenta de Postal (OAuth) o con una clave de API. Camino recomendado: clave de API (la cuenta, por OAuth, también funciona). La clave solo de envío (sending_access) expone únicamente send_email y track_event.
¿Puedo limitar lo que hace Replit en mi cuenta?
Replit Agent muestra una confirmación antes de las herramientas que piden aprobación. mcp:read + mcp:send cubren la consulta y el correo electrónico de prueba; con una clave sending_access el servidor expone solo send_email y track_event. 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.
ChatGPT
Añade Postal como servidor MCP personalizado en ChatGPT y conversa con tus datos de correo.
Ver cómo conectarWindsurf
Conecta Postal a Cascade de Windsurf (ahora en la documentación de Devin Desktop) con un bloque en mcp_config.json.
Ver cómo conectarCursor
Conecta el editor Cursor a Postal para consultar dominios, entregas y plantillas y enviar correos electrónicos de prueba sin salir del código.
Ver cómo conectar¿Listo para usar Postal en Replit?
Crea tu cuenta y conecta. Si necesitas ayuda, habla con nosotros por el formulario de contacto.