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

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
1

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 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 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).

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

    Crea (o edita) el archivo .cursor/mcp.json del proyecto, o ~/.cursor/mcp.json para que valga en todos los proyectos.

  2. 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. 3

    En la pantalla de Postal, elige el equipo y haz clic en Permitir. Cursor guarda y renueva los tokens solo.

  4. 4

    Para usar una clave de API en lugar de OAuth, usa la segunda configuración y define POSTAL_API_KEY en el entorno que inicia Cursor.

OAuth (recomendado)

.cursor/mcp.json
{
  "mcpServers": {
    "postal": {
      "url": "https://api.postal.so/mcp"
    }
  }
}

Clave de API

.cursor/mcp.json
{
  "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")

Texto
cursor://anysphere.cursor-deeplink/mcp/install?name=postal&config=eyJ1cmwiOiJodHRwczovL2FwaS5wb3N0YWwuc28vbWNwIn0=
3

Accesos que necesita la herramienta

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

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).

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).

4

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

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 Cursor 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 Cursor.

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: 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.

¿Listo para usar Postal en Cursor?

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