Varför en nybörjarguide för att använda en MCP-server måste börja med det du är rädd för
Du har aldrig klistrat in en API-nyckel i ett chattfönster, och du tänker inte börja nu. Det är den verkliga anledningen till att du har skjutit upp att ansluta en AI-assistent till ditt pushnotifikationskonto i månader. Du tvivlar inte på att det skulle fungera; du litar bara inte på dig själv att inte förstöra något, eller skicka fel meddelande till riktiga prenumeranter medan du fortfarande lär dig var knapparna finns.
Det här är en nybörjarguide för att använda en MCP-server, specifikt PushEngage MCP, den officiella Model Context Protocol-servern för PushEngage, skriven på det enda sätt som faktiskt bevisar om en av dessa saker är säker att lämna ditt konto till: som en verklig vecka, dag för dag, inte en femminuters demo som slutar i samma ögonblick som anslutningen blir grön. De flesta guider för att ställa in en MCP-server slutar vid ”den är ansluten”. Den här fortsätter, eftersom en grundare som bestämmer sig för om de ska lita på ett verktyg med verkliga sändningar behöver se det utföra en hel vecka av vanligt arbete, inte ett enda förutbestämt testanrop.
PushEngage MCP körs redan i verklig skala innan du rör den: 25 000+ företagsägare i 150+ länder skickar via PushEngage, 15,2 miljarder notifikationer skickades ut under de senaste 30 dagarna ensamma, över 27 verktyg som spänner över 10 domäner i kontot. Den volymen spelar roll av en anledning: misstagen som en förstagångsanvändare är rädd för att göra har mestadels redan gjorts, och åtgärdats, av människor som inte är du.
Här är veckan. Dag ett är installation och inloggning, och inget annat. Dag två är den första riktiga sändningen. Dag tre är en schemalagd sändning som måste landa vid rätt tidpunkt för prenumeranter i olika tidszoner. Dag fem är första gången du ställer en enkel fråga om hur något av det faktiskt presterade. I slutet kommer något specifikt att ha förändrats i hur du driver verksamheten, inte bara i hur du använder ett verktyg. PushEngages webbpushnotifikationer är kanalen som allt körs igenom.
Dag 1: installera PushEngage MCP utan att någonsin skriva en API-nyckel
Hela mcp-serverinstallationen tar ungefär tio minuter, och ingen av dessa tio minuter innebär att du genererar, kopierar eller klistrar in en autentiseringsuppgift någonstans. Det faktum ensamt är hela anledningen till att den här veckan är värd att prova.
Lägga till servern till din assistent
PushEngage MCP levereras som ett npm-paket, @pushengage/mcp, och installationskommandot är en enda rad: npx -y @pushengage/mcp. Det finns inget att ladda ner i förväg och inget att uppdatera själv. npx hämtar den aktuella versionen i det ögonblick din assistent kör den. Du behöver Node.js 18 eller nyare redan på din maskin och en MCP-kompatibel klient (Claude Desktop, Claude Code, Cursor eller någon annan), men du behöver inte skriva en enda rad kod.
Om du använder Claude Desktop finns konfigurationsfilen för claude mcp-servern i en fil som heter claude_desktop_config.json (på macOS, under ~/Library/Application Support/Claude/). Du öppnar den och klistrar in detta block:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}
Spara filen och starta om Claude Desktop. "pushengage" bör visas i din verktygslista.
Cursor fungerar på samma sätt, bara i en annan fil, ~/.cursor/mcp.json, med samma block inklistrat. Claude Code ber dig inte att manuellt redigera en JSON-fil alls; du registrerar samma claude mcp-server med ett terminalkommando, claude mcp add pushengage -- npx -y @pushengage/mcp, och den är tillgänglig i varje session från och med då. Vilken klient du än använder är arbetets utformning densamma: kopiera ett kort block, eller skriv en rad, och starta om. Ingen ber dig att skriva programvara.
Vad händer när du klickar på Auktorisera
När servern visas, be din assistent: "Logga in mig på PushEngage." En webbläsarflik öppnas till PushEngages egen auktorisationssida, inte ett formulär inbäddat i ditt chattfönster: en faktisk webbläsarflik, på PushEngages egen domän. Du klickar på Auktorisera. Fliken bekräftar framgång, och en åtkomsttoken sparas till en fil på din maskin, ~/.pushengage/mcp.json, läsbar endast av ditt eget användarkonto.
Vid ingen tidpunkt ser din assistent ditt PushEngage-lösenord. Instrumentpanelen skickar token till servern som en bakgrundsförfrågan, så den visas aldrig i en URL, din webbhistorik eller någons åtkomstlogg. Detta är den del av en mcp-server för nybörjare som är viktigast: inloggningsuppgifterna lever direkt mellan din webbläsare och PushEngage, och AI:n sitter aldrig i den vägen alls.
Att välja vilken webbplats som är "aktuell"
Fråga "Visa mina PushEngage-webbplatser", sedan "Använd webbplats [vilken du nu menade]." Det valet stannar kvar. Det bestå över omstarter, så du kommer inte att välja om det varje gång du öppnar en ny chatt. Varje webbplats-specifikt verktyg från och med nu agerar på den aktuella webbplatsen om du inte uttryckligen anger en annan, vilket är viktigt i det ögonblick du kör mer än en egenskap. Om du bara har en webbplats under ditt konto tar det här steget tio sekunder och du tänker aldrig på det igen. Om du driver två butiker under ett PushEngage-konto är detta också ögonblicket att notera att du kommer att vilja ange vilken du menar vid varje begäran som rör prenumeranter, sändningar eller analyser. Assistenten kommer inte att gissa.
När dag 1 inte går smidigt: de två saker som faktiskt går fel
De flesta problem med installation av MCP-server härstammar från ett problem, och det är varken PushEngages eller ditt fel: det handlar om hur skrivbordsappar startas. Om Claude Desktop eller Cursor rapporterar servern som frånkopplad, eller om du ser något som MCP error -32000: Connection closed, men att skriva npx -y @pushengage/mcp direkt i din egen terminal fungerar bra, då är det ett PATH-problem. Appar som startas från ditt Dock eller Finder laddar inte dina skalstartsfiler, så om Node installerades via en versionshanterare kan appen bokstavligen inte hitta npx.
Lösningen är att peka din klient på den absoluta sökvägen till npx istället för att förlita dig på att den hittar den. Kör which npx i din terminal för att få den sökvägen, använd den sedan direkt:
{
"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"
}
}
}
}
Starta om klienten efter redigering. Om which npx skrev ut något under /usr/local/bin eller /opt/homebrew/bin istället, är detta troligen inte ditt problem. Kontrollera klientens egna MCP-loggar för det verkliga felet.
Tre mindre meddelanden är värda att känna till innan du stöter på dem, eftersom inget av dem betyder att något är trasigt:
AUTH_EXPIRED— din token har gått ut. Be assistenten att logga in dig igen.NO_SITE_SELECTED— du hoppade över steget "använd webbplats". Lista dina webbplatser och välj en.- Webbläsaren öppnas inte — detta händer bara i "headless" eller fjärrsessioner. Auktoriseringslänken skrivs ut i terminalen istället; öppna den manuellt.
Alla andra fel som servern returnerar börjar med en [CODE]-tagg och en förklaring på vanligt språk, vilket är den detalj som är värd att komma ihåg när något ser skrämmande ut kl. 23 på en tisdag: det är inte tyst, och det är inte kryptiskt avsiktligt.
Dag 2: den första "skicka detta nu"-begäran
Vid dag två är installationen klar och bortglömd. Det är här AI-assistentens push-notiser slutar vara en idé och blir ett specifikt meddelande, som skickas till en specifik grupp människor, just nu.
Du frågar: "Skicka en notis till mina kundvagnsavhoppare med titeln 'Tänker fortfarande efter?', meddelande 'Din kundvagn väntar – slutför den idag,' med länk till min kundvagnssida."
Din assistent skickar inte iväg det omedelbart. Den upprepar exakt vad den ska skicka: titeln, meddelandet, länken och vilken målgrupp den riktar sig till, och väntar sedan på din bekräftelse innan pushengage_send_notification skickar det. Om du angav en målgrupp som PushEngage redan har (kundvagnsavhoppare, i det här exemplet), skickas det bara till det segmentet; om du inte angav någon skulle det gå till alla prenumeranter, vilket är värt att notera innan du godkänner något.
Inget skickas ut som du inte sett först. Det är hela poängen med att skicka och schemalägga push-notiser från din AI-assistent istället för en instrumentpanel: bekräftelsesteget är inbyggt i själva konversationen, inte en separat skärm som du måste komma ihåg att kontrollera.
Dag 3: en schemalagd sändning som landar kl. 09.00 i varje prenumerants egen tidszon
Dag tre är där en grundares verkliga tvekan inför automatisering visar sig: vad händer om detta utlöses medan jag inte tittar, och kommer det att utlösas vid rätt tidpunkt för någon som inte befinner sig i min tidszon?
pushengage_send_notification har ett schemaläge inbyggt för just detta. Du begär en engångssändning tidsinställd för "kl. 9 på morgonen i varje prenumerants lokala tidszon", och verktyget schemalägger leveransen så att en prenumerant i Lissabon och en prenumerant i Manila båda får den kl. 9 på morgonen, inte din. Sändningen kräver fortfarande ditt godkännande innan den schemaläggs, precis som dag två; endast tidpunkten ändras.
Återkommande sändningar finns också (du kan ställa in ett veckovis nyhetsbrev på samma sätt), men dag tre är avsiktligt bara engångsversionen. Du behöver inte lita på verktyget med ett stående återkommande jobb innan du har sett en enda schemalagd sändning landa korrekt.
Tidszonsleverans per prenumerant är detaljen värd att fundera över, eftersom det är lätt att anta att en "schemalagd sändning" bara betyder "skicka senare" och missa vad som faktiskt är annorlunda här. Om en fjärdedel av dina prenumeranter befinner sig långt ifrån din egen tidszon, innebär en enda fast sändningstid att de flesta av dem antingen får den medan de sover eller timmar efter den tidpunkt då den var tänkt att spela roll. Att dela upp leveransen efter varje prenumerants egen lokala tid innebär att en sändning kl. 9 är en sändning kl. 9 överallt där den landar, vilket är skillnaden mellan en avisering som någon ser till frukost och en som begravts vid lunch.
Dag 5: fråga "hur gick det?" istället för att öppna en instrumentpanel
Vid dag fem har du skickat något och schemalagt något. Nästa fråga en grundare faktiskt ställer handlar inte om verktyget. Den handlar om affären: var något av det värt att göra.
Du frågar: "Hur många prenumeranter har jag, och vad var min klickfrekvens på den där sändningen av övergivna kundvagnar?" pushengage_get_analytics_summary och pushengage_get_analytics_timeseries svarar direkt, i chatten, med verkliga siffror: antal prenumeranter, sändningar, visningar, klick och klickfrekvens för den tidsperiod du frågade om.
Säg att sändningen av övergivna kundvagnar från dag två gav en CTR som var meningsfullt högre än dina vanliga webbplatsomfattande utskick. Det är inte bara ett större antal att känna sig nöjd med. Illustrativt, om ens en blygsam andel av dessa extra klick resulterar i ett köp, är det återvunnen kundvagnsintäkt som du annars skulle ha skrivit av, inte bara en engagemangsstatistik. Det är den faktiska beslutsdagen dag fem handlar om: inte "öppnade folk det", utan "är det värt att göra igen, och för vilket segment". För en längre vy över flera sändningar, går veckovis rapportering av push-prestanda och analys av push-aviseringar förklarad på enkel svenska djupare än vad en enda dag-fem-fråga kan.
Vad som faktiskt förändrades i slutet av veckan
Inget med push-aviseringar förändrades den här veckan. Det som förändrades är var arbetet sker.
Du öppnade inte en separat instrumentpanelsflik för att kontrollera antalet prenumeranter. Du skickade inte ett meddelande till en utvecklare och bad dem att "bara ändra sändningstiden" för det schemalagda meddelandet. Du bytte inte kontext mellan att driva verksamheten och hantera pushverktyget. Begäran, bekräftelsen och resultatet skedde alla inom samma konversation som du redan hade.
Det är en mindre förändring än vad det låter som, och också en större. Mindre, eftersom inget av den underliggande kanalen ändrades. Web push fungerar fortfarande som det alltid har gjort, och meddelandena som skickades ut den här veckan är oskiljbara från de som skickades via instrumentpanelen. Större, eftersom fliken du inte öppnade är den flik som brukade vara anledningen till att detta fortsatte att skjutas upp till "senare". En uppgift som kräver att man byter appar, kommer ihåg en inloggning och hittar rätt skärm konkurrerar med allt annat på en grundares lista och förlorar oftast. En uppgift som sker inom en konversation som du redan hade konkurrerar inte med något. Den blir helt enkelt gjord.
Det spelar störst roll eftersom inget av det krävde ett budgetbeslut först. PushEngage MCP fungerar med alla PushEngage-planer, inklusive gratisnivån. Du testade inte en nedskalad förhandsgranskning av upplevelsen den här veckan; du använde samma verktyg som ett betalkonto använder, med vanlig åtkomst. Om siffrorna från dag fem motiverar att göra mer av detta, är PushEngages prissida nästa anhalt, och den skalar med aktiva prenumeranter istället för att be om ett åtagande innan du har bevisat något för dig själv.
Vad den här nybörjarguide inte täckte, och vart du kan gå för att fördjupa dig
Värt att vara direkt med vad den här veckan inte berörde, eftersom en guide som bara berättar vad ett verktyg gör och aldrig vad det inte gör är den typ av guide som ställer till problem senare.
PushEngage MCP kan lista och läsa dina droppkampanjer, utlösta kampanjer och arbetsflöden. Den kan inte bygga dem åt dig. Om du vill ha en ny automation bygger du den fortfarande i instrumentpanelen; assistenten kan bara berätta vad som redan körs och hur det presterar. Den skickar inte WhatsApp-meddelanden, och det finns ingen fjärr- eller hostad version att ansluta från en webbläsare någon annanstans. Detta är en lokal server, körd via npx, som pratar med ditt konto över en standardprotokollanslutning, inget mer.
Inget av det begränsar den vecka du just hade. Om du vill ha fullständiga referensversionen av allt i dag ett (varje konfigurationsalternativ, varje klient, varje felsökningsfall), täcker den fullständiga installationsguiden för PushEngage MCP det som dokumentation snarare än berättelse.
Det är den ärliga formen av en nybörjarguide för att använda en MCP-server: fem verkliga dagar, en begäran i vanligt språk i taget, och du avslutar veckan med att göra samma arbete på färre platser än du började den på.