Servidor MCP de mensajería ManyMoney

Aviso de función beta

El servidor MCP de mensajería ManyMoney está en 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, más Huawei, Baidu y Amazon Fire
Push — Web	Push web en Chrome, Firefox, Safari y Edge (Windows)
Correo electrónico	Cuerpo HTML, plantillas, archivos adjuntos, De/Responder a 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.
• Alcanzar un segmento: transmitir a todos en un segmento.
• Alcanzar usuarios específicos: enviar a uno o más ID de usuario después de un evento (actualización de pedido, restablecimiento de contraseña y similares).
• Programar entrega: enviar ahora, a una hora establecida, después de un retraso o en la zona horaria local de cada usuario.
• Personalizar contenido: rellenar marcadores de posición de plantilla como {{first_name}} o {{promo_code}} por destinatario.
• Contar envíos para una campaña: dile al agente qué código de campaña usar. La entrega y la interacción para ese envío aparecen 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 Configuración → Acceso a la API, haz clic en Generar nuevo token, selecciona Servidor 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://messaging-api.svc-nue.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://messaging-api.svc-nue.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://messaging-api.svc-nue.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

Recarga el editor después de guardar.

Other clients

Apunta tu cliente a https://messaging-api.svc-nue.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 un lenguaje sencillo (por ejemplo, “app XXXXX-XXXXX”, “segmento abandono-carrito”).

Qué incluir	Descripción
application	Código de aplicación (XXXXX-XXXXX)
platforms	ID de canal para enviar (push, correo electrónico, 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 mensajería: 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 para atribuir el mensaje
frequency_capping	El límite de frecuencia limita la frecuencia con la que cada usuario recibe un mensaje dentro de un período 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 una expresión de segmento. Admite programación, límite de frecuencia, 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.”

Programar 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 dos 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 agente típicas — usa un token de API de servidor en su lugar.

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

Consejos y mejores prácticas

• Revisa siempre 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 Configuración → Acceso a la API 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 Configuración → Dispositivos de prueba. 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 solicite 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