Je hebt Claude Desktop, Claude Code of Cursor al meer uren per dag openstaan dan het PushEngage dashboard. Elke keer dat je een klikfrequentie wilt controleren of een melding wilt verzenden, schakel je weg van het venster waar het eigenlijke werk plaatsvindt. PushEngage MCP-setup dicht die kloof: één npx-commando, een browser-aanmelding, en de tools van PushEngage bevinden zich in dezelfde chatsessie die je al gebruikt om code te schrijven, een workflow te debuggen of een vraag van je team te beantwoorden.
Dit is de complete installatiehandleiding: installatie, de twee omgevingsvariabelen die het weten waard zijn, de eerste login, en de drie specifieke dingen die de verbinding verbreken wanneer deze niet meteen werkt. Tegen het einde heb je een geauthenticeerde sessie met een geselecteerde site, niet alleen een groene "verbonden" indicator.
Wat je kunt doen als je verbonden bent
@pushengage/mcp levert 27 tools op 10 domeinen, en zodra je geauthenticeerd bent tegen een site, zijn ze allemaal een zin verwijderd in plaats van een dashboardklik. Enkele voorbeelden van hoe dat eruitziet na de installatie:
- Verzend nu een pushmelding, plan deze voor een specifiek tijdstip, of stel een terugkerende verzending in — in de lokale tijdzone van elke abonnee als je daarom vraagt.
- Voer een A/B-test uit tussen twee koppen en laat de assistent rapporteren over de klikfrequentie zodra de resultaten binnen zijn.
- Bouw een segment of een doelgroep op basis van een beschrijving in natuurlijke taal in plaats van een regelu-interface.
- Haal analyses op als een levenslange samenvatting of als een dagelijkse tijdreeks.
- Lijst je drip-campagnes, getriggerde campagnes en workflows op om te controleren wat er daadwerkelijk draait.
- Lees de instellingen van je site, de configuratie van de service worker en de installatie van de chatwidget.
Niets daarvan vereist dat de assistent je PushEngage-wachtwoord heeft, en niets daarvan vereist dat je je editor of terminal verlaat. PushEngage voert deze integratie uit voor een accountbasis van meer dan 25.000 bedrijfseigenaren in meer dan 150 landen, en verzendt 15,2 miljard meldingen in de afgelopen 30 dagen. De MCP-server praat met dezelfde productie-API waarop dat volume draait, niet met een gesandboxte demo.
Voordat je begint: wat je nodig hebt
Drie dingen, en je hebt er waarschijnlijk al minstens twee:
- Een PushEngage-account — gratis of betaald, met ten minste één site toegevoegd. De MCP-server maakt geen site voor je aan; het werkt met sites die je al hebt ingesteld in je PushEngage-dashboard.
- Node.js 18 of nieuwer — de assistent voert de server uit via
npx, dat wordt meegeleverd met Node. Controleer metnode -vin een terminal. - Een MCP-compatibele client — Claude Desktop, Claude Code, Cursor of een andere client die MCP spreekt via standaardinvoer/uitvoer (stdio).
Eén ding dat duidelijk vermeld moet worden voordat u begint met het bewerken van configuratiebestanden: @pushengage/mcp draait lokaal op uw machine via stdio. Er is geen externe server om naar te verwijzen en geen gehoste connector-URL. De client start het proces, en het proces praat namens u met de API van PushEngage. Als een installatiehandleiding voor een ander hulpprogramma u vertelt om een externe eindpunt in te plakken, is dat een ander soort MCP-server dan deze.
De server instellen in Claude Desktop, Claude Code en Cursor
Geen globale installatie. npx haalt @pushengage/mcp op aanvraag op de eerste keer dat uw client deze start, met behulp van het exacte commando npx -y @pushengage/mcp. U voegt dat commando toe aan de MCP-configuratie van uw client, start de client opnieuw op en de server verschijnt in uw lijst met hulpprogramma's.
Elke client bewaart zijn configuratie op een andere locatie.
Claude Desktop
Bewerk ~/Library/Application Support/Claude/claude_desktop_config.json op macOS (of het equivalent op uw platform):
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Start Claude Desktop opnieuw op. De "pushengage"-server zou in uw lijst met hulpprogramma's moeten verschijnen.
Cursor
Bewerk ~/.cursor/mcp.json:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Code
Claude Code spreekt MCP via stdio op dezelfde manier als Claude Desktop en Cursor, dus dezelfde command/args-structuur werkt als u het MCP-configuratiebestand rechtstreeks bewerkt. Als u liever geen JSON met de hand bewerkt, accepteert Claude Code ook servers via zijn eigen claude mcp add CLI-commando, wat algemeen gedrag van Claude Code is in plaats van iets specifieks voor PushEngage. Raadpleeg de eigen documentatie van Claude Code voor de exacte vlag-syntaxis als u die route kiest.
Elke andere MCP-client
Als uw client niet een van de drie hierboven is, is de onderliggende vereiste overal hetzelfde: configureer deze om npx -y @pushengage/mcp uit te voeren als een stdio-server. Dat is de volledige installatiestap, ongeacht welke client de configuratie leest.
De verbinding benoemen en tokens isoleren: PE_MCP_CLIENT_NAME en PE_MCP_CONFIG_PATH
Er is geen configuratie vereist buiten de installatiestap. De server praat standaard met de productie-API van PushEngage; er bestaan twee omgevingsvariabelen voor minder gebruikelijke instellingen:
| Omgevingsvariabele | Standaard | Doel |
|---|---|---|
PE_MCP_CLIENT_NAME | AI-assistent | Het label dat op het PushEngage-autorisatiescherm wordt weergegeven als de app die toegang aanvraagt. Stel dit in als u iets specifieker wilt, zoals "Claude Desktop". |
PE_MCP_CONFIG_PATH | ~/.pushengage/mcp.json | Waar het toegangstoken wordt opgeslagen. Stel dit in om meer dan één PushEngage-account naast elkaar te gebruiken. Moet een absoluut pad zijn — geen ~-expansie. |
De meeste instellingen voor één account hoeven deze variabelen nooit aan te raken. PE_MCP_CLIENT_NAME is een cosmetiek gemak, nuttig als u wilt dat het autorisatiescherm iets leesbaarders zegt dan "AI-assistent" wanneer u degene bent die op Autoriseren klikt. PE_MCP_CONFIG_PATH is belangrijk zodra u een tweede, aparte tokenbestand nodig heeft, wat precies het geval is dat hierna wordt behandeld.
Eerste keer: inloggen en een site kiezen
Authenticatie is browsergebaseerd, dus de assistent ziet nooit je PushEngage-wachtwoord. Het proces bestaat uit drie stappen, en het is de moeite waard om te bekijken wat elke stap onder de motorkap aanroept:
- Vraag de assistent om in te loggen. In gewone taal: "Log me in bij PushEngage." Dit roept
pushengage_auth_loginaan, wat een browsertabblad opent naar de PushEngage-autorisatiepagina. - Klik op Autoriseren. Het dashboard stuurt het token als een POST-verzoek naar de server — het verschijnt nooit in een URL, browsergeschiedenis of toegangslogboek. Het token wordt lokaal opgeslagen met
0600-permissies, alleen leesbaar door jouw gebruiker. - Vraag de assistent om je sites te tonen, kies er dan een. "Toon mijn PushEngage-sites" roept
pushengage_list_sitesaan; "Gebruik site 12345" roeptpushengage_select_siteaan. De selectie wordt onthouden tussen herstarts, en elke site-gerichte tool werkt erop, tenzij je expliciet een anderesite_iddoorgeeft.
De betrokken tools, op naam:
| Gereedschap | Doel |
|---|---|
pushengage_auth_login | Opent de browser naar PushEngage en slaat het token op bij succes. |
pushengage_auth_status | Toont of je geauthenticeerd bent en welke site momenteel is geselecteerd. |
pushengage_list_sites | Lijst de PushEngage-sites op waartoe je account toegang heeft. |
pushengage_select_site | Stelt de huidige site in waarop de andere tools zullen werken. |
Zodra je een site hebt gekozen, voer pushengage_auth_status uit (vragen "wat is mijn PushEngage-autorisatiestatus" is voldoende) en bevestig dat het zowel een geauthenticeerde sessie als een geselecteerde site rapporteert voordat je iets anders probeert. Dat is de eigenlijke finishlijn voor de installatie, niet het moment dat de client voor het eerst de server als verbonden toont.
Probleemoplossing, per oorzaak
De meeste verbindingsproblemen zijn terug te voeren op een van de drie specifieke oorzaken. Diagnoseer in deze volgorde.
De server maakt helemaal geen verbinding en je client toont "Verbinding gesloten." Dit is bijna altijd een PATH-probleem, geen bug in de server. Claude Desktop, Cursor en vergelijkbare clients worden gestart vanuit je Dock of Finder, niet vanuit een terminal, dus ze laden nooit de opstartbestanden van je shell. Als Node is geïnstalleerd via een versiebeheerder (nvm, fnm, volta), kan de client npx helemaal niet vinden. Het proces start nooit en je krijgt een algemene verbindingsfout in plaats van een duidelijke "commando niet gevonden." Voer which npx uit in een terminal om het absolute pad te krijgen, en wijs je client er dan rechtstreeks naar:
{
"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"
}
}
}
}Herstart de client na het bewerken. Als which npx in plaats daarvan een pad onder /usr/local/bin of /opt/homebrew/bin afdrukt, is een versiebeheerder waarschijnlijk niet je probleem; controleer de eigen MCP-logs van de client voor de daadwerkelijke fout.
[AUTH_EXPIRED]. Je token is verlopen. Vraag de assistent om opnieuw in te loggen — dat is de volledige oplossing.
[NO_SITE_SELECTED]. U bent geauthenticeerd, maar er is nog geen site gekozen. Roep pushengage_list_sites aan, vraag dan om een van de geretourneerde sites te gebruiken, voordat u een site-specifieke tool opnieuw probeert.
Nog een geval dat het waard is om te weten, ook al is het geen fout: als de browser niet automatisch opent, bent u waarschijnlijk in een headless of externe sessie (SSH, een container). De autorisatie-URL wordt afgedrukt naar de terminal die de server draait. Open deze handmatig.
Meer dan één PushEngage-account of -client uitvoeren
Als u PushEngage beheert voor meer dan één merk, of als u een bureau bent dat MCP uitvoert tegen verschillende klantaccounts, is de oplossing PE_MCP_CONFIG_PATH van eerder: registreer de server onder twee verschillende namen, elk met zijn eigen pad, zodat de tokens niet conflicteren.
{
"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)"
}
}
}
}Log in onder elke servernaam afzonderlijk, autoriseer elke keer welke PushEngage-account u ook kiest in de browser. Elke serververmelding bewaart zijn eigen tokenbestand, dus schakelen tussen klantaccounts is een kwestie van welke toolnaam u aanroept, niet elke keer opnieuw inloggen. Als dit uw werkelijke gebruiksscenario is, bevat de serie een volledige walkthrough van het uitvoeren van meerdere PushEngage-klantaccounts vanuit één AI-assistent.
Wat te doen als u verbonden bent
Met voltooide authenticatie en een geselecteerde site, zijn de 27 tools op te splitsen in een paar praktische groepen die het waard zijn om bij naam te kennen, niet alleen op aantal.
Voor het dagelijkse werk van het uitvoeren van campagnes, behandelt de serie hoe u pushmeldingen kunt verzenden en plannen vanuit uw AI-assistent in plaats van het dashboard, en hoe u pushmeldingen kunt A/B-testen en AI de winnaar kunt laten kiezen op basis van klikfrequentie. Voor het opbouwen van uw lijst is er een volledige gids om abonneesegmenten in duidelijke taal op te bouwen.
Voor metingen, pushmeldinganalyses lezen via uw AI-assistent behandelt samenvattingen van de levensduur en dagelijkse tijdreeksen. Dit zijn dezelfde analysegereedschappen die een A/B-testresultaat of een campagneverzending de moeite waard maken om over te rapporteren, niet alleen om uit te voeren. De serie behandelt ook het auditen van drip-campagnes en workflows om te controleren wat er daadwerkelijk actief is, en het beheren van de chatwidget die WhatsApp en andere kanalen op de site weergeeft.
Voor werk op siteniveau, PushEngage-sitesettings wijzigen vanuit een AI-assistent behandelt tijdzone-, geolocatie- en service worker-configuratie. En als u dit instelt voor meer dan één PushEngage-account, gaat het post over agentschappen voor het uitvoeren van meerdere PushEngage-klantaccounts vanuit één AI-assistent (hierboven gelinkt) dieper dan het configuratievoorbeeld in deze gids.
Als u dit instelt voor iemand die minder technisch is (een oprichter die wil dat de AI-assistent PushEngage dagelijks beheert zonder zelf een configuratiebestand aan te raken), is de eerste week van een niet-technische oprichter met PushEngage MCP de verhalende versie van dezelfde instelling, geschreven voor die lezer.
De installatie zelf werkt hetzelfde, ongeacht uw PushEngage-abonnement. Elk PushEngage-abonnement, inclusief het gratis niveau, ondersteunt de MCP-server. Als u beslist welk abonnement het beste past voordat u iets verbindt, vindt u op de prijzenpagina van PushEngage de huidige niveaus.
