Asistentes de IA
Conecta tu herramienta de IA a Postal
Conectar es dar a un asistente de IA permiso para trabajar en tu cuenta de Postal. Después, se lo pides con tus palabras y él consulta contactos y envíos, manda correos electrónicos y crea campañas, solo dentro de lo que autorizaste.
En pocas palabras
Cómo funciona
Son tres pasos, y lo que cambia de una herramienta a otra es dónde pegas la dirección.
1. Elige tu herramienta
Cada una tiene su propio paso a paso, con lo que copiar y dónde pegarlo.
2. Entra con tu cuenta
Indicas la dirección de Postal, eliges el equipo y haces clic en Permitir. Algunas herramientas aceptan también una clave de API.
3. Pídelo con tus palabras
Por ejemplo: “muestra mis dominios”. El asistente usa las acciones de Postal y responde en la conversación.
Herramientas
Elige tu herramienta
Son 12 herramientas, de asistentes de conversación a editores de código y creadores de apps. El sello dice, sin rodeos, cuánto hemos probado.
Cursor
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 conectarProbado por nosotrosClaude
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 conectarProbado por nosotrosClaude 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 conectarCompatible según la especificaciónCodex
Configura Postal en Codex (CLI, extensión de IDE y app) con unas pocas líneas en config.toml.
Ver cómo conectarProbado por nosotrosGitHub 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 conectarCompatible según la especificaciónGemini
Conecta Postal a Gemini CLI (y a Antigravity, que lo sustituye para quien no tiene un plan de pago) para consultar y enviar correos electrónicos desde la terminal.
Ver cómo conectarCompatible según la especificaciónv0
Conecta Postal a v0 para que consulte tus dominios y plantillas y envíe correos electrónicos de prueba mientras genera la app.
Ver cómo conectarCompatible según la especificaciónBolt
Añade Postal como conector personalizado de Bolt para consultar y enviar correos electrónicos mientras construyes el proyecto.
Ver cómo conectarCompatible según la especificaciónLovable
Conecta Postal a Lovable como servidor MCP personalizado para usar tus datos de correo en el chat del proyecto.
Ver cómo conectarCompatible según la especificaciónReplit
Añade Postal como servidor MCP en Replit Agent y usa tus dominios, plantillas y envíos en el proyecto.
Ver cómo conectarProbado por nosotrosChatGPT
Añade Postal como servidor MCP personalizado en ChatGPT y conversa con tus datos de correo.
Ver cómo conectarCompatible según la especificaciónWindsurf
Conecta Postal a Cascade de Windsurf (ahora en la documentación de Devin Desktop) con un bloque en mcp_config.json.
Ver cómo conectarLo que significa cada sello está en la matriz de compatibilidad.
Servidor MCP
Lo que el servidor de Postal ofrece
Postal tiene un servidor MCP, el estándar abierto que los asistentes de IA usan para hablar con otros sistemas. Es el que conectas.
Una sola dirección, para todas las herramientas
La URL es la misma para todas las apps. El dominio de la API es https://api.postal.so y el endpoint es /mcp.
- Transporte: Streamable HTTP sin estado. Solo POST en
/mcp; no existe el antiguo transporte HTTP+SSE. Si la app te da a elegir entre HTTP y SSE, elige HTTP. - 34 herramientas que el asistente puede usar, además de 2 recursos (dominios y guía de inicio) y 2 guiones listos (escribir y enviar una campaña, diagnosticar la entrega).
- Dos formas de entrar: con tu cuenta (OAuth) o con una clave de API.
https://api.postal.so/mcpAutenticación
Dos formas de entrar
La mayoría de las herramientas acepta las dos. La página de cada una indica cuál es el camino recomendado.
OAuth 2.1 (recomendado)
Cada persona entra con su propia cuenta de Postal y elige un equipo en la pantalla de permiso. La app se registra sola y el acceso dura 1 hora, renovado por un código de 30 días que cambia con cada uso.
Clave de API en encabezado
Para apps que aceptan encabezados fijos: Authorization: Bearer ps_..., con una clave creada en el panel, en Claves de API. La clave de acceso total (full_access) ve las 34 herramientas; la clave solo de envío (sending_access) ve únicamente send_email y track_event.
Conviene saber
- Las herramientas ejecutan los mismos endpoints de la API REST: misma validación, cuota diaria, pausa de envío, lista de supresión y límite de solicitudes por segundo del plan (respuesta 429
rate_limit_exceeded). - Las listas traen como máximo 100 elementos por llamada (20 por defecto), en páginas. Pide menos elementos cuando puedas.
send_emailaceptaidempotency_key: repetir la llamada no envía el correo electrónico dos veces.
Accesos
Scopes: lo que permite cada acceso
Un scope es un permiso. Postal tiene tres, del más restringido al más amplio.
| Acceso | Qué habilita | Herramientas |
|---|---|---|
Leer tus datosmcp:read | Ver correos electrónicos, dominios, contactos, segmentos, temas, plantillas, campañas, automatizaciones, formularios, conversaciones de los buzones de entrada, métricas y uso. 22 herramientas (list_*, get_*). | 22 herramientaslist_domains, get_email, get_metrics |
Enviar correos y eventosmcp:send | Enviar y programar correos electrónicos desde dominios verificados y registrar eventos para automatizaciones. 2 herramientas. Por sí solo no permite ver el estado del correo (get_email requiere mcp:read). | 2 herramientassend_email, track_event |
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). 10 herramientas de escritura. | 10 herramientassend_broadcast, create_contact, reply_to_inbox_thread |
mcp:full incluye los otros dos. Las apps piden los tres scopes por defecto (el servidor los anuncia en el encabezado WWW-Authenticate) y la pantalla de consentimiento concede el conjunto solicitado; la persona elige el equipo, no los scopes.
Para limitar, fija el scope en la configuración de la app cuando lo permita (Claude Code: oauth.scopes; Codex: scopes; Cursor: bloque auth con un client id que registres tú) o usa una clave de API sending_access (solo envío).
Paso a paso
Valida la conexión
Antes de configurar una app, confirma que el servidor responde y que la app encontrará el servidor de autorización. No hace falta ser técnico para conectar: esta parte es para quien quiere ver la prueba.
Comprueba que el descubrimiento de OAuth responde
El comando de abajo pide a Postal los datos de la entrada por cuenta. Debe responder 200 con un JSON (issuer, authorization_endpoint, token_endpoint, registration_endpoint y code_challenge_methods_supported ["S256"]). Si responde 403 o una página HTML, algo delante del servidor está bloqueando la ruta /.well-known y las apps con OAuth no podrán conectarse. En ese caso, avísanos por el formulario de contacto.
curl -i https://api.postal.so/.well-known/oauth-authorization-serverRevisa el desafío de autenticación
Sin token, el servidor debe rechazar la solicitud e indicar dónde está la entrada: la respuesta esperada es 401, con el encabezado WWW-Authenticate de abajo.
curl -i -X POST https://api.postal.so/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"teste","version":"1"}}}'WWW-Authenticate: Bearer resource_metadata="https://api.postal.so/.well-known/oauth-protected-resource/mcp",
scope="mcp:read mcp:send mcp:full"Lista las herramientas con una clave de API
Con una clave de acceso total, la lista debe tener 34 herramientas; con una clave solo de envío, 2. Cambia ps_... por tu clave. Probamos esta línea de comandos en la versión 2.12.0 del Inspector; los nombres de las opciones pueden cambiar en otras versiones.
npx @modelcontextprotocol/inspector --cli https://api.postal.so/mcp \
--transport http \
--header "Authorization: Bearer ps_..." \
--method tools/listO usa la interfaz web, entrando con la cuenta
Ejecuta el comando, elige el transporte Streamable HTTP, pega la dirección del servidor y conecta. El Inspector lleva el inicio de sesión de Postal en el navegador: elige el equipo y permite. Los nombres exactos de los botones cambian entre versiones del Inspector. Después de conectar, la lista debe mostrar las 34 herramientas (send_email, list_domains, list_contacts...), y al ejecutar get_usage debe devolver el uso del plan del equipo elegido.
npx @modelcontextprotocol/inspectorRevisa la conexión en el panel
La conexión aparece en Configuración › Conexiones de IA, con la app, el equipo y el último uso. Ahí mismo también la revocas.
Situación de cada una
Matriz de compatibilidad
Una fila por herramienta: cómo entra, qué transporte usa y cuánto hemos probado.
| Herramienta | Tipo | Cómo se accede | Transporte | Situación |
|---|---|---|---|---|
| Cursor | Editor | Cuenta (OAuth) o clave de API | HTTP | Compatible según la especificación |
| Claude | Asistente | Cuenta (OAuth) | HTTP | Probado por nosotros |
| Claude Code | Línea de comandos | Cuenta (OAuth) o clave de API | HTTP | Probado por nosotros |
| Codex | Línea de comandos | Cuenta (OAuth) o clave de API | HTTP | Compatible según la especificación |
| GitHub Copilot | Editor | Cuenta (OAuth) o clave de API | HTTP | Probado por nosotros |
| Gemini | Línea de comandos | Cuenta (OAuth) o clave de API | HTTP | Compatible según la especificación |
| v0 | Creador de apps | Cuenta (OAuth) o clave de API | HTTP | Compatible según la especificación |
| Bolt | Creador de apps | Cuenta (OAuth) o clave de API | HTTP | Compatible según la especificación |
| Lovable | Creador de apps | Cuenta (OAuth) o clave de API | No indicado | Compatible según la especificación |
| Replit | Creador de apps | Clave de API o cuenta (OAuth) | No indicado | Compatible según la especificación |
| ChatGPT | Asistente | Cuenta (OAuth) | HTTP | Probado por nosotros |
| Windsurf | Editor | Clave de API o cuenta (OAuth) | HTTP | Compatible según la especificación |
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. La página de cada herramienta incluye la nota completa de lo que se verificó y lo que no.
Seguimos la especificación y la documentación de la app, pero todavía no la hemos probado con la app real. La página de cada herramienta incluye la nota completa de lo que se verificó y lo que no.
Qué significa exactamente “probado por nosotros”
Verificado mediante una prueba automatizada de Postal con los artefactos reales que publica la app (documento de metadatos del cliente, URIs de retorno documentadas) y con el cliente oficial del SDK de MCP. No es una prueba dentro del producto de la app.
Cómo probamos (28/10/2026). Servidor local de prueba (php artisan serve, SQLite) ejercitado por un cliente Node con @modelcontextprotocol/sdk 1.32.2 (descubrimiento, registro dinámico, PKCE, token, refresh con rotación, initialize, tools/list, tools/call, clave de API en encabezado), por el MCP Inspector en modo CLI y por pruebas automatizadas (PHPUnit) que usan los documentos de metadatos reales publicados por Claude, Claude Code, ChatGPT y VS Code.
Esto no es un sello del fabricante. En ninguna de las herramientas de la tabla ejecutamos la conexión dentro de la aplicación real: por eso cada página muestra, además del sello, la nota completa de lo que se verificó y lo que no.
Antes de conectar
Preguntas frecuentes
¿Necesito un plan específico?
Depende del plan. El equipo debe tener el recurso Servidor MCP en el plan; sin él, el servidor responde con el error 403 plan_limit_reached. Algunas herramientas también tienen reglas propias de plan o de permisos (por ejemplo, quién puede añadir conectores): aparecen en “Antes de empezar”, en la página de cada una. Consulta los planes en Precios.
¿Puedo limitar lo que hace el asistente?
En parte. Los accesos son de tres niveles (leer, enviar y gestionar todo), en la tabla de scopes. Con clave de API, la clave solo de envío (sending_access) expone únicamente send_email y track_event. Al entrar con la cuenta, las apps piden los tres scopes por defecto y la pantalla de permiso concede el conjunto solicitado: tú eliges el equipo, no los scopes. Algunas herramientas permiten fijar los scopes en la configuración (Claude Code, Codex y Cursor, por ejemplo); la página de cada una indica qué vale para ella. Incluso con acceso total, enviar una campaña exige confirmación explícita (confirm: true).
¿Cómo revoco el acceso?
En el panel de Postal, en Configuración › Conexiones de IA: cada conexión aparece con la app, el equipo y el último uso, y se puede revocar en cualquier momento. Si usaste una clave de API, revoca la clave en Claves de API. Los detalles están en la documentación del servidor MCP y en Autenticación.
¿Mis datos van a la empresa de la IA?
Solo lo que la herramienta consulte. Cuando pides algo, la herramienta llama a las acciones de Postal y recibe el resultado (por ejemplo, la lista de tus dominios o los datos de un correo electrónico). Ese resultado pasa a formar parte de la conversación y queda bajo las reglas de la empresa de esa herramienta. Postal solo responde a lo que la herramienta pida, dentro de los accesos que autorizaste, y cada conexión actúa en un único equipo. Lee la política de la herramienta que elijas y da solo el acceso que necesites. Sobre los datos en Postal, consulta la Política de privacidad.
¿Y si la conexión falla?
- Revisa la dirección:
https://api.postal.so/mcp, con/mcpal final, y el tipo de conexión HTTP. Postal no ofrece SSE. - Comprueba que el equipo tenga el recurso "Servidor MCP" en el plan. Sin él, el servidor responde 403
plan_limit_reached. - Para enviar correos electrónicos, el equipo debe tener al menos un dominio verificado.
- Cada conexión actúa en un único equipo. Para usar otro, conecta de nuevo y elige el otro.
- Ejecuta las pruebas de “Valida la conexión”, más arriba. Si el descubrimiento de OAuth no responde 200, las apps con OAuth no pueden conectarse.
- Respuesta 429 (
rate_limit_exceeded): se alcanzó el límite de solicitudes por segundo del plan. Espera un poco y vuelve a intentarlo. - ¿Sigue sin resolverse? Consulta “Si hay problemas” en la página de la herramienta y la documentación del servidor MCP, o habla con nosotros por el formulario de contacto.
¿Quieres conectar tu herramienta?
Crea tu cuenta y conecta a tu asistente. Si necesitas ayuda, habla con nosotros por el formulario de contacto.