[Anúncio] Servidor MCP PushEngage: Execute Campanhas Push do Seu Assistente de IA

O servidor MCP PushEngage está disponível agora em todos os planos PushEngage, incluindo o Gratuito.

É um conector gratuito e de código aberto que permite aos assistentes de IA trabalhar dentro da sua conta PushEngage através do Model Context Protocol (MCP). Peça a Claude, Cursor, Codex ou outro cliente MCP para enviar uma notificação, construir uma audiência, executar um teste A/B ou obter a taxa de cliques do mês passado. O servidor faz isso na sua conta, com os mesmos segmentos, análises e limites de plano do painel.

É construído para as equipas de retenção e ciclo de vida de marcas de eCommerce de mercado médio e empresarial, e para os desenvolvedores e agências que trabalham com elas. Executa-se no seu próprio computador com npx. Inicia sessão através do seu navegador, pelo que não há chaves de API para colar em lado nenhum. Cobre 27 ferramentas em sete áreas da sua conta, desde o envio e agendamento até audiências, relatórios de campanhas, análises e configurações do site.

Obtenha aqui: Servidor MCP PushEngage. A configuração leva três passos, uma vez por computador.

Porquê construímos o servidor MCP PushEngage

Muitas equipas já trabalham dentro de um assistente de IA durante parte do dia. Desenvolvedores e agências frequentemente têm vários servidores MCP conectados. Queríamos que o PushEngage fosse algo que esse assistente pudesse operar, não apenas falar sobre.

Uma frase em vez de cinco ecrãs

O painel ainda é onde constrói tudo manualmente. Mas muitos trabalhos do dia a dia são pequenos: agendar o push de amanhã, verificar quais campanhas acionadas estão ativas, alterar a expiração padrão da notificação. Quando uma frase é mais rápida do que cinco ecrãs, o assistente faz os cliques e diz-lhe o que fez.

Mesma conta, mesmas regras, mesmos limites

Tudo é executado contra os seus sites, segmentos e grupos de audiência reais. Nada é copiado para uma ferramenta separada ou uma segunda lista de subscritores. Os limites do seu plano aplicam-se, e o assistente só pode fazer o que o seu plano e o seu login PushEngage permitem, o mesmo que você pode fazer no painel.

Local e de código aberto, para que possa ler cada linha

O servidor é executado como um processo na sua própria máquina, iniciado pelo seu cliente MCP através de npx. Não existe um ponto final PushEngage MCP hospedado ou remoto. O código tem licença MIT e está no GitHub, publicado no npm como @pushengage/mcp, e listado no Registo MCP oficial como io.github.awesomemotive/pushengage-mcp.

Início de sessão no navegador, sem chaves de API

Você aprova o acesso na página de autorização PushEngage. O assistente nunca vê a sua palavra-passe, e não há chave de API para colar num chat.

Tudo o que o servidor MCP PushEngage pode fazer

O servidor expõe 27 ferramentas em sete áreas da sua conta. Você não chama as ferramentas pelo nome. Descreve o trabalho, e o assistente escolhe a ferramenta. Quando precisa de um detalhe, como qual grupo de audiência pretende, ele pergunta.

Área	O que o seu assistente pode fazer	Bom saber
Envio	Envie agora, agende para mais tarde, agende no fuso horário local de cada subscritor, configure envios recorrentes, guarde rascunhos e execute testes A/B que escolhem o vencedor pela taxa de cliques. Liste notificações passadas, agendadas e rascunhadas com as suas estatísticas.	Os envios vão para todos os subscritores ou para grupos de audiência guardados. O agendamento e os grupos de audiência necessitam de Business ou superior; os testes A/B e os envios por fuso horário necessitam de Premium ou superior.
Audiências	Liste e crie segmentos baseados em URL, grupos de audiência (país, dispositivo, segmento, engagement, datas e atributos personalizados) e atributos de subscritor personalizados.	Até 50 atributos personalizados por site.
Campanhas e automações	Liste campanhas drip, acionadas (abandono de carrinho e navegação, queda de preço e mais) e RSS, mais fluxos de trabalho, com as suas análises.	Apenas leitura. Crie e edite-os no dashboard ou no construtor de Fluxos de Trabalho.
Análise	Totais vitalícios para subscritores, envios, visualizações, cliques e objetivos, mais tendências diárias, semanais ou mensais com taxa de cliques e cancelamentos de subscrição.	Os números de objetivos necessitam de acompanhamento de objetivos, em Premium e superior.
Definições do site	Leia e atualize o nome do site, fuso horário, geolocalização, parâmetros UTM padrão, notificação de fallback, expiração da notificação e definições do service worker.	As atualizações misturam-se sobre os seus valores atuais, pelo que uma alteração parcial deixa o resto inalterado.
Widgets de chat	Liste os seus widgets de chat com o seu estado, canais, dispositivos, horário comercial e segmentação de páginas.	Apenas leitura. O widget de chat suporta 21 canais mais links personalizados.
Conta e sites	Inicie sessão, verifique o estado, termine a sessão, liste os seus sites e escolha aquele em que trabalhar.	Nomeie um site diferente num pedido para trabalhar nele sem mudar.

Aqui está cada ferramenta, área por área, em linguagem clara.

Envio de notificações (3 ferramentas)

• pushengage_send_notification envia ou agenda uma notificação. Uma ferramenta cobre três modos de entrega: enviar agora, um agendamento único (opcionalmente no fuso horário local de cada subscritor) e recorrente. Vai para todos os subscritores, a menos que nomeie grupos de audiência guardados.
• pushengage_send_ab_notification envia uma notificação A/B com duas variantes. Ative o teste A/B inteligente e ele amostra cada variante, escolhe o vencedor pela taxa de cliques após um atraso que definir, e distribui o vencedor para o resto.
• pushengage_list_notifications lista notificações enviadas, agendadas e rascunhos, das mais recentes para as mais antigas. Filtre por estado, intervalo de datas de envio ou etiquetas, e peça análises para obter estatísticas consolidadas de A/B e de envio por fuso horário.

Se quiser rever uma notificação no painel antes de ser enviada, peça ao assistente para a guardar como rascunho primeiro.

Uma nota sobre a cópia: o servidor MCP não escreve as suas notificações por si. Se omitir o título ou a mensagem, o assistente pede-o. Se quiser cópia redigida por IA dentro da PushEngage, isso é AI Copywriter, um add-on pago separado em Business, Premium e Growth, e incluído em Enterprise.

Audiências (6 ferramentas)

• pushengage_list_segments e pushengage_create_segment listam e criam segmentos de subscritores baseados em regras de URL, como todos os que visitam uma página com /sale na URL.
• pushengage_list_audience_groups e pushengage_create_audience_group listam e criam grupos de segmentação guardados construídos a partir de dispositivo, país, segmento, envolvimento, datas e atributos. As ferramentas de envio segmentam estes grupos por nome.
• pushengage_list_attributes e pushengage_create_attribute listam e criam as chaves de atributos de subscritor personalizadas que utiliza em regras de grupo de audiência, até 50 por site.

Para uma análise mais aprofundada, leia como criar segmentos de notificações push com um assistente de IA.

Campanhas e automações (4 ferramentas, apenas leitura)

• pushengage_list_drip_campaigns lista os seus autoresponders de gotejamento. Filtre por estado e peça estatísticas por campanha.
• pushengage_list_triggered_campaigns lista campanhas acionadas: abandono de carrinho, abandono de navegação, queda de preço e mais. Filtre por estado, com análises opcionais.
• pushengage_list_rss_campaigns lista as suas campanhas de push automático RSS. Filtre por estado.
• pushengage_list_workflows lista as suas automações de fluxo de trabalho. Filtre por estado e peça análises para ver quantos subscritores entraram, estão ativos, concluíram ou falharam, mais estatísticas de objetivos.

Estas quatro são ferramentas de relatórios. Campanhas acionadas, gotejamentos, campanhas RSS e fluxos de trabalho são criados e editados no painel e no construtor de Fluxos de Trabalho. O seu assistente pode listá-los e gerar relatórios sobre eles. Para transformar isto numa rotina, veja como auditar gotejamentos e fluxos de trabalho com IA.

Análises (2 ferramentas)

• pushengage_get_analytics_summary retorna totais vitalícios: subscritores, notificações enviadas, visualizações, cliques e contagem e valor de objetivos.
• pushengage_get_analytics_timeseries retorna grupos diários, semanais ou mensais num intervalo de datas, com subscritores, envios, visualizações, cliques, taxa de cliques e cancelamentos de subscrição.

Mais sobre isto em análises de push em linguagem simples com um assistente de IA.

Configurações do site (6 ferramentas)

• pushengage_get_site_details e pushengage_update_site_details leem e alteram o nome do site, URL, fuso horário, geolocalização e o controlo de marca "Powered By PushEngage".
• pushengage_get_campaign_defaults e pushengage_update_campaign_defaults leem e alteram parâmetros UTM, a notificação de fallback, atributos de fallback e a expiração padrão da notificação.
• pushengage_get_service_worker_settings e pushengage_update_service_worker_settings leem e alteram o registo do service worker, suporte a subdiretórios e o caminho do ficheiro do worker.

As atualizações misturam-se sobre os seus valores atuais, portanto "definir minha expiração padrão para 7 dias" altera apenas a expiração. Veja gerir as configurações do site PushEngage com IA.

Widgets de chat (1 ferramenta, apenas leitura)

• pushengage_list_chat_widgets lista o widget no local que apresenta o WhatsApp, Messenger e outros canais. Mostra o estado de cada widget, canais, dispositivos, restrição de horário comercial e segmentação.

Tutorial: verifique os seus widgets de chat a partir de um assistente de IA.

Conta e sites (5 ferramentas)

• pushengage_auth_login abre o seu navegador para o PushEngage e armazena o token quando autoriza.
• pushengage_auth_status mostra se está ligado, qual o site selecionado e quando o seu token expira.
• pushengage_auth_logout apaga o token armazenado localmente.
• pushengage_list_sites lista os sites PushEngage aos quais pode aceder.
• pushengage_select_site define o site atual em que as outras ferramentas atuam. A escolha é lembrada entre reinícios.

Casos de uso por setor

Todos os cenários abaixo usam ferramentas que o servidor MCP tem atualmente. Digite os prompts como estão escritos ou com as suas próprias palavras.

Comércio eletrónico e retalho direto ao consumidor

Para equipas de retenção de comércio eletrónico, o trabalho diário são carrinhos, sessões de navegação, alterações de preço e o calendário de vendas.

1. Verificação matinal de campanhas de recuperação. “Quais campanhas acionadas estão ativas agora e como está cada uma a ter desempenho?” O assistente lista as suas campanhas de abandono de carrinho, abandono de navegação, queda de preço e reposição de stock com as suas análises. Corrige qualquer coisa que pareça incorreta no painel. (Estes tipos de campanha estão no plano Growth.)
2. Envio de promoção que chega à hora local certa. “Crie um segmento chamado Navegadores de Promoção para qualquer pessoa que visite uma página com /sale na URL, depois um grupo de audiência a partir desse segmento.” Depois: “Agende um push de 20% de desconto para o grupo de audiência Navegadores de Promoção para as 19h no fuso horário de cada assinante.” O segmento e o grupo de audiência são criados, e o envio é agendado por fuso horário do assinante. Se não lhe deu o título, mensagem e URL, o assistente pergunta. (Grupos de audiência precisam do plano Business ou superior; envios por fuso horário precisam do plano Premium ou superior.)
3. Teste de título antes de um lançamento. “Teste A/B dois títulos para o lançamento de sexta-feira em 20% dos assinantes, depois envie o vencedor para todos os outros após duas horas.” O assistente executa um teste A/B inteligente e lança o vencedor por taxa de cliques (plano Premium ou superior).

Mercados e retalho multimarcas

Quando gere várias lojas, a parte difícil é acompanhar em qual site está a trabalhar.

1. Verificação de assinantes entre marcas. “Mostre os meus sites PushEngage.” Depois: “Para cada site, dê-me o resumo das análises vitalícias.” Obtém assinantes, envios, visualizações, cliques e objetivos por marca.
2. Trabalhe noutra marca sem mudar. “Mostre as campanhas acionadas ativas no site 12345.” Nomear um site diferente no pedido funciona nele sem alterar a sua seleção atual.
3. Padrões consistentes em todas as lojas. “Mostrar os padrões da campanha para cada um dos meus sites, depois definir a validade padrão da notificação para 7 dias nos que diferem.” O assistente lê os parâmetros UTM de cada site, a notificação de fallback e a validade, depois atualiza apenas a validade.

Editores e media

Os editores vivem de tráfego repetido, pelo que os trabalhos são sobre envios agendados, RSS e monitorização de cancelamentos de subscrição.

1. Um resumo semanal. “Enviar um push de ‘Novidades desta semana’ todas as segundas-feiras às 9h até ao final de dezembro.” O assistente configura um envio recorrente (o agendamento requer o plano Business ou superior). Se não lhe deu a mensagem e o URL, ele pergunta.
2. Verificação de estado do RSS. “Listar as minhas campanhas ativas de push automático de RSS.” Vê as suas campanhas de RSS, filtradas por estado.
3. Identificar a fadiga cedo. “Como é que a taxa de cliques e os cancelamentos de subscrição mudaram semana a semana nos últimos 90 dias?” O assistente recolhe dados semanais para que possa ver se mais envios lhe custam assinantes.

SaaS e serviços online

Para equipas SaaS, o push traz utilizadores de volta ao produto. O servidor MCP torna a segmentação e a geração de relatórios rápidas.

1. Segmentar avaliadores. “Criar um segmento para visitantes de /pricing.” Depois: “Criar um grupo de audiência a partir desse segmento e enviar-lhe uma notificação intitulada ‘Questões sobre planos?’ com ligação para as nossas FAQ de preços.” Envia para grupos de audiência guardados, que requerem o plano Business ou superior.
2. Reativar utilizadores inativos. “Construir um grupo de audiência de assinantes dos EUA que não clicaram numa notificação nos últimos 30 dias, depois enviar-lhes uma oferta de reativação.” Os grupos de audiência requerem o plano Business ou superior.
3. Relatórios de integração. “Quais os fluxos de trabalho ativos e quantos assinantes completaram cada um e atingiram o seu objetivo?” O assistente reporta contagens de entrada, ativas, concluídas e falhadas, mais estatísticas de objetivos.

Educação online

Negócios de cursos funcionam com lembretes e páginas de inscrição.

1. Lembretes de aulas. “Configurar um lembrete recorrente todas as terças e quintas-feiras às 18h até ao final do mês: título ‘Aula ao vivo começa em uma hora’, com ligação para a nossa página da aula.” Se um detalhe estiver em falta, como a mensagem, o assistente pergunta antes de configurar o agendamento. (O agendamento requer o plano Business ou superior.)
2. Segmentar navegadores de cursos. “Criar um segmento chamado Navegadores de cursos para qualquer pessoa que visite uma página com /courses no URL.”
3. Verificar a sequência de boas-vindas. “Listar as minhas campanhas de gotejamento ativas com as suas estatísticas de envio, visualização e cliques.” Obtém números de envio, visualização e cliques para cada campanha de gotejamento.

Organizações sem fins lucrativos e angariação de fundos

Os apelos dependem do momento e de saber quais os envios que atingiram o seu objetivo.

1. Um apelo a uma hora razoável em todo o lado. “Agendar um push intitulado ‘Ajude-nos a atingir o nosso objetivo até à meia-noite’ para amanhã às 10h no fuso horário local de cada assinante.” (Plano Premium ou superior.)
2. Alcance os visitantes da página de doação. “Crie um segmento para visitantes de /donate.” Em seguida, adicione-o a um grupo de público para um apelo direcionado (os grupos de público exigem Business e superior).
3. Relatório sobre metas. “Qual é a minha contagem de metas vitalícias e o valor das metas?” O resumo de análise inclui a contagem e o valor das metas quando o rastreamento de metas está configurado (Premium e superior).

Agências que gerem muitos clientes

As agências beneficiam muito, pois as mesmas verificações repetem-se em todas as contas de clientes.

1. Um assistente, várias contas de clientes. Registe o servidor duas vezes, uma por cliente, cada uma com o seu próprio ficheiro de token (a configuração está abaixo). Em seguida: “Usando pushengage-client-a, dê-me os envios, cliques e taxa de cliques do último mês.” O guia da agência e o guia de configuração multicliente explicam o processo.
2. Auditoria de configurações antes de um lançamento. “Mostre as configurações do service worker e os padrões de campanha para este site.” Confirma o registo, o suporte a subdiretórios, o caminho do worker, os parâmetros UTM e a expiração numa única resposta.
3. Relatórios mensais. “Liste todas as notificações enviadas no último mês com análises, incluindo estatísticas de envio A/B e por fuso horário.” Obtém um ponto de partida para o relatório do cliente.

Como configurar o servidor MCP do PushEngage

Três passos, uma vez por computador: adicione uma entrada ao seu cliente MCP, inicie sessão através do seu navegador e, em seguida, escolha um site. Para uma versão mais lenta, passo a passo, leia o guia de configuração MCP do PushEngage. A referência completa encontra-se na nossa documentação de agentes de IA.

Requisitos

• Uma conta PushEngage (gratuita ou paga) com pelo menos um site.
• Node.js 18 ou mais recente. O seu assistente executa o servidor através de npx.
• Um cliente compatível com MCP que executa servidores locais sobre stdio, como Claude Desktop, Claude Code, Cursor ou qualquer outro.

Não há nada para instalar globalmente. O npx obtém o servidor sempre que o seu assistente o inicia.

Claude Desktop (pacote de um clique)

O caminho mais fácil no Claude Desktop é o Pacote MCP:

1. Descarregue o ficheiro mais recente pushengage-mcp-<version>.mcpb da página de lançamentos do GitHub.
2. Abra-o com o Claude Desktop (clique duas vezes nele ou arraste-o para a janela) e clique em Instalar.

Tudo está incluído, pelo que não há JSON para editar. O diálogo de instalação permite opcionalmente definir o rótulo mostrado no ecrã de autorização do PushEngage e um caminho de ficheiro de token personalizado, o que é útil para executar mais de uma conta.

Claude Desktop (configuração manual)

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou o equivalente na sua plataforma:

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

Reinicie o Claude Desktop. O servidor “pushengage” deverá aparecer na sua lista de ferramentas.

Claude Code

Execute isto no seu terminal:

claude mcp add pushengage -- npx -y @pushengage/mcp

Ou instale o plugin PushEngage Agent Skills (abordado abaixo), que configura o servidor MCP para si automaticamente.

Cursor

Use o botão Adicionar ao Cursor com um clique na documentação. Ou edite ~/.cursor/mcp.json (ou abra a paleta de comandos, depois Configurações do Cursor, depois MCP, depois Adicionar novo servidor MCP global):

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

Codex

O Codex executa servidores MCP locais na CLI do Codex e na extensão IDE. Execute isto no seu terminal:

codex mcp add pushengage -- npx -y @pushengage/mcp

Ou adicione isto a ~/.codex/config.toml:

[mcp_servers.pushengage]
command = "npx"
args = ["-y", "@pushengage/mcp"]

VS Code com Copilot

Use o botão Instalar no VS Code com um clique na documentação. Ou execute MCP: Adicionar Servidor a partir da paleta de comandos, ou adicione isto a .vscode/mcp.json no seu espaço de trabalho:

{
  "servers": {
    "pushengage": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

Gemini CLI

Adicione isto a ~/.gemini/settings.json:

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

Windsurf

Adicione isto a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

Warp

Vá para Configurações, depois IA, depois Servidores MCP, clique em + Adicionar e cole:

{
  "pushengage": {
    "command": "npx",
    "args": ["-y", "@pushengage/mcp"]
  }
}

OpenCode

Adicione isto a opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pushengage": {
      "type": "local",
      "command": ["npx", "-y", "@pushengage/mcp"],
      "enabled": true
    }
  }
}

Devin

Abra Configurações, depois Conexões, depois Servidores MCP, clique em Adicionar um MCP personalizado e cole:

{
  "mcpServers": {
    "pushengage": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"]
    }
  }
}

Qualquer outro cliente MCP stdio

Qualquer cliente que fale MCP sobre stdio funciona. Configure-o para executar:

npx -y @pushengage/mcp

A usar o ChatGPT? O chat do ChatGPT só se conecta a servidores MCP remotos, pelo que não pode executar este. O Codex (CLI ou extensão IDE) executa servidores locais. Use os passos do Codex acima.

Deixe o seu agente configurar-se

A nossa documentação é construída para ser lida por agentes de IA, bem como por pessoas. Cada página de documentação tem uma versão em markdown (adicione .md ao URL). llms.txt indexa todas as páginas, e llms-full.txt contém toda a documentação num único ficheiro. Para integrar um agente de codificação, cole um prompt como este:

Read https://www.pushengage.com/api/ai-agents.md and set up the PushEngage MCP server and Agent Skills in this project.

Primeira execução: iniciar sessão, autorizar, escolher um site

A autenticação acontece no seu navegador, pelo que as suas credenciais nunca tocam no assistente.

1. Pergunte: “Faça o login no PushEngage.” O servidor abre um separador no navegador para a página de autorização do PushEngage.
2. Clique em Autorizar. O separador confirma o sucesso e um token de acesso é guardado no seu computador.
3. Pergunte: “Mostre os meus sites PushEngage,” depois “Use o site 12345” (com o seu próprio ID de site) para escolher o site com que trabalhar. A seleção é lembrada entre reinícios.

A partir daí, todas as ferramentas com âmbito de site agem sobre o seu site atual, a menos que nomeie outro. Descreva o que pretende: um envio, um segmento, um relatório. Se é novo nisto, o guia para iniciantes do PushEngage MCP é uma boa leitura seguinte.

Executar múltiplas contas PushEngage

Agências e equipas com mais de uma conta podem registar o servidor sob dois nomes, cada um com o seu próprio ficheiro de token, para que os tokens não colidam. Duas variáveis de ambiente controlam isto:

Configuração	Padrão	O que faz
~/.pushengage/mcp.json	~/.pushengage/mcp.json	Onde o token é armazenado. Defina um caminho diferente por conta. Deve ser um caminho absoluto, usado exatamente como fornecido, sem expansão de ~.
Claude Desktop	Assistente de IA	O rótulo apresentado no ecrã de autorização como a aplicação solicitante, por exemplo "Claude Desktop".

{
  "mcpServers": {
    "pushengage-client-a": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"],
      "env": {
        "PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-a.json",
        "PE_MCP_CLIENT_NAME": "Claude Desktop (Client A)"
      }
    },
    "pushengage-client-b": {
      "command": "npx",
      "args": ["-y", "@pushengage/mcp"],
      "env": {
        "PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-b.json",
        "PE_MCP_CLIENT_NAME": "Claude Desktop (Client B)"
      }
    }
  }
}

Peça ao assistente para iniciar sessão em cada nome de servidor separadamente. Cada um autoriza a conta PushEngage que escolher no navegador.

Segurança e armazenamento de tokens

• Início de sessão no navegador. Aprova o acesso na página de autorização PushEngage. O assistente nunca vê a sua palavra-passe PushEngage.
• Token mantido fora dos URLs. O painel de controlo entrega o token ao servidor num pedido POST, pelo que nunca aparece num URL, no histórico do seu navegador ou num registo de acesso.
• Armazenado no seu computador. O token é guardado em ~/.pushengage/mcp.json com permissões 0600, legível apenas pela sua conta de utilizador. O PushEngage define a sua expiração, e pushengage_auth_status mostra-o.
• Fácil de revogar. Peça ao assistente para o desconectar, ou termine todas as sessões no PushEngage em Definições, depois Segurança.
• Executa localmente. Nenhum ponto final alojado detém o seu token. O servidor é um processo na sua máquina.

Resolução de Problemas

O servidor não se conecta (“Conexão fechada”). Se npx -y @pushengage/mcp for executado corretamente num terminal, mas o seu cliente mostrar o servidor como desconectado, ou registar algo como MCP error -32000: Connection closed, é quase sempre um problema de PATH. Clientes iniciados a partir do Dock ou do Finder não carregam os ficheiros de inicialização do seu shell, pelo que se o Node veio de um gestor de versões (nvm, fnm, volta), o cliente não consegue encontrar npx. Execute which npx no seu terminal, depois aponte o cliente para esse caminho absoluto e passe a mesma pasta como PATH:

{
  "mcpServers": {
    "pushengage": {
      "command": "/absolute/path/from/which-npx",
      "args": ["-y", "@pushengage/mcp"],
      "env": {
        "PATH": "/absolute/folder/containing/that/npx:/usr/bin:/bin:/usr/sbin:/sbin"
      }
    }
  }
}

Reinicie o cliente após a edição. Se which npx imprimir algo em /usr/local/bin ou /opt/homebrew/bin, a sua instalação Node não é baseada num gestor de versões, pelo que verifique os próprios registos MCP do cliente para o erro real.

AUTH_EXPIRED. O seu token expirou. Peça ao assistente para o iniciar sessão novamente.

NO_SITE_SELECTED. Peça ao assistente para listar os seus sites, depois diga-lhe qual usar antes de executar um pedido com âmbito de site.

O navegador não abre. Isto acontece em sessões sem cabeça ou remotas, como via SSH. O URL de autorização é impresso no terminal que executa o servidor. Abra-o manualmente.

Algo mais. Cada erro que o servidor retorna começa com uma etiqueta [CODE] e uma explicação em linguagem clara. Partilhe isso com o suporte se precisar de ajuda.

Prompts comuns para tentar

Cada um destes corresponde a uma ferramenta que o servidor tem atualmente. Limites de plano aplicam-se conforme indicado.

Enviar e agendar

• “Enviar uma notificação com o título ‘A promoção termina hoje à noite’, mensagem ‘Última chamada, 50% de desconto’, com link para https://example.com/sale.”
• “Agendar isso para as 9 da manhã no fuso horário local de cada assinante.” (Premium e acima)
• “Agendar um push para as 20h de amanhã para o meu grupo de audiência de visitantes do carrinho.” (Business e superior)
• “Configurar um resumo recorrente todas as segundas e quintas-feiras às 8h até o final do mês.” (Business e superior)
• “Enviar um push de ‘Novidades desta semana’ todas as segundas-feiras às 9h até o final de dezembro.” (Business e superior)
• “Guardar isto como um rascunho para que eu possa revê-lo no painel.”
• “Executar um teste A/B de dois títulos e implementar automaticamente o vencedor por taxa de cliques.” (Premium e superior)
• “Mostrar as minhas notificações agendadas.”
• “Listar as notificações que enviei na semana passada, com estatísticas.”
• “Listar as minhas notificações com a tag ‘black-friday’ com estatísticas de envio A/B e de fuso horário.”

Audiências

• “Criar um segmento para visitantes de /pricing.”
• “Crie um segmento chamado Navegadores em Promoção para qualquer pessoa que visite uma página com /sale na URL.”
• “Listar os meus segmentos.”
• “Construir uma audiência de clientes do plano gold nos EUA e enviar apenas para eles.” (Business e superior)
• “Criar um grupo de audiência de subscritores móveis nos EUA.” (Business e superior)
• “Construir um grupo de audiência de subscritores dos EUA que não clicaram numa notificação nos últimos 30 dias.” (Business e superior)
• “Listar os meus grupos de audiência.”
• “Criar um atributo personalizado chamado plan.”
• “Que atributos personalizados tem este site?”

Análise

• “Quantos subscritores tenho e qual foi a minha taxa de cliques nos últimos 30 dias?”
• “Dar-me o resumo de análises vitalícias para este site.”
• “Como é que a taxa de cliques e as não subscrições mudaram semana a semana nos últimos 90 dias?”
• “Mostrar envios, visualizações e cliques diários das últimas duas semanas.”
• “Mostrar crescimento mensal de subscritores este ano.”
• “Qual é a minha contagem e valor de objetivo vitalício?” (requer rastreamento de objetivos, Premium e superior)

Relatórios de campanhas

• “Quais campanhas acionadas estão ativas agora e como está cada uma a ter desempenho?”
• “Que gatilhos de abandono de carrinho tenho?”
• “Listar as minhas campanhas de gotejamento ativas com as suas estatísticas de envio, visualização e cliques.”
• “Listar as minhas campanhas de push automático RSS.”
• “Quais fluxos de trabalho estão ativos e quantos subscritores completaram cada um e atingiram o seu objetivo?”
• “Quais fluxos de trabalho têm entradas falhadas?”

Definições do site

• “Definir a expiração padrão da minha notificação para 7 dias.”
• “Alterar o fuso horário do meu site para Asia/Kolkata e ativar a geolocalização.”
• “Quais são os meus parâmetros UTM padrão?”
• “Definir o utm_source padrão para pushengage.”
• “Mostrar a minha notificação de fallback.”
• “Mostrar as minhas definições do trabalhador de serviço.”
• “O suporte a sub-pastas está ativado para o trabalhador de serviço?”

Widgets de chat

• “Listar os meus widgets de chat.”
• “Quais canais cada widget de chat mostra?”
• “Quais widgets de chat estão restritos ao horário comercial?”
• “A que dispositivos e páginas o meu widget de chat principal se destina?”

Conta

• “Iniciar sessão no PushEngage.”
• “Estou com sessão iniciada e qual site está selecionado?”
• “Quando expira o meu token?”
• “Mostrar os meus sites PushEngage.”
• “Usar o site 12345.”
• “Terminar sessão no PushEngage.”

Para mais informações sobre envios, leia como enviar notificações push de um assistente de IA.

Habilidades de Agente para programadores de aplicações

O servidor MCP gere a sua conta. PushEngage Agent Skills desempenham uma função diferente: ensinam um agente de codificação de IA a integrar e depurar o SDK de notificações push PushEngage em aplicações iOS, Android, Flutter e React Native.

As skills seguem dois padrões abertos, Agent Skills (SKILL.md) e o formato Agent Plugins, pelo que funcionam com qualquer agente que suporte um deles, incluindo Claude Code, Cursor, Codex, Copilot, Windsurf e VS Code. O pacote inclui seis skills:

Skill	O que faz
pushengage	Skill de entrada. Deteta a sua plataforma e encaminha para a correta.
pushengage-ios	Integração e depuração iOS.
pushengage-android	Integração e depuração Android.
pushengage-flutter	Integração e depuração Flutter.
pushengage-react-native	Integração e depuração React Native.
pushengage-debug	Skill de diagnóstico partilhada para integrações com problemas.

Precisa de uma conta PushEngage com uma aplicação configurada no painel de controlo e um agente de codificação de IA que suporte Agent Skills (Claude Code é recomendado).

Claude Code ou Cowork (plugin):

/plugin marketplace add awesomemotive/pushengage-skills
/plugin install pushengage

A instalação do plugin também configura o servidor MCP PushEngage, pelo que o mesmo agente pode gerir a sua conta PushEngage. Na primeira utilização, abre uma janela do navegador para iniciar sessão. Até lá, as ferramentas da conta ficam inativas.

Cursor, Codex, Copilot, Windsurf e outros agentes compatíveis com SKILL.md (skills CLI):

npx skills add awesomemotive/pushengage-skills

Manual: as skills encontram-se em skills/ no repositório. Copie as pastas das skills para o diretório de skills do seu agente ou aponte o seu agente para o repositório. Cada skill ativa-se automaticamente com base no tipo de projeto que deteta.

Após a instalação, basta falar com o seu agente:

• “Ajude-me a integrar o PushEngage nesta aplicação.” executa o fluxo de integração completo.
• “As notificações PushEngage não estão a chegar ao meu iPhone.” executa o fluxo de diagnóstico.
• “Audite a minha configuração PushEngage.” executa a auditoria estática.

O plugin deteta a sua plataforma e transfere para a skill de integração ou depuração correspondente.

Perguntas frequentes

Preciso de ser programador para o usar?

Não. A configuração consiste numa entrada de configuração copiada e um início de sessão no navegador, e depois disso tudo acontece em linguagem clara. Precisa de Node.js 18 ou mais recente no seu computador, porque o seu assistente inicia o servidor com npx. A documentação de configuração tem passos de copiar e colar para cada cliente.

Que assistentes de IA funcionam com ele?

Qualquer cliente MCP que execute servidores locais sobre stdio. A nossa documentação cobre 10 clientes: Claude Desktop, Claude Code, Cursor, Codex, VS Code com Copilot, Gemini CLI, Windsurf, Warp, OpenCode e Devin.

Funciona com o ChatGPT?

Não no chat do ChatGPT. O chat do ChatGPT liga-se a servidores MCP remotos, e o servidor MCP PushEngage é executado apenas como um processo local no seu computador. O Codex da OpenAI, no Codex CLI e na extensão IDE, executa servidores MCP locais, e os passos de configuração do Codex estão acima.

Existe um ponto final MCP alojado ou remoto?

N oun. O servidor é executado localmente no mesmo computador que o seu assistente, iniciado com npx -y @pushengage/mcp. Não há URL para se conectar nem um endpoint PushEngage alojado que guarde o seu token.

Que planos PushEngage incluem o servidor MCP?

Todos os planos, incluindo o Gratuito, sem custos adicionais. O seu plano ainda decide o que o assistente pode fazer, exatamente como no painel de controlo:

• Gratuito: envie campanhas, crie segmentos e pergunte sobre análises para 1 site ou aplicação, com até 200 subscritores e 30 campanhas no total.
• Business: campanhas ilimitadas, agendamento e grupos de audiência.
• Premium: testes A/B que implementam o vencedor, envios no fuso horário de cada subscritor e acompanhamento de objetivos e receitas sobre os quais pode perguntar.
• Growth: campanhas de carrinho, navegação, queda de preço e de volta ao stock que o seu assistente pode reportar, mais campanhas acionadas por eventos personalizados.

O AI Copywriter é separado do servidor MCP. É um complemento pago nos planos Business, Premium e Growth (10$ compram 5.000 créditos de IA, válidos por um ano), e incluído no Enterprise.

Os meus dados estão seguros e onde é que o token de login é armazenado?

Sim. Inicia sessão através do seu navegador, pelo que o assistente nunca vê a sua palavra-passe, e o token é armazenado em ~/.pushengage/mcp.json, legível apenas pela sua conta de utilizador. Para o revogar, peça ao assistente para o desconectar, ou termine todas as sessões em Definições, depois Segurança. Os detalhes estão na secção de segurança acima.

Uma agência pode gerir várias contas PushEngage?

Sim. Adicione o servidor ao seu cliente duas vezes sob nomes diferentes, cada um com o seu próprio ficheiro de token definido através de PE_MCP_CONFIG_PATH, e inicie sessão em cada conta uma vez. O guia de agência explica como.

Configure uma vez. Depois, basta pedir.

O servidor PushEngage MCP é de código aberto, é executado no seu próprio computador e funciona em todos os planos PushEngage, incluindo o Gratuito. Adicione uma entrada ao seu cliente MCP, inicie sessão através do seu navegador, escolha um site e comece a perguntar.

Se preferir trabalhar a partir de um separador do navegador ou do WordPress, o PushEngage também cobre isso: a extensão do navegador para Chrome e Firefox e a integração com a API de Habilidades do WordPress.

Configure o servidor PushEngage MCP ou compare os planos. Paga apenas por subscritores ativos, e os planos pagos têm uma garantia de devolução de 14 dias: se o PushEngage não for a melhor opção, reembolsamos 100%.