# Servidor MCP de Mensagens ManyMoney
## Visão geral
O servidor MCP de Mensagens ManyMoney é a contraparte de envio do [servidor MCP de IA ManyMoney](/pt/product/pushwoosh-ai/manymoney-mcp-server/). Onde o servidor MCP de IA ManyMoney ajuda você a planejar e construir campanhas, o servidor MCP de Mensagens dá ao seu agente de IA o poder de **realmente entregar mensagens** — notificações push, e-mail, SMS, WhatsApp, Telegram, LINE, Kakao e muito mais — sob demanda, a partir de instruções em linguagem natural.
Conecte-o a qualquer cliente do [Protocolo de Contexto de Modelo (MCP)](https://modelcontextprotocol.io/) e seu agente pode disparar um push para um segmento ou enviar um e-mail personalizado para um usuário específico, tudo a partir de uma única solicitação em linguagem natural.
### Canais suportados
| Canal | Tipos de mensagem |
| --- | --- |
| **Push — iOS** | Notificações padrão, silenciosas e críticas, pushes VoIP e Live Activities |
| **Push — Android** | Pushes padrão, mais Huawei, Baidu e Amazon Fire |
| **Push — Web** | Push da web no Chrome, Firefox, Safari e Edge (Windows) |
| **E-mail** | Corpo em HTML, modelos, anexos, De/Responder para personalizados |
| **SMS** | Mensagens de texto através da plataforma de SMS configurada na sua conta |
| **WhatsApp** | Modelos aprovados pela Meta para envios de saída; texto de forma livre apenas dentro da janela de 24 horas após um usuário enviar uma mensagem para você primeiro |
| **Telegram** | Mensagens de texto com variáveis de conteúdo |
| **LINE** | Mensagens de conteúdo e de modelo |
| **Kakao** | Mensagens de conteúdo e de modelo |
### Como funciona
1. Conecte o servidor MCP de Mensagens ao seu cliente de IA uma vez (veja [Conectar o servidor MCP](#connect-the-mcp-server) abaixo).
2. No seu cliente de IA, abra um novo chat e descreva o envio em linguagem simples. Inclua a aplicação, o público (segmento ou usuários específicos), o texto da mensagem e quando enviar, se não for imediato. Veja [o que incluir na sua solicitação](#what-to-include-in-your-request) abaixo. Você não precisa criar solicitações de API ou JSON por conta própria.
3. Quando o agente estiver pronto para enviar, revise os detalhes e aprove a ação no seu cliente.
4. Depois de aprovar, a Pushwoosh envia a mensagem e retorna um [código de mensagem](/pt/developer/api-reference/api-identifiers/#message-code). Use-o no [Histórico de Mensagens](/pt/product/statistics-and-analytics/message-history/) para encontrar o envio e rastrear a entrega e as estatísticas.
### O que seu agente pode fazer
Após a configuração, o agente pode:
- **Enviar em qualquer canal suportado:** push (iOS, Android, Web), e-mail, SMS, WhatsApp, Telegram, LINE ou Kakao.
- **Alcançar um segmento:** transmitir para todos em um [segmento](/pt/product/audience-data-and-segmentation/segmentation/).
- **Alcançar usuários específicos:** enviar para um ou mais [IDs de usuário](/pt/developer/api-reference/api-identifiers/#user-id) após um evento (atualização de pedido, redefinição de senha e similares).
- **Agendar entrega:** enviar agora, em um horário definido, após um atraso ou no fuso horário local de cada usuário.
- **Personalizar conteúdo:** preencher espaços reservados de modelo como `{{first_name}}` ou `{{promo_code}}` por destinatário.
- **Contabilizar envios para uma campanha:** diga ao agente qual [código de campanha](/pt/developer/api-reference/api-identifiers/#campaign-code) usar. A entrega e o engajamento para esse envio aparecem sob essa campanha no Painel de Controle.
Veja [exemplos de solicitações de chat](#example-prompts) em [Enviar mensagens do seu cliente de IA](#send-messages-from-your-ai-client) abaixo.
### Clientes de IA compatíveis
O servidor MCP de Mensagens funciona com qualquer cliente compatível com MCP, incluindo:
- **Claude Desktop** da Anthropic
- **Cursor** e **Windsurf**
- **Cline** e **Continue**
- **Agentes personalizados** construídos na especificação MCP
## Conectar o servidor MCP
### Passo 1. Certifique-se de que você tem uma conta Pushwoosh e um token de API
O servidor MCP de Mensagens autentica-se com um [token de API do Servidor Pushwoosh](/pt/developer/api-reference/api-access-token/#server-api-token).
No Painel de Controle da Pushwoosh, vá para **Configurações → Acesso à API**, clique em **Gerar Novo Token**, selecione **Servidor** e salve o token. Você o adicionará à configuração do cliente no próximo passo.
O token herda as permissões da sua conta. [Limite-o às aplicações](/pt/developer/api-reference/api-access-token/#edit-token) pelas quais você deseja que o agente envie.
### Passo 2. Adicione o servidor ao seu cliente de IA
Use o seguinte endpoint:
```
https://messaging-api.svc-nue.pushwoosh.com/mcp
```
Adicione o servidor ao seu arquivo de configuração do 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"
}
}
}
}
```
Reinicie o Claude Desktop após salvar.
Adicione o servidor ao seu `.cursor/mcp.json` (ou o arquivo equivalente no Windsurf):
```json
{
"mcpServers": {
"pushwoosh-messaging": {
"url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
"headers": {
"Authorization": "Token YOUR_API_TOKEN"
}
}
}
}
```
Recarregue o editor após salvar.
Aponte seu cliente para `https://messaging-api.svc-nue.pushwoosh.com/mcp` e defina o cabeçalho de solicitação `Authorization: Token YOUR_API_TOKEN`. Consulte a documentação do seu cliente para adicionar um servidor MCP remoto com cabeçalhos personalizados.
### Passo 3. Experimente
Abra um novo chat no seu cliente de IA e peça algo concreto:
> *"Na aplicação `XXXXX-XXXXX`, envie um push para meus dispositivos de teste com o título 'Olá do agente' e corpo 'Esta é uma mensagem de teste.'"*
Antes de aprovar a ação do agente, confirme o público e o conteúdo da mensagem.
Se a conexão funcionar, o agente envia a mensagem e retorna um código de mensagem da Pushwoosh, como `PW-12345-67890`.
## Enviar mensagens do seu cliente de IA
O agente envia uma mensagem por solicitação.
### O que incluir na sua solicitação
Descreva os detalhes abaixo no seu chat para que o agente saiba o que enviar, quem deve receber e quando. Use linguagem simples (por exemplo, "app XXXXX-XXXXX", "segmento cart-abandonment").
| O que incluir | Descrição |
| --- | --- |
| `application` | [Código da aplicação](/pt/developer/api-reference/api-identifiers/#application-code) (`XXXXX-XXXXX`) |
| `platforms` | [IDs de canal](/pt/developer/api-reference/messaging-api-v2/notify/#platform-enum) para enviar (push, e-mail, SMS, etc.) |
| `target` | [Código do segmento](/pt/developer/api-reference/api-identifiers/#segment--filter-code), [expressão de segmento](/pt/developer/api-reference/segmentation-filters-api/segmentation-language/), ou uma lista explícita de [usuário](/pt/developer/pushwoosh-knowledge-hub/users-userids/), [hwid](/pt/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid), ou [token de push](/pt/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token) ([direcionamento transacional](/pt/developer/api-reference/messaging-api-v2/notify/#notifytransactional)) |
| `message_payload` | **Push:** título e corpo, ou um [preset de push](/pt/product/content/push-presets/), com som, badge e ação de abertura opcionais
**E-mail:** assunto, corpo ou [modelo](/pt/product/content/email-content/), anexos
**SMS e mensageiros:** texto ou modelo aprovado |
| `schedule` | Enviar em um horário específico, após um atraso, ou seguir os fusos horários do usuário |
| `dynamic_content_placeholders` | Valores para espaços reservados como `{{first_name}}` ou `{{promo_code}}` |
| `campaign` | [Código da campanha](/pt/developer/api-reference/api-identifiers/#campaign-code) para atribuir a mensagem |
| `frequency_capping` | [Limitação de frequência](/pt/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping) limita a frequência com que cada usuário recebe uma mensagem dentro de uma janela de tempo |
### Como o agente envia uma mensagem
O agente usa a ferramenta [`Notify`](/pt/developer/api-reference/messaging-api-v2/notify/) para criar e enviar uma mensagem. Suporta dois modos de direcionamento:
| Modo | Quando usar |
| --- | --- |
| **Segmento** | Transmitir para todos os usuários que correspondem a um [segmento](/pt/product/audience-data-and-segmentation/segmentation/) ou [expressão de segmento](/pt/developer/api-reference/segmentation-filters-api/segmentation-language/). Suporta [agendamento](/pt/product/how-to-guides/how-to-schedule-a-message/), [limitação de frequência](/pt/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping), [taxa de envio](/pt/product/messaging-channels/global-frequency-capping/#set-send-rate-limits) e [grupos de controle](/pt/product/audience-data-and-segmentation/global-control-group/). |
| **Transacional** | Enviar para uma lista específica de [usuários](/pt/developer/pushwoosh-knowledge-hub/users-userids/), [hwids](/pt/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid), ou [tokens de push](/pt/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token). Ideal para mensagens acionadas ou personalizadas. |
#### Exemplos de prompts
**Push para um segmento:**
> Na aplicação `XXXXX-XXXXX`, envie um push para o segmento `cart-abandonment` no iOS e Android.
>
> Título: "Ainda pensando?" Corpo: "Seu carrinho está esperando, aqui está 10% de desconto."
>
> Agende para as 15h no fuso horário local de cada usuário. Use o código de campanha `spring-promo`.
**E-mail para um usuário:**
> Na aplicação `XXXXX-XXXXX`, envie um e-mail para o usuário `uid-123` usando o modelo de e-mail `welcome-flow-v2` com o espaço reservado `{{first_name}}` definido como Alex.
**SMS para um segmento:**
> Na aplicação `XXXXX-XXXXX`, envie um SMS para o segmento `vip-users` com o corpo "Sua oferta exclusiva termina hoje à noite." Envie agora.
**Telegram para um segmento:**
> Na aplicação `XXXXX-XXXXX`, envie uma mensagem de Telegram para o segmento `subscribers-monthly` com o corpo "Olá `{{first_name}}`, sua fatura de maio está pronta — baixe-a da sua conta." Agende para amanhã às 10:00 AM UTC.
## Autenticação
O servidor MCP de Mensagens suporta dois métodos de autenticação:
| Método | Como usar |
| --- | --- |
| **Token de API** | Adicione `Authorization: Token YOUR_API_TOKEN` a cada solicitação. Recomendado para agentes e pipelines automatizados. |
| **Token de sessão (SSO)** | Adicione `Authorization: Bearer YOUR_SSO_TOKEN`. Para integrações programáticas que usam o SSO OAuth2 da Pushwoosh para agir sob uma sessão de usuário específica. Não é necessário para configurações típicas de agente — use um token de API do Servidor em vez disso. |
Solicitações com um token ausente ou inválido são rejeitadas com HTTP 401.
## Dicas e melhores práticas
- **Sempre revise cada envio cuidadosamente antes de aprová-lo.** Estas são entregas reais, e elas são enviadas quando você aprova ou no horário agendado. Certifique-se de que o aplicativo, o público, o canal e o texto da mensagem no cliente correspondem ao que você pretendia.
- **Use um token de API do Servidor dedicado para o agente.** Crie um [token de API do Servidor](/pt/developer/api-reference/api-access-token/#server-api-token) separado em **Configurações → Acesso à API** e [limite-o às aplicações](/pt/developer/api-reference/api-access-token/#edit-token) das quais o agente deve enviar. Dessa forma, o acesso do agente fica restrito apenas a esses aplicativos.
- **Use o direcionamento transacional para mensagens acionadas.** Ao enviar para um ID de usuário conhecido após um evento (pedido enviado, redefinição de senha), use o modo `transactional` com `users: [userId]`. Não crie um segmento de uma pessoa para o mesmo envio. Veja [NotifyTransactional](/pt/developer/api-reference/messaging-api-v2/notify/#notifytransactional).
- **Teste em dispositivos de teste antes de um grande envio.** Antes de enviar para um segmento real, peça ao agente para enviar primeiro para seus [dispositivos de teste registrados](/pt/product/first-steps/start-with-your-project/test-your-integration/test-devices/). Por exemplo: *"Na aplicação `XXXXX-XXXXX`, envie um push para meus dispositivos de teste com o título 'Teste' e corpo 'Verifique o texto aqui.'"* Isso direciona a mensagem apenas para os dispositivos que você adicionou em **Configurações → Dispositivos de Teste**. Quando a pré-visualização parecer correta, peça pelo segmento ou público real.
- **Nomeie uma campanha em sua solicitação.** Inclua um [código de campanha](/pt/developer/api-reference/api-identifiers/#campaign-code) no chat (por exemplo, `spring-promo`) para que os resultados apareçam sob a campanha correta no Painel de Controle da Pushwoosh.
- **Confirme antes de transmitir.** Configure seu cliente de IA para pedir confirmação explícita antes de aprovar qualquer chamada de ferramenta que vise um segmento. Uma transmissão para um grande público é irreversível.
- **Use espaços reservados para personalização.** Passe valores para espaços reservados como `{{first_name}}` ou `{{promo_code}}` em sua solicitação de chat, em vez de criar mensagens separadas para cada usuário.
## Relacionados