Servidor MCP de Mensagens ManyMoney

Aviso de recurso Beta

O servidor MCP de Mensagens ManyMoney está em beta. O endpoint e as opções de autenticação podem mudar.

Visão geral

O servidor MCP de Mensagens ManyMoney é a contraparte de envio do servidor MCP de IA ManyMoney. 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) 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 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 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. Use-o no Histórico de Mensagens 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.
• Alcançar usuários específicos: enviar para um ou mais IDs de usuário 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 usar. A entrega e o engajamento para esse envio aparecem sob essa campanha no Painel de Controle.

Veja exemplos de solicitações de chat em Enviar mensagens do seu cliente de IA 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

Necessária assistência de um desenvolvedor

Você pode precisar da ajuda de sua equipe de desenvolvimento para conectar o servidor MCP de Mensagens ao seu cliente de IA. Por favor, compartilhe este guia com eles.

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.

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 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

Claude Desktop

Adicione o servidor ao seu arquivo de configuração do Claude Desktop (claude_desktop_config.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.

Cursor / Windsurf

Adicione o servidor ao seu .cursor/mcp.json (ou o arquivo equivalente no Windsurf):

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

Recarregue o editor após salvar.

Other clients

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.

Revise antes de aprovar

As mensagens enviadas através do servidor MCP de Mensagens são entregas reais. Elas são enviadas assim que você aprova uma ação de envio imediato, ou no horário agendado que você definiu. Antes de aprovar uma ação no seu cliente de IA, verifique a aplicação, o público, o canal, o texto da mensagem e o agendamento. Tenha um cuidado especial quando o alvo for um segmento. O agente não pode cancelar um envio depois que você o aprova. Mensagens agendadas podem ser canceladas no Histórico de Mensagens no Painel de Controle da Pushwoosh, mas apenas antes do início do envio.

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 (XXXXX-XXXXX)
platforms	IDs de canal para enviar (push, e-mail, SMS, etc.)
target	Código do segmento, expressão de segmento, ou uma lista explícita de usuário, hwid, ou token de push (direcionamento transacional)
message_payload	Push: título e corpo, ou um preset de push, com som, badge e ação de abertura opcionais E-mail: assunto, corpo ou modelo, 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 para atribuir a mensagem
frequency_capping	Limitação de frequência 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 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 ou expressão de segmento. Suporta agendamento, limitação de frequência, taxa de envio e grupos de controle.
Transacional	Enviar para uma lista específica de usuários, hwids, ou tokens de push. 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 separado em Configurações → Acesso à API e limite-o às aplicações 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.
• 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. 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 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

Servidor MCP de IA ManyMoney: planeje e crie campanhas

IA ManyMoney dentro do Painel de Controle

Visão geral das ferramentas de IA