Servidor MCP de Mensajería ManyMoney

Aviso de función Beta

El servidor MCP de Mensajería ManyMoney está en fase beta. El endpoint y las opciones de autenticación pueden cambiar.

Resumen

El servidor MCP de Mensajería ManyMoney es la contraparte de envío del servidor MCP de IA ManyMoney. Mientras que el servidor MCP de IA ManyMoney te ayuda a planificar y construir campañas, el servidor MCP de Mensajería le da a tu agente de IA el poder de entregar mensajes realmente — notificaciones push, correo electrónico, SMS, WhatsApp, Telegram, LINE, Kakao y más — bajo demanda, a partir de instrucciones en lenguaje natural.

Conéctalo a cualquier cliente del Protocolo de Contexto de Modelo (MCP) y tu agente podrá lanzar un push a un segmento o enviar un correo electrónico personalizado a un usuario específico, todo desde una única solicitud en lenguaje natural.

Canales compatibles

Canal	Tipos de mensaje
Push — iOS	Notificaciones estándar, silenciosas y críticas, pushes VoIP y Live Activities
Push — Android	Pushes estándar, además de Huawei y Amazon Fire
Push — Web	Web push en Chrome, Firefox, Safari y Edge (Windows)
Correo electrónico	Cuerpo HTML, plantillas, archivos adjuntos, From/Reply-To personalizados
SMS	Mensajes de texto a través de la plataforma de SMS configurada en tu cuenta
WhatsApp	Plantillas aprobadas por Meta para envíos salientes; texto de formato libre solo dentro de la ventana de 24 horas después de que un usuario te envíe un mensaje primero
Telegram	Mensajes de texto con variables de contenido
LINE	Mensajes de contenido y plantilla
Kakao	Mensajes de contenido y plantilla

Cómo funciona

1. Conecta el servidor MCP de Mensajería a tu cliente de IA una vez (consulta Conectar el servidor MCP a continuación).
2. En tu cliente de IA, abre un nuevo chat y describe el envío en lenguaje sencillo. Incluye la aplicación, la audiencia (segmento o usuarios específicos), el texto del mensaje y cuándo enviarlo si no es inmediato. Consulta qué incluir en tu solicitud a continuación. No necesitas construir solicitudes de API o JSON tú mismo.
3. Cuando el agente esté listo para enviar, revisa los detalles y aprueba la acción en tu cliente.
4. Después de que apruebes, Pushwoosh envía el mensaje y devuelve un código de mensaje. Úsalo en el Historial de mensajes para encontrar el envío y rastrear la entrega y las estadísticas.

Qué puede hacer tu agente

Después de la configuración, el agente puede:

• Enviar en cualquier canal compatible: push (iOS, Android, Web), correo electrónico, SMS, WhatsApp, Telegram, LINE o Kakao.
• Llegar a un segmento: transmitir a todos en un segmento.
• Llegar a usuarios específicos: enviar a uno o más IDs de usuario después de un evento (actualización de pedido, restablecimiento de contraseña y similares).
• Programar la entrega: enviar ahora, a una hora establecida, después de un retraso o en la zona horaria local de cada usuario.
• Personalizar el contenido: rellenar marcadores de posición de plantillas como {{first_name}} o {{promo_code}} por destinatario.
• Contar los envíos para una campaña: dile al agente qué código de campaña usar. La entrega y el engagement para ese envío aparecerán bajo esa campaña en el Panel de Control.

Consulta ejemplos de prompts de chat en Enviar mensajes desde tu cliente de IA a continuación.

Clientes de IA compatibles

El servidor MCP de Mensajería funciona con cualquier cliente compatible con MCP, incluyendo:

• Claude Desktop de Anthropic
• Cursor y Windsurf
• Cline y Continue
• Agentes personalizados construidos sobre la especificación MCP

Conectar el servidor MCP

Se necesita ayuda de un desarrollador

Es posible que necesites ayuda de tu equipo de desarrollo para conectar el servidor MCP de Mensajería a tu cliente de IA. Por favor, comparte esta guía con ellos.

Paso 1. Asegúrate de tener una cuenta de Pushwoosh y un token de API

El servidor MCP de Mensajería se autentica con un token de API de Servidor de Pushwoosh.

En el Panel de Control de Pushwoosh, ve a Settings → API Access, haz clic en Generate New Token, selecciona Server y guarda el token. Lo agregarás a la configuración del cliente en el siguiente paso.

El token hereda los permisos de tu cuenta. Limítalo a las aplicaciones a través de las cuales quieres que el agente envíe.

Paso 2. Agrega el servidor a tu cliente de IA

Usa el siguiente endpoint:

https://manymoney-messaging.pushwoosh.com/mcp

Claude Desktop

Agrega el servidor a tu archivo de configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://manymoney-messaging.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar.

Cursor / Windsurf

Agrega el servidor a tu archivo .cursor/mcp.json (o el archivo equivalente en Windsurf):

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://manymoney-messaging.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

Recarga el editor después de guardar.

Otros clientes

Apunta tu cliente a https://manymoney-messaging.pushwoosh.com/mcp y establece el encabezado de solicitud Authorization: Token YOUR_API_TOKEN. Consulta la documentación de tu cliente para agregar un servidor MCP remoto con encabezados personalizados.

Paso 3. Pruébalo

Abre un nuevo chat en tu cliente de IA y pregunta algo concreto:

“En la aplicación XXXXX-XXXXX, envía un push a mis dispositivos de prueba con el título ‘Hola desde el agente’ y el cuerpo ‘Este es un mensaje de prueba’.”

Antes de aprobar la acción del agente, confirma la audiencia y el contenido del mensaje.

Si la conexión funciona, el agente envía el mensaje y devuelve un código de mensaje de Pushwoosh como PW-12345-67890.

Enviar mensajes desde tu cliente de IA

El agente envía un mensaje por solicitud.

Revisa antes de aprobar

Los mensajes enviados a través del servidor MCP de Mensajería son entregas reales. Se envían tan pronto como apruebas una acción de envío inmediato, o en el horario que establezcas. Antes de aprobar una acción en tu cliente de IA, verifica la aplicación, la audiencia, el canal, el texto del mensaje y el horario. Ten especial cuidado cuando el objetivo es un segmento. El agente no puede cancelar un envío una vez que lo apruebas. Los mensajes programados se pueden cancelar desde el Historial de mensajes en el Panel de Control de Pushwoosh, pero solo antes de que comience el envío.

Qué incluir en tu solicitud

Describe los detalles a continuación en tu chat para que el agente sepa qué enviar, quién debe recibirlo y cuándo. Usa lenguaje sencillo (por ejemplo, “app XXXXX-XXXXX”, “segmento cart-abandonment”).

Qué incluir	Descripción
application	Código de aplicación (XXXXX-XXXXX)
platforms	IDs de canal a través de los cuales enviar (push, email, SMS, etc.)
target	Código de segmento, expresión de segmento, o una lista explícita de usuario, hwid, o token de push (segmentación transaccional)
message_payload	Push: título y cuerpo, o un preset de push, con sonido, insignia y acción de apertura opcionales Correo electrónico: asunto, cuerpo o plantilla, archivos adjuntos SMS y mensajeros: texto o plantilla aprobada
schedule	Enviar a una hora específica, después de un retraso, o seguir las zonas horarias del usuario
dynamic_content_placeholders	Valores para marcadores de posición como {{first_name}} o {{promo_code}}
campaign	Código de campaña al que atribuir el mensaje
frequency_capping	El frequency capping limita la frecuencia con la que cada usuario recibe un mensaje dentro de una ventana de tiempo

Cómo envía un mensaje el agente

El agente utiliza la herramienta Notify para crear y enviar un mensaje. Admite dos modos de segmentación:

Modo	Cuándo usar
Segmento	Transmitir a todos los usuarios que coincidan con un segmento o expresión de segmento. Admite programación, frequency capping, tasa de envío y grupos de control.
Transaccional	Enviar a una lista específica de usuarios, hwids, o tokens de push. Ideal para mensajes activados o personalizados.

Ejemplos de prompts

Push a un segmento:

En la aplicación XXXXX-XXXXX, envía un push al segmento cart-abandonment en iOS y Android.

Título: “¿Aún lo estás pensando?” Cuerpo: “Tu carrito te está esperando, aquí tienes un 10% de descuento.”

Prográmalo para las 3 PM en la zona horaria local de cada usuario. Usa el código de campaña spring-promo.

Correo electrónico a un usuario:

En la aplicación XXXXX-XXXXX, envía un correo electrónico al usuario uid-123 usando la plantilla de correo electrónico welcome-flow-v2 con el marcador de posición {{first_name}} establecido en Alex.

SMS a un segmento:

En la aplicación XXXXX-XXXXX, envía un SMS al segmento vip-users con el cuerpo “Tu oferta exclusiva termina esta noche.” Enviar ahora.

Telegram a un segmento:

En la aplicación XXXXX-XXXXX, envía un mensaje de Telegram al segmento subscribers-monthly con el cuerpo “Hola {{first_name}}, tu factura de mayo está lista — descárgala desde tu cuenta.” Prográmalo para mañana a las 10:00 AM UTC.

Autenticación

El servidor MCP de Mensajería admite tres métodos de autenticación:

Método	Cómo usar
Token de API	Agrega Authorization: Token YOUR_API_TOKEN a cada solicitud. Recomendado para agentes y pipelines automatizados.
Token de sesión (SSO)	Agrega Authorization: Bearer YOUR_SSO_TOKEN. Para integraciones programáticas que usan Pushwoosh OAuth2 SSO para actuar bajo una sesión de usuario específica. No es necesario para configuraciones de agentes típicas — usa un token de API de Servidor en su lugar.
OAuth 2.0 (registro de cliente dinámico)	Para clientes MCP que implementan la especificación de autorización de MCP en lugar de un encabezado estático. El alcance refleja la sesión de SSO de Pushwoosh del usuario que ha iniciado sesión (no limitado a aplicaciones específicas), los tokens de acceso son válidos por 7 días y los tokens de actualización por 30 días. Consulta el flujo de inicio de sesión OAuth 2.0 a continuación.

Las solicitudes con un token faltante o no válido son rechazadas con HTTP 401.

Flujo de inicio de sesión OAuth 2.0

Los clientes que admiten el flujo OAuth de la especificación MCP (por ejemplo, el inicio de sesión de servidor remoto de Claude Desktop) no necesitan un token pegado manualmente — el cliente descubre el servidor de autorización, se registra y lleva al usuario a través de un inicio de sesión de SSO de Pushwoosh y un paso de consentimiento:

1. Descubrimiento. El cliente obtiene /.well-known/oauth-protected-resource y /.well-known/oauth-authorization-server en el host del endpoint de MCP para encontrar los endpoints authorize, token y register.
2. Registro de cliente dinámico (DCR). El cliente hace un POST a /register para obtener un client_id sin ninguna configuración manual en el Panel de Control.
3. Autorización con PKCE. El cliente envía al usuario a /authorize con un code_challenge usando code_challenge_method=S256. PKCE es obligatorio — el endpoint de token no autentica al cliente por ningún otro medio, por lo que una solicitud sin un desafío S256 válido es rechazada.
4. Inicio de sesión y consentimiento de SSO de Pushwoosh. El usuario inicia sesión a través de SSO de Pushwoosh, luego confirma el acceso del cliente en la pantalla /oauth/consent antes de que se emita un código de autorización.
5. Intercambio de token. El cliente intercambia el código y el verificador PKCE en /token por un token de acceso, luego lo envía como Authorization: Bearer en las solicitudes de MCP.

No necesitas configurar nada de esto tú mismo — solo importa si estás solucionando problemas con un cliente que implementa el flujo de manera diferente a la esperada.

Consejos y mejores prácticas

• Siempre revisa cada envío cuidadosamente antes de aprobarlo. Estas son entregas reales, y se envían cuando apruebas o a la hora programada. Asegúrate de que la aplicación, la audiencia, el canal y el texto del mensaje en el cliente coincidan con lo que pretendías.
• Usa un token de API de Servidor dedicado para el agente. Crea un token de API de Servidor separado en Settings → API Access y limítalo a las aplicaciones desde las que el agente debe enviar. De esa manera, el acceso del agente se mantiene limitado solo a esas aplicaciones.
• Usa la segmentación transaccional para mensajes activados. Cuando envíes a un ID de usuario conocido después de un evento (pedido enviado, restablecimiento de contraseña), usa el modo transactional con users: [userId]. No construyas un segmento de una persona para el mismo envío. Consulta NotifyTransactional.
• Prueba en dispositivos de prueba antes de un envío grande. Antes de enviar a un segmento real, pídele al agente que envíe primero a tus dispositivos de prueba registrados. Por ejemplo: “En la aplicación XXXXX-XXXXX, envía un push a mis dispositivos de prueba con el título ‘Prueba’ y el cuerpo ‘Verificar texto aquí’.” Esto dirige el mensaje solo a los dispositivos que agregaste en Settings → Test Devices. Cuando la vista previa se vea bien, solicita el segmento o la audiencia real.
• Nombra una campaña en tu solicitud. Incluye un código de campaña en el chat (por ejemplo, spring-promo) para que los resultados aparezcan bajo la campaña correcta en el Panel de Control de Pushwoosh.
• Confirma antes de transmitir. Configura tu cliente de IA para que pida una confirmación explícita antes de aprobar cualquier llamada a una herramienta que se dirija a un segmento. Una transmisión a una gran audiencia es irreversible.
• Usa marcadores de posición para la personalización. Pasa valores para marcadores de posición como {{first_name}} o {{promo_code}} en tu solicitud de chat en lugar de construir mensajes separados para cada usuario.

Relacionado

Servidor MCP de IA ManyMoney: planifica y construye campañas

IA ManyMoney dentro del Panel de Control

Resumen de herramientas de IA