Conectar Claude a Postal
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.
- Cómo se accede
- Cuenta (OAuth)
- Transporte
- HTTP
- Accesos recomendados
- Lectura y envío
Antes de empezar
Revisa estos puntos antes de abrir la configuración de Claude. 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.
- 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 Claude
Servidor accesible desde internet pública (Anthropic se conecta desde 160.79.104.0/21; libéralo en el firewall/WAF si lo hay). Free, Pro, Max, Team y Enterprise pueden añadir conectores personalizados (Free: uno). En Team/Enterprise solo los Owners pueden añadirlos. Resultado de herramienta de hasta unos 150 mil caracteres y 240 s por llamada; el OAuth debe responder en 10 s (30 s en el refresh). Anthropic guarda en caché los metadatos de descubrimiento durante unos 5 minutos.
Conectar
Sigue los pasos en orden. La dirección del servidor es siempre https://api.postal.so/mcp. Esta herramienta entra con tu cuenta (OAuth).
- 1
Planes Pro y Max: en Personalizar (Customize) > Conectores, haz clic en + Añadir y en "Añadir conector personalizado". Free: un conector personalizado.
- 2
Ponle un nombre (por ejemplo, Postal), indica la URL
https://api.postal.so/mcpy continúa. - 3
Comprueba la autenticación detectada (OAuth) y elige "Iniciar sesión ahora" (Sign in now). En "Cliente OAuth" deja la opción predeterminada: Claude se identifica solo.
- 4
En la pantalla de Postal, elige el equipo y haz clic en Permitir; después haz clic en Añadir.
- 5
Team y Enterprise: un Owner añade el conector en Configuración de la organización > Conectores > Añadir > Personalizado > Web, con la misma URL; después cada persona abre Personalizar > Conectores y hace clic en Conectar.
- 6
En cada conversación, activa el conector en el botón + > Conectores.
URL del conector
https://api.postal.so/mcpAccesos que necesita la herramienta
Postal separa el acceso en tres niveles, que se explican en la tabla de alcances. Para Claude:
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).
Para preguntar "¿cómo fueron los envíos de hoy?" basta mcp:read. Para que Claude envíe correos electrónicos hace falta mcp:send. mcp:full es necesario para crear plantillas, contactos y campañas y para responder en los buzones de entrada. Claude pide los tres alcances que anuncia Postal y, si una herramienta exige más de lo que tiene la conexión, repite la autorización (respuesta 403 insufficient_scope).
Cómo confirmar que funcionó
La prueba más sencilla es pedir algo de lectura dentro de Claude. 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/inspectorEl Inspector demuestra que el servidor de Postal responde. No prueba Claude 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 Claude.
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
Ejecutamos pruebas automatizadas de Postal con los documentos y las direcciones de retorno reales que publica la app, y con el cliente oficial del SDK de MCP. No es una prueba dentro de la aplicación real. A continuación, la nota completa de lo que se verificó y lo que no.
Detalle de la prueba
Verificado con una prueba: el documento de metadatos que Anthropic publica para Claude (https://claude.ai/oauth/mcp-oauth-client-metadata, con los grants authorization_code, refresh_token y jwt-bearer) se acepta, el flujo completo (consentimiento, token, refresh) funciona con la redirección https://claude.ai/api/mcp/auth_callback, y el registro dinámico también. Esto exigió una corrección en Postal el 2026-10-28: antes, el grant jwt-bearer hacía que el documento se rechazara y la conexión fallaría. No probado dentro del Claude real, y no fue posible confirmar cuál de los dos caminos (documento o registro) elige Claude: la documentación dice que usa el documento cuando el servidor anuncia client_id_metadata_document_supported y "none" en los métodos del token endpoint, lo que Postal hace.
Preguntas frecuentes
¿Necesito una clave de API para conectar Claude?
No. Claude entra con tu cuenta de Postal (OAuth), eligiendo el equipo en la pantalla de permiso. En esta página no documentamos un camino con clave de API para él.
¿Puedo limitar lo que hace Claude en mi cuenta?
Para preguntar "¿cómo fueron los envíos de hoy?" basta mcp:read. Para que Claude envíe correos electrónicos hace falta mcp:send. mcp:full es necesario para crear plantillas, contactos y campañas y para responder en los buzones de entrada. Claude pide los tres alcances que anuncia Postal y, si una herramienta exige más de lo que tiene la conexión, repite la autorización (respuesta 403 insufficient_scope). 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 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 conectarGitHub Copilot
Usa Postal en GitHub Copilot: en VS Code con OAuth, y en Copilot CLI y en el agente de nube de Copilot con una clave de API.
Ver cómo conectar¿Listo para usar Postal en Claude?
Crea tu cuenta y conecta. Si necesitas ayuda, habla con nosotros por el formulario de contacto.