Du har allerede Claude Desktop, Claude Code eller Cursor åbent flere timer om dagen end PushEngage-dashboardet. Hver gang du skal tjekke en klikrate eller sende en notifikation, skifter du væk fra det vindue, hvor det egentlige arbejde foregår. PushEngage MCP-opsætning lukker det hul: én npx-kommando, en browser-login, og PushEngages værktøjer sidder inde i den samme chat-session, som du allerede bruger til at skrive kode, debugge en arbejdsgang eller besvare et spørgsmål fra dit team.
Dette er den komplette opsætningsguide: installation, de to miljøvariabler, der er værd at kende til, det første login og de tre specifikke ting, der bryder forbindelsen, når den ikke bare virker første gang. Ved slutningen vil du have en godkendt session med et valgt websted, ikke bare en grøn "forbundet"-indikator.
Hvad du vil kunne gøre, når du er forbundet
@pushengage/mcp leverer 27 værktøjer på tværs af 10 domæner, og når du er godkendt mod et websted, er alle af dem en sætning væk i stedet for et dashboard-klik væk. Et par eksempler på, hvordan det ser ud, når opsætningen er færdig:
- Send en push-notifikation nu, planlæg den til et bestemt tidspunkt, eller opsæt en tilbagevendende udsendelse - i hver abonnents lokale tidszone, hvis du beder om det.
- Kør en A/B-test mellem to overskrifter, og lad assistenten rapportere tilbage om klikraten, når resultaterne er klar.
- Byg et segment eller en målgruppe ud fra en almindelig sprogbeskrivelse i stedet for en UI med regler.
- Hent analyser som en livstids-oversigt eller som en dag-til-dag tidsserie.
- List dine drypkampagner, udløste kampagner og arbejdsgange for at tjekke, hvad der rent faktisk kører.
- Læs dit websteds indstillinger, service worker-konfiguration og chat-widget-opsætning.
Intet af dette kræver, at assistenten har din PushEngage-adgangskode, og intet af det kræver, at du forlader din editor eller terminal. PushEngage kører denne integration for en kontobase på over 25.000 virksomhedsejere i over 150 lande og sender 15,2 milliarder notifikationer i de sidste 30 dage. MCP-serveren taler med den samme produktions-API, som dette volumen kører på, ikke en sandboxed demo.
Før du starter: hvad du har brug for
Tre ting, og du har sandsynligvis allerede mindst to af dem:
- En PushEngage-konto - gratis eller betalt, med mindst ét websted tilføjet. MCP-serveren opretter ikke et websted for dig; den opererer på websteder, du allerede har konfigureret i dit PushEngage-dashboard.
- Node.js 18 eller nyere - assistenten kører serveren via
npx, som leveres med Node. Tjek mednode -vi en terminal. - En MCP-kompatibel klient — Claude Desktop, Claude Code, Cursor eller enhver anden klient, der taler MCP over standard input/output (stdio).
Én ting, der er værd at sige tydeligt, før du begynder at redigere konfigurationsfiler: @pushengage/mcp kører lokalt på din maskine over stdio. Der er ingen fjernserver at pege på og ingen hostet connector-URL. Klienten starter processen, og processen taler med PushEngages API på dine vegne. Hvis en opsætningsguide til et andet værktøj fortæller dig at indsætte et fjernt slutpunkt, er det en anden type MCP-server end denne.
Opsætning af serveren i Claude Desktop, Claude Code og Cursor
Ingen global installation. npx henter @pushengage/mcp efter behov første gang din klient starter den, ved hjælp af den nøjagtige kommando npx -y @pushengage/mcp. Du tilføjer den kommando til din klients MCP-konfiguration, genstarter klienten, og serveren vises i din værktøjsliste.
Hver klient gemmer sin konfiguration et andet sted.
Claude Desktop
Rediger ~/Library/Application Support/Claude/claude_desktop_config.json på macOS (eller den tilsvarende sti på din platform):
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Genstart Claude Desktop. “pushengage”-serveren bør vises i din værktøjsliste.
Cursor
Rediger ~/.cursor/mcp.json:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Code
Claude Code taler MCP over stdio på samme måde som Claude Desktop og Cursor, så den samme command/args-form fungerer, hvis du redigerer dens MCP-konfigurationsfil direkte. Hvis du hellere vil undgå at redigere JSON manuelt, accepterer Claude Code også servere via sin egen claude mcp add CLI-kommando, hvilket er generel Claude Code-adfærd snarere end noget specifikt for PushEngage. Tjek Claude Codes egne dokumenter for den nøjagtige flag-syntaks, hvis du vælger den rute.
Enhver anden MCP-klient
Hvis din klient ikke er en af de tre ovenstående, er det underliggende krav det samme overalt: konfigurer den til at køre npx -y @pushengage/mcp som en stdio-server. Det er hele installationstrinnet, uanset hvilken klient der læser konfigurationen.
Navngivning af forbindelsen og isolering af tokens: PE_MCP_CLIENT_NAME og PE_MCP_CONFIG_PATH
Ingen konfiguration ud over installationstrinnet er påkrævet. Serveren taler med PushEngages produktions-API som standard; to miljøvariabler findes til mindre almindelige opsætninger:
| Miljøvariabel | Standard | Formål |
|---|---|---|
PE_MCP_CLIENT_NAME | AI-assistent | Mærkaten, der vises på PushEngage-godkendelsesskærmen som den app, der anmoder om adgang. Indstil den, hvis du ønsker noget mere specifikt, som f.eks. "Claude Desktop". |
PE_MCP_CONFIG_PATH | ~/.pushengage/mcp.json | Hvor adgangstokenet er gemt. Indstil dette for at køre mere end én PushEngage-konto side om side. Skal være en absolut sti — ingen ~-udvidelse. |
De fleste enkeltkonto-opsætninger behøver aldrig at røre ved nogen af variablerne. PE_MCP_CLIENT_NAME er en kosmetisk bekvemmelighed, nyttig, hvis du ønsker, at godkendelsesskærmen skal sige noget mere læseligt end “AI-assistent”, når det er dig, der klikker Godkend. PE_MCP_CONFIG_PATH betyder noget i det øjeblik, du har brug for en anden, separat tokenfil, hvilket er præcis det tilfælde, der dækkes næste gang.
Første kørsel: log ind og vælg et websted
Godkendelse er browserbaseret, så assistenten ser aldrig dit PushEngage-adgangskode. Flowet er tre trin, og det er værd at gennemgå, hvad hver enkelt rent faktisk kalder under motorhjelmen:
- Bed assistenten om at logge ind. Med almindelige ord: "Log mig ind på PushEngage." Dette udløser
pushengage_auth_login, som åbner en browserfane til PushEngage-godkendelsessiden. - Klik på Godkend. Dashboardet sender tokenet til serveren som en POST-anmodning - det vises aldrig i en URL, browserhistorik eller adgangslog. Tokenet gemmes lokalt med
0600-tilladelser, der kun kan læses af din bruger. - Bed assistenten om at vise dine websteder, og vælg derefter et. "Vis mine PushEngage-websteder" kalder
pushengage_list_sites; "Brug websted 12345" kalderpushengage_select_site. Valget huskes på tværs af genstarter, og hvert webstedsafgrænsede værktøj handler på det, medmindre du eksplicit angiver en andensite_id.
De involverede værktøjer, efter navn:
| Værktøj | Formål |
|---|---|
pushengage_auth_login | Åbner browseren til PushEngage og gemmer tokenet ved succes. |
pushengage_auth_status | Viser, om du er godkendt, og hvilket websted der er valgt. |
pushengage_list_sites | Viser de PushEngage-websteder, din konto har adgang til. |
pushengage_select_site | Indstiller det aktuelle websted, som de andre værktøjer vil handle på. |
Når du har valgt et websted, skal du køre pushengage_auth_status (det er nok at spørge "hvad er min PushEngage-godkendelsesstatus") og bekræfte, at den rapporterer både en godkendt session og et valgt websted, før du prøver noget andet. Det er den faktiske målstreg for opsætningen, ikke det øjeblik, klienten først viser serveren som tilsluttet.
Fejlfinding, efter årsag
De fleste forbindelsesproblemer kan spores tilbage til en af tre specifikke årsager. Diagnostiser i denne rækkefølge.
Serveren vil slet ikke oprette forbindelse, og din klient viser "Forbindelse lukket." Dette er næsten altid et PATH-problem, ikke en fejl i serveren. Claude Desktop, Cursor og lignende klienter startes fra din Dock eller Finder, ikke fra en terminal, så de indlæser aldrig dine shell-startfiler. Hvis Node blev installeret via en versionsstyring (nvm, fnm, volta), kan klienten slet ikke finde npx. Processen starter aldrig, og du får en generisk forbindelsesfejl i stedet for en klar "kommando ikke fundet." Kør which npx i en terminal for at få den absolutte sti, og peg derefter din klient direkte på den:
{
"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"
}
}
}
}Genstart klienten efter redigering. Hvis which npx i stedet udskriver en sti under /usr/local/bin eller /opt/homebrew/bin, er en versionsstyring sandsynligvis ikke dit problem; tjek klientens egne MCP-logs for den faktiske fejl.
[AUTH_EXPIRED]. Dit token er udløbet. Bed assistenten om at logge ind igen - det er hele løsningen.
[NO_SITE_SELECTED]. Du er godkendt, men ingen side er valgt endnu. Kald pushengage_list_sites, og bed derefter om at bruge en af de returnerede sider, før du prøver et side-specifikt værktøj igen.
Endnu et tilfælde, der er værd at vide om, selvom det ikke er en fejl: hvis browseren ikke åbner automatisk, er du sandsynligvis i en headless eller fjernsession (SSH, en container). Autorisations-URL'en udskrives til terminalen, der kører serveren. Åbn den manuelt.
Kørsel af mere end én PushEngage-konto eller klient
Hvis du administrerer PushEngage for mere end ét brand, eller hvis du er et bureau, der kører MCP mod flere klientkonti, er løsningen PE_MCP_CONFIG_PATH fra tidligere: registrer serveren under to forskellige navne, hver med sin egen sti, så tokens ikke kolliderer.
{
"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 ind under hvert servernavn separat, og godkend den PushEngage-konto, du vælger i browseren, hver gang. Hver serverpost gemmer sin egen tokenfil, så skift mellem klientkonti er et spørgsmål om, hvilket værktøjsnavn du kalder, ikke en gen-login hver gang. Hvis dette er din faktiske brugssituation, har serien en komplet gennemgang af kørsel af flere PushEngage-klientkonti fra en enkelt AI-assistent.
Hvad du skal gøre, når du er forbundet
Med godkendelse udført og en side valgt, opdeles de 27 værktøjer i et par praktiske grupper, der er værd at kende ved navn, ikke kun ved antal.
Til det daglige arbejde med at køre kampagner dækker serien, hvordan man sender og planlægger push-notifikationer fra din AI-assistent i stedet for dashboardet, og hvordan man A/B-tester push-notifikationer og lader AI vælge vinderen baseret på klikrate. Til opbygning af din liste er der en komplet guide til opbygning af abonnentsegmenter på almindeligt dansk.
Til måling, læs push-notifikationsanalyser via din AI-assistent gennemgår livstidsoversigter og dag-til-dag tidsserier. Det er de samme analyseværktøjer, der gør et A/B-testresultat eller en kampagneafsendelse værd at rapportere om, ikke kun at køre. Serien dækker også revision af drypkampagner og arbejdsgange for at tjekke, hvad der faktisk er aktivt, og administration af chat-widgetten, der viser WhatsApp og andre kanaler på webstedet.
Til side-niveau arbejde, ændring af PushEngage-sideindstillinger fra en AI-assistent dækker tidszone, geolokation og konfiguration af service worker. Og hvis du sætter dette op for mere end én PushEngage-konto, går det agentur-fokuserede indlæg om kørsel af flere PushEngage-klientkonti fra en enkelt AI-assistent (linket ovenfor) dybere end konfigurationseksemplet i denne guide.
Hvis du sætter dette op for en mindre teknisk person (en grundlægger, der ønsker, at AI-assistenten skal håndtere PushEngage dagligt uden selv at røre ved en konfigurationsfil), er en ikke-teknisk grundlæggers første uge med PushEngage MCP den narrative version af den samme opsætning, skrevet til den læser.
Opsætning fungerer i sig selv på samme måde uanset din PushEngage-plan. Hver PushEngage-plan, inklusive gratisniveauet, understøtter MCP-serveren. Hvis du beslutter dig for, hvilken plan der passer, før du tilslutter noget, har PushEngages prisside de aktuelle niveauer.
