Hai già Claude Desktop, Claude Code o Cursor aperti più ore al giorno rispetto alla dashboard di PushEngage. Ogni volta che devi controllare un tasso di clic o inviare una notifica, passi dalla finestra in cui avviene il lavoro effettivo. La configurazione di PushEngage MCP colma quel divario: un comando npx, un accesso al browser e gli strumenti di PushEngage si trovano all'interno della stessa sessione di chat che stai già utilizzando per scrivere codice, eseguire il debug di un flusso di lavoro o rispondere a una domanda del tuo team.
Questa è la guida completa alla configurazione: installazione, le due variabili d'ambiente da conoscere, il primo accesso e le tre cose specifiche che interrompono la connessione quando non funziona subito al primo tentativo. Alla fine, avrai una sessione autenticata con un sito selezionato, non solo un indicatore verde "connesso".
Cosa sarai in grado di fare una volta connesso
@pushengage/mcp offre 27 strumenti in 10 domini e, una volta autenticato su un sito, tutti sono a una frase di distanza invece che a un clic dalla dashboard. Alcuni esempi di come appare una volta completata la configurazione:
- Invia subito una notifica push, pianificala per un orario specifico o imposta un invio ricorrente, nel fuso orario locale di ciascun abbonato se lo richiedi.
- Esegui un test A/B tra due titoli e lascia che l'assistente riporti il tasso di clic una volta ottenuti i risultati.
- Crea un segmento o un gruppo di pubblico da una descrizione in linguaggio naturale invece che da un'interfaccia utente basata su regole.
- Estrai le analisi come riepilogo a vita o come serie temporale giorno per giorno.
- Elenca le tue campagne drip, le campagne attivate e i flussi di lavoro per verificare cosa è effettivamente in esecuzione.
- Leggi le impostazioni del tuo sito, la configurazione del service worker e la configurazione del widget di chat.
Nessuna di queste operazioni richiede che l'assistente abbia la tua password PushEngage, e nessuna di esse richiede che tu lasci il tuo editor o terminale. PushEngage gestisce questa integrazione per una base di account di oltre 25.000 proprietari di attività in oltre 150 paesi, inviando 15,2 miliardi di notifiche negli ultimi 30 giorni. Il server MCP comunica con la stessa API di produzione su cui si basa quel volume, non con una demo sandboxata.
Prima di iniziare: cosa ti serve
Tre cose, e probabilmente ne hai già almeno due:
- Un account PushEngage - gratuito o a pagamento, con almeno un sito aggiunto. Il server MCP non crea un sito per te; opera sui siti che hai già configurato nella tua dashboard PushEngage.
- Node.js 18 o versioni successive - l'assistente esegue il server tramite
npx, che viene fornito con Node. Verifica connode -vin un terminale. - Un client compatibile con MCP: Claude Desktop, Claude Code, Cursor o qualsiasi altro client che supporti MCP tramite input/output standard (stdio).
Una cosa che vale la pena dichiarare chiaramente prima di iniziare a modificare i file di configurazione: @pushengage/mcp viene eseguito localmente sulla tua macchina tramite stdio. Non c'è un server remoto a cui puntare e nessun URL del connettore ospitato. Il client avvia il processo e il processo parla con l'API di PushEngage per tuo conto. Se una guida di configurazione per uno strumento diverso ti dice di incollare un endpoint remoto, si tratta di un tipo di server MCP diverso da questo.
Configurazione del server in Claude Desktop, Claude Code e Cursor
Nessuna installazione globale. npx scarica @pushengage/mcp su richiesta la prima volta che il tuo client lo avvia, utilizzando il comando esatto npx -y @pushengage/mcp. Aggiungi quel comando alla configurazione MCP del tuo client, riavvia il client e il server apparirà nella tua lista di strumenti.
Ogni client conserva la propria configurazione in un posto diverso.
Claude Desktop
Modifica ~/Library/Application Support/Claude/claude_desktop_config.json su macOS (o il percorso equivalente sulla tua piattaforma):
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Riavvia Claude Desktop. Il server "pushengage" dovrebbe apparire nella tua lista di strumenti.
Cursor
Modifica ~/.cursor/mcp.json:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Code
Claude Code supporta MCP tramite stdio nello stesso modo di Claude Desktop e Cursor, quindi la stessa struttura command/args funziona se modifichi direttamente il suo file di configurazione MCP. Se preferisci non modificare manualmente JSON, Claude Code accetta anche server tramite il suo comando CLI claude mcp add, che è un comportamento generale di Claude Code piuttosto che qualcosa di specifico per PushEngage. Consulta la documentazione di Claude Code per la sintassi esatta dei flag se scegli questa strada.
Qualsiasi altro client MCP
Se il tuo client non è uno dei tre sopra menzionati, il requisito sottostante è lo stesso ovunque: configuralo per eseguire npx -y @pushengage/mcp come server stdio. Questo è l'intero passaggio di installazione, indipendentemente da quale client legge la configurazione.
Denominazione della connessione e isolamento dei token: PE_MCP_CLIENT_NAME e PE_MCP_CONFIG_PATH
Non è richiesta alcuna configurazione oltre al passaggio di installazione. Il server comunica con l'API di produzione di PushEngage per impostazione predefinita; esistono due variabili d'ambiente per configurazioni meno comuni:
| Variabile d'ambiente | Predefinito | Scopo |
|---|---|---|
PE_MCP_CLIENT_NAME | Assistente AI | L'etichetta mostrata nella schermata di autorizzazione di PushEngage come app che richiede l'accesso. Impostala se desideri qualcosa di più specifico, come "Claude Desktop". |
PE_MCP_CONFIG_PATH | ~/.pushengage/mcp.json | Dove è archiviato il token di accesso. Imposta questo per eseguire più account PushEngage affiancati. Deve essere un percorso assoluto, senza espansione di ~. |
La maggior parte delle configurazioni con un singolo account non ha mai bisogno di toccare nessuna delle due variabili. PE_MCP_CLIENT_NAME è una comodità estetica, utile se si desidera che la schermata di autorizzazione dica qualcosa di più leggibile di "assistente AI" quando sei tu a fare clic su Autorizza. PE_MCP_CONFIG_PATH è importante nel momento in cui hai bisogno di un secondo token separato, che è esattamente il caso trattato di seguito.
Prima esecuzione: accesso e selezione di un sito
L'autenticazione è basata sul browser, quindi l'assistente non vede mai la tua password PushEngage. Il flusso è in tre passaggi, ed è utile esaminare cosa chiama ciascuno di essi sotto il cofano:
- Chiedi all'assistente di accedere. In parole povere: "Accedimi a PushEngage." Questo invoca
pushengage_auth_login, che apre una scheda del browser alla pagina di autorizzazione di PushEngage. - Fai clic su Autorizza. La dashboard invia il token al server come richiesta POST — non appare mai in un URL, nella cronologia del browser o nei log di accesso. Il token viene salvato localmente con permessi
0600, leggibile solo dal tuo utente. - Chiedi all'assistente di mostrare i tuoi siti, quindi scegline uno. "Mostra i miei siti PushEngage" chiama
pushengage_list_sites; "Usa sito 12345" chiamapushengage_select_site. La selezione viene ricordata tra i riavvii, e ogni strumento con ambito sito agisce su di essa a meno che non passi esplicitamente un diversosite_id.
Gli strumenti coinvolti, per nome:
| Strumento | Scopo |
|---|---|
pushengage_auth_login | Apre il browser su PushEngage e memorizza il token in caso di successo. |
pushengage_auth_status | Mostra se sei autenticato e quale sito è attualmente selezionato. |
pushengage_list_sites | Elenca i siti PushEngage a cui il tuo account può accedere. |
pushengage_select_site | Imposta il sito corrente su cui agiranno gli altri strumenti. |
Una volta scelto un sito, esegui pushengage_auth_status (chiedere "qual è il mio stato di autenticazione PushEngage" è sufficiente) e conferma che riporta sia una sessione autenticata che un sito selezionato prima di provare qualsiasi altra cosa. Questo è il vero traguardo della configurazione, non il momento in cui il client mostra per la prima volta il server come connesso.
Risoluzione dei problemi, per causa
La maggior parte dei problemi di connessione risale a una di queste tre cause specifiche. Diagnostica in quest'ordine.
Il server non si connette affatto e il tuo client mostra "Connessione chiusa." Questo è quasi sempre un problema di PATH, non un bug nel server. Claude Desktop, Cursor e client simili vengono avviati dal Dock o dal Finder, non da un terminale, quindi non caricano mai i file di avvio della tua shell. Se Node è stato installato tramite un gestore di versioni (nvm, fnm, volta), il client non riesce a trovare affatto npx. Il processo non si avvia mai e ottieni un errore di connessione generico invece di un chiaro "comando non trovato". Esegui which npx in un terminale per ottenere il percorso assoluto, quindi punta il tuo client direttamente ad esso:
{
"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"
}
}
}
}Riavvia il client dopo averlo modificato. Se which npx stampa invece un percorso sotto /usr/local/bin o /opt/homebrew/bin, un gestore di versioni probabilmente non è il tuo problema; controlla i log MCP del client per l'errore effettivo.
[AUTH_EXPIRED]. Il tuo token è scaduto. Chiedi all'assistente di accedere di nuovo: questa è l'intera soluzione.
[NO_SITE_SELECTED]. Sei autenticato, ma nessun sito è ancora stato scelto. Chiama pushengage_list_sites, quindi chiedi di utilizzare uno dei siti restituiti, prima di riprovare qualsiasi strumento specifico per sito.
Un altro caso che vale la pena conoscere anche se non è un errore: se il browser non si apre automaticamente, probabilmente ti trovi in una sessione headless o remota (SSH, un container). L'URL di autorizzazione viene stampato nel terminale che esegue il server. Aprilo manualmente.
Esecuzione di più account o client PushEngage
Se gestisci PushEngage per più di un marchio, o sei un'agenzia che esegue MCP su diversi account cliente, la soluzione è PE_MCP_CONFIG_PATH di cui sopra: registra il server con due nomi diversi, ognuno con il proprio percorso in modo che i token non vadano in conflitto.
{
"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)"
}
}
}
}Accedi separatamente sotto ogni nome server, autorizzando l'account PushEngage che scegli nel browser ogni volta. Ogni voce del server conserva il proprio file di token, quindi passare da un account cliente all'altro è una questione di quale nome dello strumento chiami, non di un nuovo accesso ogni volta. Se questo è il tuo caso d'uso effettivo, la serie contiene una guida completa su come eseguire più account client PushEngage da un unico assistente AI.
Cosa fare una volta connessi
Con l'autenticazione completata e un sito selezionato, i 27 strumenti si suddividono in alcuni gruppi pratici che vale la pena conoscere per nome, non solo per numero.
Per il lavoro quotidiano di gestione delle campagne, la serie copre come inviare e pianificare notifiche push dal tuo assistente AI invece che dalla dashboard, e come effettuare test A/B sulle notifiche push e lasciare che l'AI scelga il vincitore in base al tasso di clic. Per costruire la tua lista, c'è una guida completa per costruire segmenti di iscritti in linguaggio semplice.
Per la misurazione, leggere le analisi delle notifiche push tramite il tuo assistente AI illustra i riepiloghi a vita e le serie temporali giorno per giorno. Questi sono gli stessi strumenti di analisi che rendono un risultato di test A/B o un invio di campagna degni di nota, non solo di esecuzione. La serie copre anche l'audit delle campagne a goccia e dei flussi di lavoro per verificare cosa è effettivamente attivo, e la gestione del widget di chat che visualizza WhatsApp e altri canali sul sito.
Per il lavoro a livello di sito, modificare le impostazioni del sito PushEngage da un assistente AI copre il fuso orario, la geolocalizzazione e la configurazione del service worker. E se stai configurando questo per più di un account PushEngage, il post focalizzato sulle agenzie su come eseguire più account client PushEngage da un unico assistente AI (collegato sopra) approfondisce l'esempio di configurazione in questa guida.
Se lo stai configurando per qualcuno meno esperto di tecnologia (un fondatore che vuole che l'assistente AI gestisca PushEngage giorno per giorno senza toccare un file di configurazione da solo), la prima settimana di un fondatore non tecnico con PushEngage MCP è la versione narrativa di questa stessa configurazione, scritta per quel lettore.
La configurazione stessa funziona allo stesso modo indipendentemente dal tuo piano PushEngage. Ogni piano PushEngage, incluso il livello gratuito, supporta il server MCP. Se stai decidendo quale piano si adatta prima di collegare qualsiasi cosa, la pagina prezzi di PushEngage ha i livelli attuali.
