Conectar Cursor a Postal
Conecta el editor Cursor a Postal para consultar dominios, entregas y plantillas y enviar correos electrónicos de prueba sin salir del código.
- 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 Cursor. 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 Cursor
Cursor con soporte para servidores MCP remotos (la documentación no indica versión mínima). El inicio de sesión OAuth usa el navegador local. Postal debe ser accesible por HTTPS público (lo es).
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
Crea (o edita) el archivo
.cursor/mcp.jsondel proyecto, o~/.cursor/mcp.jsonpara que valga en todos los proyectos. - 2
Pega la configuración de abajo. Solo hace falta la URL: Cursor se registra solo (Dynamic Client Registration) y abre el inicio de sesión OAuth de Postal.
- 3
En la pantalla de Postal, elige el equipo y haz clic en Permitir. Cursor guarda y renueva los tokens solo.
- 4
Para usar una clave de API en lugar de OAuth, usa la segunda configuración y define
POSTAL_API_KEYen el entorno que inicia Cursor.
OAuth (recomendado)
{
"mcpServers": {
"postal": {
"url": "https://api.postal.so/mcp"
}
}
}Clave de API
{
"mcpServers": {
"postal": {
"url": "https://api.postal.so/mcp",
"headers": {
"Authorization": "Bearer ${env:POSTAL_API_KEY}"
}
}
}
}Enlace de instalación (botón "Añadir a Cursor")
cursor://anysphere.cursor-deeplink/mcp/install?name=postal&config=eyJ1cmwiOiJodHRwczovL2FwaS5wb3N0YWwuc28vbWNwIn0=Accesos que necesita la herramienta
Postal separa el acceso en tres niveles, que se explican en la tabla de alcances. Para Cursor:
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.
mcp:fullTodo 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).
mcp:read deja que el asistente consulte dominios, correos electrónicos y plantillas (diagnosticar entregas); mcp:send es lo que permite enviar correos electrónicos de prueba. mcp:full solo si quieres que cree plantillas, contactos y campañas. Cursor pide los tres alcances que anuncia Postal; para limitar, usa la clave de API sending_access o el bloque auth de Cursor (que exige un client id registrado por ti en POST /oauth/register).
Cómo confirmar que funcionó
La prueba más sencilla es pedir algo de lectura dentro de Cursor. 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 Cursor 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 Cursor.
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
Verificado con una prueba: las tres redirecciones que citan la documentación y el foro de Cursor (cursor://, localhost:8787 y cursor.com) se aceptan en el registro y en el flujo completo, y la clave de API en cabecera funciona con el cliente oficial del SDK. No probado con el Cursor real. Un reporte público de 2026 (foro de Cursor, versión 3.19.13) describe a Cursor registrando los tres URI pero enviando localhost:8787 en la autorización; Postal acepta los tres, así que el reporte no se aplica a ella.
Preguntas frecuentes
¿Necesito una clave de API para conectar Cursor?
No es obligatorio. Cursor 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 Cursor en mi cuenta?
mcp:read deja que el asistente consulte dominios, correos electrónicos y plantillas (diagnosticar entregas); mcp:send es lo que permite enviar correos electrónicos de prueba. mcp:full solo si quieres que cree plantillas, contactos y campañas. Cursor pide los tres alcances que anuncia Postal; para limitar, usa la clave de API sending_access o el bloque auth de Cursor (que exige un client id registrado por ti en POST /oauth/register). 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.
Claude
Añade Postal como conector personalizado en Claude (web, escritorio y móvil) y pídele que consulte y envíe correos electrónicos en lenguaje natural.
Ver cómo conectarClaude Code
Añade Postal a Claude Code con un comando y usa la terminal para diagnosticar entregas y enviar correos electrónicos de prueba.
Ver cómo conectarCodex
Configura Postal en Codex (CLI, extensión de IDE y app) con unas pocas líneas en config.toml.
Ver cómo conectar¿Listo para usar Postal en Cursor?
Crea tu cuenta y conecta. Si necesitas ayuda, habla con nosotros por el formulario de contacto.