# Servidor MCP de mensajería ManyMoney
## Resumen
El servidor MCP de mensajería ManyMoney es la contraparte de envío del [servidor MCP de IA ManyMoney](/es/product/pushwoosh-ai/manymoney-mcp-server/). 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)](https://modelcontextprotocol.io/) 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](#connect-the-mcp-server) 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](#what-to-include-in-your-request) 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](/es/developer/api-reference/api-identifiers/#message-code). Úsalo en el [Historial de mensajes](/es/product/statistics-and-analytics/message-history/) 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](/es/product/audience-data-and-segmentation/segmentation/).
- **Alcanzar usuarios específicos:** enviar a uno o más [ID de usuario](/es/developer/api-reference/api-identifiers/#user-id) 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](/es/developer/api-reference/api-identifiers/#campaign-code) 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](#example-prompts) en [Enviar mensajes desde tu cliente de IA](#send-messages-from-your-ai-client) 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
### 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](/es/developer/api-reference/api-access-token/#server-api-token).
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](/es/developer/api-reference/api-access-token/#edit-token) 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
```
Agrega el servidor a tu archivo de configuración de Claude Desktop (`claude_desktop_config.json`):
```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.
Agrega el servidor a tu archivo `.cursor/mcp.json` (o el archivo equivalente en Windsurf):
```json
{
"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.
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.
### 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](/es/developer/api-reference/api-identifiers/#application-code) (`XXXXX-XXXXX`) |
| `platforms` | [ID de canal](/es/developer/api-reference/messaging-api-v2/notify/#platform-enum) para enviar (push, correo electrónico, SMS, etc.) |
| `target` | [Código de segmento](/es/developer/api-reference/api-identifiers/#segment--filter-code), [expresión de segmento](/es/developer/api-reference/segmentation-filters-api/segmentation-language/), o una lista explícita de [usuario](/es/developer/pushwoosh-knowledge-hub/users-userids/), [hwid](/es/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid) o [token de push](/es/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token) ([segmentación transaccional](/es/developer/api-reference/messaging-api-v2/notify/#notifytransactional)) |
| `message_payload` | **Push:** título y cuerpo, o un [preset de push](/es/product/content/push-presets/), con sonido, insignia y acción de apertura opcionales
**Correo electrónico:** asunto, cuerpo o [plantilla](/es/product/content/email-content/), 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](/es/developer/api-reference/api-identifiers/#campaign-code) para atribuir el mensaje |
| `frequency_capping` | El [límite de frecuencia](/es/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping) 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`](/es/developer/api-reference/messaging-api-v2/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](/es/product/audience-data-and-segmentation/segmentation/) o una [expresión de segmento](/es/developer/api-reference/segmentation-filters-api/segmentation-language/). Admite [programación](/es/product/how-to-guides/how-to-schedule-a-message/), [límite de frecuencia](/es/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping), [tasa de envío](/es/product/messaging-channels/global-frequency-capping/#set-send-rate-limits) y [grupos de control](/es/product/audience-data-and-segmentation/global-control-group/). |
| **Transaccional** | Enviar a una lista específica de [usuarios](/es/developer/pushwoosh-knowledge-hub/users-userids/), [hwids](/es/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid) o [tokens de push](/es/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token). 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](/es/developer/api-reference/api-access-token/#server-api-token) separado en **Configuración → Acceso a la API** y [limítalo a las aplicaciones](/es/developer/api-reference/api-access-token/#edit-token) 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](/es/developer/api-reference/messaging-api-v2/notify/#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](/es/product/first-steps/start-with-your-project/test-your-integration/test-devices/). 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](/es/developer/api-reference/api-identifiers/#campaign-code) 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