Servidor MCP de Mensagens ManyMoney

Visão geral

O servidor MCP de Mensagens ManyMoney é a contraparte de envio do servidor MCP ManyMoney AI. Onde o servidor MCP ManyMoney AI 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 mais — sob demanda, a partir de instruções em linguagem natural.

Conecte-o a qualquer cliente Model Context Protocol (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 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 lhe enviar uma mensagem 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

Conecte o servidor MCP de Mensagens ao seu cliente de IA uma vez (veja Conectar o servidor MCP abaixo).
No seu cliente de IA, abra um novo chat e descreva o envio em linguagem simples. Inclua o aplicativo, 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 construir solicitações de API ou JSON por si mesmo.
Quando o agente estiver pronto para enviar, revise os detalhes e aprove a ação no seu cliente.
Após você aprovar, o 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 a entrega: enviar agora, em um horário definido, após um atraso ou no fuso horário local de cada usuário.
Personalizar o conteúdo: preencher placeholders de modelo como {{first_name}} ou {{promo_code}} por destinatário.
Contar 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 sobre a 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 com um token de API do Servidor Pushwoosh.

No Painel de Controle do 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 aos aplicativos pelos quais você deseja que o agente envie.

Passo 2. Adicione o servidor ao seu cliente de IA

Use o seguinte endpoint:

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

Adicione o servidor ao seu arquivo de configuração do Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://manymoney-messaging.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):

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

Recarregue o editor após salvar.

Aponte seu cliente para https://manymoney-messaging.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:

“No aplicativo XXXXX-XXXXX, envie um push para meus dispositivos de teste com o título ‘Olá do agente’ e o 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 и retorna um código de mensagem 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 do aplicativo (`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 uma predefinição 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 placeholders como `{{first_name}}` ou `{{promo_code}}`
`campaign`	Código de campanha para atribuir a mensagem
`frequency_capping`	Limite 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, limite 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:

No aplicativo 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ão 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:

No aplicativo XXXXX-XXXXX, envie um e-mail para o usuário uid-123 usando o modelo de e-mail welcome-flow-v2 com o placeholder {{first_name}} definido como Alex.

SMS para um segmento:

No aplicativo 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:

No aplicativo XXXXX-XXXXX, envie uma mensagem do 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 três 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 Pushwoosh OAuth2 SSO 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.
OAuth 2.0 (registro de cliente dinâmico)	Para clientes MCP que implementam a especificação de autorização MCP em vez de um cabeçalho estático. O escopo espelha a sessão SSO do Pushwoosh do usuário logado (não limitado a aplicativos específicos), os tokens de acesso são válidos por 7 dias e os tokens de atualização por 30 dias. Veja Fluxo de login OAuth 2.0 abaixo.

Solicitações com um token ausente ou inválido são rejeitadas com HTTP 401.

Clientes que suportam o fluxo OAuth da especificação MCP (por exemplo, o login de servidor remoto do Claude Desktop) não precisam de um token colado manualmente — o cliente descobre o servidor de autorização, se registra e leva o usuário através de um login SSO do Pushwoosh e uma etapa de consentimento:

Descoberta. O cliente busca /.well-known/oauth-protected-resource e /.well-known/oauth-authorization-server no host do endpoint MCP para encontrar os endpoints authorize, token e register.
Registro de cliente dinâmico (DCR). O cliente faz um POST para /register para obter um client_id sem qualquer configuração manual no Painel de Controle.
Autorização com PKCE. O cliente envia o usuário para /authorize com um code_challenge usando code_challenge_method=S256. O PKCE é obrigatório — o endpoint de token não autentica o cliente por nenhum outro meio, então uma solicitação sem um desafio S256 válido é rejeitada.
Login SSO do Pushwoosh e consentimento. O usuário faz login através do SSO do Pushwoosh e, em seguida, confirma o acesso do cliente na tela /oauth/consent antes que um código de autorização seja emitido.
Troca de token. O cliente troca o código e o verificador PKCE em /token por um token de acesso, e então o envia como Authorization: Bearer nas solicitações MCP.

Você não precisa configurar nada disso — só importa se você estiver solucionando problemas de um cliente que implementa o fluxo de maneira diferente do esperado.

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 aos aplicativos dos quais o agente deve enviar. Dessa forma, o acesso do agente permanece 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: “No aplicativo XXXXX-XXXXX, envie um push para meus dispositivos de teste com o título ‘Teste’ e o corpo ‘Verifique o texto aqui.’” Isso roteia a mensagem apenas para os dispositivos que você adicionou em Configurações → Dispositivos de Teste. Quando a pré-visualização parecer correta, peça o segmento ou público real.
Nomeie uma campanha na 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 do 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 placeholders para personalização. Passe valores para placeholders como {{first_name}} ou {{promo_code}} na sua solicitação de chat, em vez de criar mensagens separadas para cada usuário.

Relacionados

Servidor MCP ManyMoney AI: planeje e crie campanhas

ManyMoney AI dentro do Painel de Controle

Visão geral das ferramentas de IA