Conecta tu bandeja a Windsurf
y a Cascade
Añade un buzón real a Cascade. Lee, busca, envía, responde, reenvía, programa y organiza correo desde el editor, en todas las bandejas que tengas conectadas.
Añade una entrada en mcpServers de ~/.codeium/windsurf/mcp_config.json usando el campo serverUrl, no url, con https://mcpemails.com/api/mcp. Actualiza los servidores MCP en Cascade y autoriza cuando se te pida.
Cómo se conecta Windsurf: OAuth, sin clave de API
Windsurf ejecuta el flujo OAuth estándar de MCP contra este servidor. Se registra solo mediante registro dinámico de clientes RFC 7591, así que no hay ningún client ID que crear, y se autoriza con código de autorización más PKCE usando S256. Nunca se transmite un secreto de cliente, y el token solo lleva los permisos que apruebas en nuestra pantalla de consentimiento. El token de acceso que recibe dura una hora y se renueva solo; aparece en Dashboard, API Keys como OAuth: seguido del nombre del cliente, y ahí es donde revocas la conexión.
El único valor que necesitas
Todo en esta página es una forma de llevar esta URL a Windsurf.
| Campo | Valor |
|---|---|
| URL del servidor MCP | https://mcpemails.com/api/mcp |
| Transporte | Streamable HTTP (MCP 2025-06-18) |
| Autenticación | OAuth 2.1, código de autorización con PKCE. Sin clave de API. |
Cómo conectar Windsurf a tu bandeja
Cuatro pasos. Los dos primeros son iguales para todos los clientes, el resto son propios de este.
Crea una cuenta gratis y conecta un buzón
Regístrate en mcpemails.com, sin tarjeta, y luego ve a Dashboard, Inboxes, Connect Inbox. Outlook y Microsoft 365 se conectan con el inicio de sesión de Microsoft; Gmail, iCloud, Fastmail, Yahoo, Zoho y Yandex requieren una contraseña de aplicación; cualquier otro se conecta por IMAP y SMTP estándar. El plan gratuito incluye una bandeja, para siempre.
Abre los ajustes MCP de Cascade
Abre los ajustes MCP de Cascade, o edita ~/.codeium/windsurf/mcp_config.json directamente.
Añade el servidor
Añade la entrada de abajo. Aquí el nombre del campo es serverUrl, no url.
Actualiza y autoriza
Actualiza los servidores MCP en Cascade y autoriza con MCPEmails cuando se te pida. Aprueba los permisos que quieres que tenga Cascade.
{
"mcpServers": {
"mcpemails": {
"serverUrl": "https://mcpemails.com/api/mcp"
}
}
}Documentación oficial de Windsurf sobre servidores MCP remotos: https://docs.windsurf.com/windsurf/cascade/mcp
¿Prefieres una guía completa? Correo para agentes de IA en Cursor, Cline y VS Code
¿No sabes qué buzón conectar primero? Consulta la tabla de compatibilidad de proveedores
En qué suele tropezar la gente con Windsurf
El campo es serverUrl, y url falla en silencio
Es el error de configuración más común en Windsurf, y es totalmente comprensible: Cursor, Zed y VS Code leen url, así que un fragmento copiado de cualquiera de ellos parece correcto. Windsurf lee serverUrl. Con la clave equivocada, la entrada se analiza bien, el servidor aparece en la lista y nunca llega ninguna herramienta.
Cascade necesita que lo actualices, no vigila el archivo
Editar mcp_config.json en un editor no hace que Cascade lo recargue. Usa la acción de actualizar del panel MCP después de cualquier cambio. Una entrada correcta que no se ha actualizado parece exactamente igual que una rota.
Decide desde el principio si Cascade debe poder enviar
Eso se decide en la pantalla de consentimiento. Los permisos de lectura y borradores encajan con un asistente de editor, y dejar fuera send:email significa que ningún prompt, ningún jailbreak y ningún bucle confuso puede enviar correo desde esta conexión. La aprobación humana en el panel es la doble protección si sí quieres enviar.
Límites que conviene conocer
- Las solicitudes están limitadas a 100 por minuto, 1.000 por hora y 10.000 al día por clave, además del tope de acciones facturables de tu plan.
- El servidor funciona solo por petición y respuesta. No hay webhooks ni eventos iniciados por el servidor, así que el correo nuevo nunca despierta a tu agente por sí solo. Para reaccionar al correo entrante, consulta periódicamente según un horario.
- El correo se obtiene en vivo de tu proveedor en cada llamada y nunca se almacena. Solo se guarda el token OAuth o la contraseña de aplicación cifrados, así que un token revocado o un cambio de contraseña del buzón corta el acceso de inmediato.
Windsurf y el correo: preguntas resueltas
¿Cómo conecto el correo a Windsurf?
Añade una entrada en mcpServers de ~/.codeium/windsurf/mcp_config.json con serverUrl igual a https://mcpemails.com/api/mcp, actualiza los servidores MCP en Cascade y autoriza cuando se te pida. A partir de ahí Cascade tiene herramientas para leer, buscar, enviar, responder, reenviar, organizar y programar correo.
¿Por qué mi configuración de Windsurf no funciona si el mismo JSON funciona en Cursor?
Casi siempre es el nombre del campo. Cursor lee url, Windsurf lee serverUrl. El resto de la entrada es idéntico, y precisamente por eso el error sobrevive a una lectura atenta.
¿Necesito una clave de API para Windsurf?
No. Windsurf ejecuta el flujo OAuth contra este servidor, así que el archivo de configuración solo contiene una URL pública. Una clave de API bearer sigue disponible para uso con scripts o sin interfaz gráfica.
¿Qué buzones puede alcanzar Windsurf de esta forma?
Outlook.com y Microsoft 365 con el inicio de sesión de Microsoft, donde una cuenta del trabajo puede necesitar que un administrador de TI apruebe la aplicación una vez; Gmail, iCloud, Fastmail, Yahoo, Zoho y Yandex con una contraseña de aplicación; y cualquier otro buzón que hable IMAP y SMTP en los puertos estándar. El cliente los ve todos a través de la misma conexión: tu agente llama primero a inbox_list para descubrir cada buzón conectado y su id, así que no hay UUID que pegar en ningún sitio.
¿Puede Cascade enviar correo sin que yo lo vea?
Solo si tú lo permites. El envío depende del permiso send:email, así que una clave o un token sin ese permiso no puede enviar nada. Además, el propietario de una bandeja puede exigir aprobación humana en el panel, que retiene cada envío, respuesta, reenvío, envío de borrador y envío programado hasta que una persona lo libera.
¿Se guarda mi correo en los servidores de MCPEmails?
No. Cada mensaje se obtiene en vivo de tu proveedor para la solicitud que lo pidió y se entrega directamente a tu cliente. Solo se guarda el token OAuth o la contraseña de aplicación cifrados, para que las llamadas futuras puedan autenticarse. Eliminar la bandeja en el panel, o revocar el acceso en tu proveedor, corta la conexión al instante.
Dale a Cascade una bandeja real
Una entrada de configuración, un inicio de sesión. Una bandeja gratis para siempre, sin tarjeta.