Waarom een beginnersgids voor het gebruik van een MCP-server moet beginnen met waar je bang voor bent
Je hebt nog nooit een API-sleutel in een chatvenster geplakt, en dat ga je nu ook niet doen. Dat is de echte reden dat je het verbinden van een AI-assistent met je pushmeldingaccount al maanden uitstelt. Je twijfelt er niet aan dat het zou werken; je vertrouwt jezelf er gewoon niet op dat je niets breekt, of de verkeerde boodschap naar echte abonnees stuurt terwijl je nog leert waar de knoppen zijn.
Dit is een beginnersgids voor het gebruik van een MCP-server, specifiek PushEngage MCP, de officiële Model Context Protocol-server voor PushEngage, geschreven op de enige manier die daadwerkelijk bewijst of een van deze dingen veilig is om je account aan toe te vertrouwen: als een echte week, dag per dag, niet een demo van vijf minuten die stopt zodra de verbinding groen wordt. De meeste handleidingen voor het instellen van een MCP-server eindigen met "het is verbonden." Deze gaat verder, omdat een oprichter die beslist of hij een tool met echte verzendingen wil vertrouwen, moet zien dat deze een volledige week van gewoon werk doet, niet één ingestudeerde testoproep.
PushEngage MCP draait al op echte schaal voordat je het aanraakt: 25.000+ bedrijfseigenaren in 150+ landen verzenden via PushEngage, alleen al in de afgelopen 30 dagen zijn er 15,2 miljard meldingen verzonden, verspreid over 27 tools in 10 domeinen van het account. Dat volume is om één reden belangrijk: de fouten die een beginnende gebruiker bang is te maken, zijn grotendeels al gemaakt en opgelost door mensen die niet jij zijn.
Hier is de week. Dag één is installeren en inloggen, en niets anders. Dag twee is de eerste echte verzending. Dag drie is een geplande verzending die op het juiste uur moet aankomen voor abonnees in verschillende tijdzones. Dag vijf is de eerste keer dat je een simpele vraag stelt over hoe het allemaal daadwerkelijk heeft gepresteerd. Tegen het einde zal er iets specifieks zijn veranderd aan hoe je het bedrijf runt, niet alleen aan hoe je een tool gebruikt. De web pushmeldingen van PushEngage zijn het kanaal waar het allemaal doorheen loopt.
Dag 1: PushEngage MCP installeren zonder ooit een API-sleutel te typen
De hele mcp-serverinstallatie duurt ongeveer tien minuten, en geen van die tien minuten omvat het genereren, kopiëren of plakken van een inloggegevens ergens. Dat ene feit is de hele reden dat deze week de moeite waard is om te proberen.
De server toevoegen aan uw assistent
PushEngage MCP wordt geleverd als een npm-pakket, @pushengage/mcp, en het installatiecommando is één regel: npx -y @pushengage/mcp. Er hoeft niets van tevoren te worden gedownload en niets dat u zelf moet bijhouden. npx haalt de huidige versie op op het moment dat uw assistent deze uitvoert. U hebt Node.js 18 of nieuwer nodig op uw machine en een MCP-geschikte client (Claude Desktop, Claude Code, Cursor of een andere), maar u hoeft geen regel code te schrijven.
Als u Claude Desktop gebruikt, bevindt de claude mcp serverconfiguratie zich in een bestand genaamd claude_desktop_config.json (op macOS, onder ~/Library/Application Support/Claude/). U opent het en plakt dit blok erin:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Sla het bestand op en start Claude Desktop opnieuw. “pushengage” zou in uw lijst met tools moeten verschijnen.
Cursor werkt op dezelfde manier, alleen in een ander bestand, ~/.cursor/mcp.json, met hetzelfde blok erin geplakt. Claude Code vraagt u helemaal niet om een JSON-bestand te bewerken; u registreert dezelfde claude mcp server met één terminalcommando, claude mcp add pushengage -- npx -y @pushengage/mcp, en deze is vanaf dat moment beschikbaar in elke sessie. Welke client u ook gebruikt, de vorm van het werk is hetzelfde: kopieer een kort blok, of typ één regel, en herstart. Niemand vraagt u om software te schrijven.
Wat gebeurt er als u op Autoriseren klikt
Zodra de server verschijnt, vraagt u uw assistent: “Log me in bij PushEngage.” Een browsertabblad opent naar de eigen autorisatiepagina van PushEngage, niet een formulier ingesloten in uw chatvenster: een echt browsertabblad, op het eigen domein van PushEngage. U klikt op Autoriseren. Het tabblad bevestigt succes, en een toegangstoken wordt opgeslagen in een bestand op uw machine, ~/.pushengage/mcp.json, alleen leesbaar door uw eigen gebruikersaccount.
Op geen enkel moment ziet uw assistent uw PushEngage-wachtwoord. Het dashboard stuurt de token naar de server als een achtergrondverzoek, dus deze verschijnt nooit in een URL, uw browsergeschiedenis of de toegangslogboeken van wie dan ook. Dit is het deel van een mcp server voor beginners dat het meest belangrijk is: de inloggegevens bevinden zich rechtstreeks tussen uw browser en PushEngage, en de AI zit helemaal niet in dat pad.
Kiezen welke site "huidig" is
Vraag “Toon mijn PushEngage-sites,” en dan “Gebruik site [welke u bedoelde].” Die selectie blijft behouden. Deze blijft behouden na herstarts, dus u hoeft deze niet elke keer opnieuw te kiezen als u een nieuwe chat opent. Elke site-specifieke tool vanaf nu werkt op die huidige site, tenzij u expliciet een andere benoemt, wat belangrijk is op het moment dat u meer dan één eigenschap gebruikt. Als u slechts één site onder uw account hebt, duurt deze stap tien seconden en denkt u er nooit meer aan. Als u twee webwinkels beheert onder één PushEngage-account, is dit ook het moment om op te merken dat u zult moeten aangeven welke u bedoelt bij elk verzoek dat betrekking heeft op abonnees, verzendingen of analyses. De assistent zal niet raden.
Wanneer dag 1 niet soepel verloopt: de twee dingen die daadwerkelijk misgaan
De meeste problemen met de installatie van de mcp-server zijn terug te voeren op één probleem, en het is niet de schuld van PushEngage of die van jou: het is hoe desktop-apps starten. Als Claude Desktop of Cursor de server als losgekoppeld rapporteert, of als je iets ziet als MCP error -32000: Connection closed, maar typen npx -y @pushengage/mcp rechtstreeks in je eigen terminal werkt prima, dan is dat een PATH-probleem. Apps die vanuit je Dock of Finder worden gestart, laden je shell-opstartbestanden niet, dus als Node is geïnstalleerd via een versiebeheerder, kan de app npx letterlijk niet vinden.
De oplossing is om je client te wijzen naar het absolute pad van npx in plaats van erop te vertrouwen dat deze het vindt. Voer which npx uit in je terminal om dat pad te krijgen, gebruik het dan rechtstreeks:
{
"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 iets onder /usr/local/bin of /opt/homebrew/bin afdrukte, is dit waarschijnlijk niet jouw probleem. Controleer de eigen MCP-logs van je client voor de werkelijke fout.
Drie kleinere berichten zijn het waard om te weten voordat je ze tegenkomt, omdat geen van hen betekent dat er iets kapot is:
AUTH_EXPIRED— je token is verlopen. Vraag de assistent om je opnieuw in te loggen.NO_SITE_SELECTED— je hebt de stap "site gebruiken" overgeslagen. Geef je sites weer en kies er een.- Browser opent niet — dit gebeurt alleen in headless of externe sessies. De autorisatielink wordt in plaats daarvan in de terminal afgedrukt; open deze handmatig.
Elke andere fout die de server retourneert, begint met een [CODE]-tag en een uitleg in gewone taal, wat het detail is dat de moeite waard is om te onthouden als iets er om 23:00 uur op een dinsdag eng uitziet: het is niet stil, en het is niet expres cryptisch.
Dag 2: het eerste "stuur dit nu"-verzoek
Op dag twee is de installatie gedaan en vergeten. Dit is waar AI-assistent pushmeldingen stoppen een idee te zijn en één specifieke boodschap worden, naar één specifieke groep mensen, nu.
Je vraagt: "Stuur een melding naar mijn winkelwagen-achterlaters met de titel 'Nog aan het overwegen?', bericht 'Je winkelwagen wacht - voltooi hem vandaag nog,' met een link naar mijn winkelwagenpagina."
Je assistent vuurt dat niet onmiddellijk af. Het herhaalt precies wat het gaat sturen: de titel, het bericht, de link en welke doelgroep het target, en wacht dan op jouw bevestiging voordat pushengage_send_notification het verzendt. Als je een doelgroep hebt genoemd die PushEngage al heeft (winkelwagen-achterlaters, in dit voorbeeld), gaat de verzending alleen naar dat segment; als je er geen hebt opgegeven, zou het naar elke abonnee gaan, wat de moeite waard is om op te merken voordat je iets goedkeurt.
Niets wordt verzonden dat je niet eerst hebt gezien. Dat is het hele punt van pushmeldingen verzenden en plannen vanuit je AI-assistent in plaats van een dashboard: de bevestigingsstap is ingebouwd in het gesprek zelf, niet een apart scherm dat je moet onthouden te controleren.
Dag 3: een geplande verzending die om 9.00 uur in de eigen tijdzone van elke abonnee landt
Dag drie is waar de echte aarzeling van een oprichter over automatisering naar voren komt: wat gebeurt er als dit afgaat terwijl ik niet oplet, en gaat het op het juiste moment af voor iemand die niet in mijn tijdzone zit?
pushengage_send_notification heeft een ingebouwde geplande modus, precies hiervoor. Je vraagt om een eenmalige verzending getimed voor "9 uur 's ochtends in de lokale tijdzone van elke abonnee", en het hulpprogramma plant de levering zodat een abonnee in Lissabon en een abonnee in Manilla het beiden om hun eigen 9 uur 's ochtends ontvangen, niet om die van jou. De verzending heeft nog steeds jouw goedkeuring nodig voordat deze wordt gepland, net als op dag twee; alleen de timing verandert.
Terugkerende verzendingen bestaan ook (je zou op dezelfde manier een wekelijks overzicht kunnen instellen), maar dag drie is opzettelijk alleen de eenmalige versie. Je hoeft het hulpprogramma niet te vertrouwen met een staande terugkerende taak voordat je een enkele geplande verzending correct hebt zien landen.
Levering per abonnee in hun eigen tijdzone is het detail waar je even bij stil moet staan, omdat het gemakkelijk is om aan te nemen dat een "geplande verzending" gewoon "later verzenden" betekent en te missen wat hier werkelijk anders is. Als een kwart van je abonnees zich nergens in de buurt van je eigen tijdzone bevindt, betekent een enkele vaste verzendtijd dat de meesten van hen het slapend ontvangen of uren nadat het ertoe moest doen. Het splitsen van de levering per eigen lokale tijd van elke abonnee betekent dat een verzending om 9 uur 's ochtends een verzending om 9 uur 's ochtends is overal waar het landt, wat het verschil is tussen een melding die iemand bij het ontbijt ziet en een die begraven is tegen de lunch.
Dag 5: vragen "hoe ging dat?" in plaats van een dashboard te openen
Op dag vijf heb je iets verzonden en iets gepland. De volgende vraag die een oprichter daadwerkelijk stelt, gaat niet over het hulpprogramma. Het gaat over het bedrijf: was dat het allemaal waard?
Je vraagt: "Hoeveel abonnees heb ik, en wat was mijn klikfrequentie op die verzending van winkelwagen-achterlaters?" pushengage_get_analytics_summary en pushengage_get_analytics_timeseries antwoorden direct, in de chat, met echte cijfers: abonneeaantal, verzendingen, weergaven, klikken en doorklikratio voor het door jou gevraagde tijdsbestek.
Stel dat de verzending van winkelwagen-achterlaters van dag twee terugkwam met een CTR die wezenlijk hoger was dan je gebruikelijke sitewide-uitzendingen. Dat is niet zomaar een groter getal om je goed over te voelen. Illustratief, als zelfs een bescheiden deel van die extra klikken een aankoop voltooit, is dat terugverdiende winkelwagenomzet die je anders had afgeschreven, niet alleen een engagementstatistiek. Dat is de eigenlijke beslissingsdag waar dag vijf voor is: niet "hebben mensen het geopend", maar "is dit de moeite waard om opnieuw te doen, en voor welk segment." Voor een langer overzicht over meerdere verzendingen, gaan weekelijkse prestatierapportage van pushmeldingen en analyse van pushmeldingen uitgelegd in duidelijke taal dieper dan een enkele dag-vijf vraag kan.
Wat er deze week daadwerkelijk veranderde
Niets aan pushmeldingen veranderde deze week. Wat veranderde, is waar het werk gebeurt.
Je hebt geen apart dashboard-tabblad geopend om abonneetgetallen te controleren. Je hebt geen bericht naar een ontwikkelaar gestuurd met het verzoek om 'gewoon de verzendtijd' van de geplande melding aan te passen. Je hebt geen contextwisseling gemaakt tussen het runnen van het bedrijf en het bedienen van de push-tool. Het verzoek, de bevestiging en het resultaat vonden allemaal plaats in hetzelfde gesprek dat je al voerde.
Dat is een kleinere verschuiving dan het klinkt, en ook een grotere. Kleiner, omdat niets aan het onderliggende kanaal veranderde. Web push werkt nog steeds zoals het altijd deed, en de meldingen die deze week zijn verzonden, zijn niet te onderscheiden van meldingen die via het dashboard zijn verzonden. Groter, omdat het tabblad dat je niet hebt geopend, de reden was dat dit steeds werd uitgesteld tot 'later'. Een taak die vereist dat je van app wisselt, een login onthoudt en het juiste scherm vindt, concurreert met al het andere op de lijst van een oprichter en verliest meestal. Een taak die plaatsvindt binnen een gesprek dat je al voerde, concurreert nergens mee. Het wordt gewoon gedaan.
Dat is het belangrijkste, omdat geen van dit alles eerst een budgetbeslissing vereiste. PushEngage MCP werkt met elk PushEngage-abonnement, inclusief de gratis versie. Je testte deze week geen afgeschaalde preview van de ervaring; je gebruikte dezelfde tools als een betaald account, met gewone toegang. Als de cijfers van dag vijf de reden zijn om hier meer van te doen, is de prijslijstpagina van PushEngage de volgende stap, en deze schaalt mee met actieve abonnees in plaats van een toezegging te vragen voordat je jezelf iets hebt bewezen.
Wat deze beginnersgids niet behandelde, en waar je dieper kunt graven
Het is de moeite waard om direct te zijn over wat deze week niet heeft aangeraakt, want een gids die je alleen vertelt wat een tool doet en nooit wat hij niet doet, is het soort gids dat je later in de problemen brengt.
PushEngage MCP kan je drip-campagnes, getriggerde campagnes en workflows weergeven en lezen. Het kan ze niet voor je bouwen. Als je een nieuwe automatisering wilt, bouw je die nog steeds in het dashboard; de assistent kan je alleen vertellen wat er al draait en hoe het presteert. Het verzendt geen WhatsApp-berichten en er is geen externe of gehoste versie om vanaf een browser ergens anders te verbinden. Dit is een lokale server, uitgevoerd via npx, die via een standaard protocolverbinding met je account praat, niets meer.
Niets van dat alles beperkt de week die je net hebt gehad. Als je de volledige referentieversie wilt van alles in dag één (elke configuratieoptie, elke client, elke probleemoplossingscase), behandelt de volledige PushEngage MCP-installatiegids dit als documentatie in plaats van als een verhaal.
Dat is de eerlijke vorm van een beginnersgids voor het gebruik van een MCP-server: vijf echte dagen, één verzoek in eenvoudige taal per keer, en jij die de week afsluit met hetzelfde werk op minder plekken dan waar je mee begon.
