Du har redan Claude Desktop, Claude Code eller Cursor öppet fler timmar om dagen än PushEngage-instrumentpanelen. Varje gång du behöver kontrollera en klickfrekvens eller skicka en avisering, växlar du bort från fönstret där det faktiska arbetet pågår. PushEngage MCP-inställning stänger det gapet: ett npx-kommando, en webbläsarinloggning, och PushEngages verktyg sitter i samma chatt-session som du redan använder för att skriva kod, felsöka ett arbetsflöde eller svara på en fråga från ditt team.
Det här är den kompletta installationsguiden: installation, de två miljövariablerna värda att känna till, den första inloggningen och de tre specifika sakerna som bryter anslutningen när den inte bara fungerar vid första försöket. I slutet kommer du att ha en autentiserad session med en vald webbplats, inte bara en grön "ansluten"-indikator.
Vad du kommer att kunna göra när du är ansluten
@pushengage/mcp levererar 27 verktyg inom 10 domäner, och när du väl är autentiserad mot en webbplats är alla av dem en mening bort istället för ett klick på instrumentpanelen. Några exempel på hur det ser ut när installationen är klar:
- Skicka en push-avisering nu, schemalägg den för en specifik tid, eller ställ in en återkommande sändning - i varje prenumerants lokala tidszon om du ber om det.
- Kör ett A/B-test mellan två rubriker och låt assistenten rapportera tillbaka klickfrekvensen när resultaten är klara.
- Bygg ett segment eller en målgrupp från en vanlig språkbeskrivning istället för ett regelgränssnitt.
- Hämta analyser som en livstidssammanfattning eller som en daglig tidsserie.
- Lista dina droppkampanjer, utlösta kampanjer och arbetsflöden för att kontrollera vad som faktiskt körs.
- Läs din webbplats inställningar, service worker-konfiguration och chattwidget-inställningar.
Inget av detta kräver att assistenten har ditt PushEngage-lösenord, och inget av det kräver att du lämnar din redigerare eller terminal. PushEngage driver denna integration för en kontobas på över 25 000 företagare i över 150 länder, och skickar 15,2 miljarder aviseringar under de senaste 30 dagarna. MCP-servern kommunicerar med samma produktions-API som volymen körs på, inte en sandlådad demo.
Innan du börjar: vad du behöver
Tre saker, och du har troligen redan minst två av dem:
- Ett PushEngage-konto - gratis eller betalt, med minst en webbplats tillagd. MCP-servern skapar ingen webbplats åt dig; den fungerar på webbplatser som du redan har ställt in i din PushEngage-instrumentpanel.
- Node.js 18 eller nyare - assistenten kör servern via
npx, som levereras med Node. Kontrollera mednode -vi en terminal. - En MCP-kapabel klient — Claude Desktop, Claude Code, Cursor eller annan klient som kommunicerar MCP via standard input/output (stdio).
En sak som är värd att säga rakt ut innan du börjar redigera konfigurationsfiler: @pushengage/mcp körs lokalt på din maskin via stdio. Det finns ingen fjärrserver att peka på och ingen värdbaserad anslutnings-URL. Klienten startar processen, och processen kommunicerar med PushEngages API å dina vägnar. Om en installationsguide för ett annat verktyg säger åt dig att klistra in en fjärrslutpunkt, är det en annan typ av MCP-server än den här.
Konfigurera servern i Claude Desktop, Claude Code och Cursor
Ingen global installation. npx hämtar @pushengage/mcp vid behov första gången din klient startar den, med exakt kommandot npx -y @pushengage/mcp. Du lägger till det kommandot i din klients MCP-konfiguration, startar om klienten, och servern visas i din verktygslista.
Varje klient lagrar sin konfiguration på en annan plats.
Claude Desktop
Redigera ~/Library/Application Support/Claude/claude_desktop_config.json på macOS (eller motsvarande sökväg på din plattform):
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Starta om Claude Desktop. Servern "pushengage" bör visas i din verktygslista.
Markör
Redigera ~/.cursor/mcp.json:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Code
Claude Code kommunicerar MCP via stdio på samma sätt som Claude Desktop och Cursor gör, så samma command/args-form fungerar om du redigerar dess MCP-konfigurationsfil direkt. Om du hellre vill slippa redigera JSON manuellt, accepterar Claude Code även servrar via sitt eget CLI-kommando claude mcp add, vilket är allmänt beteende för Claude Code snarare än något specifikt för PushEngage. Kontrollera Claude Codes egna dokumentation för exakt flaggsyntax om du väljer den vägen.
Annan MCP-klient
Om din klient inte är en av de tre ovanstående, är det underliggande kravet detsamma överallt: konfigurera den att köra npx -y @pushengage/mcp som en stdio-server. Det är hela installationssteget, oavsett vilken klient som läser konfigurationen.
Namnge anslutningen och isolera tokens: PE_MCP_CLIENT_NAME och PE_MCP_CONFIG_PATH
Ingen konfiguration utöver installationssteget krävs. Servern kommunicerar med PushEngages produktions-API som standard; två miljövariabler finns för mindre vanliga installationer:
| Miljövariabel | Standard | Syfte |
|---|---|---|
PE_MCP_CLIENT_NAME | AI-assistent | Etiketten som visas på PushEngages auktoriseringsskärm som appen som begär åtkomst. Ställ in den om du vill ha något mer specifikt, som "Claude Desktop". |
PE_MCP_CONFIG_PATH | ~/.pushengage/mcp.json | Var åtkomsttoken lagras. Ställ in detta för att köra fler än ett PushEngage-konto sida vid sida. Måste vara en absolut sökväg — ingen ~-expansion. |
De flesta enskilda kontokonfigurationer behöver aldrig röra någon av variablerna. PE_MCP_CLIENT_NAME är en kosmetisk bekvämlighet, användbar om du vill att auktoriseringsskärmen ska visa något mer läsbart än "AI-assistent" när det är du som klickar på Auktorisera. PE_MCP_CONFIG_PATH spelar roll i det ögonblick du behöver en andra, separat tokenfil, vilket är exakt fallet som täcks härnäst.
Första körningen: logga in och välja en webbplats
Autentisering är webbläsarbaserad, så assistenten ser aldrig ditt PushEngage-lösenord. Flödet är tre steg, och det är värt att gå igenom vad varje steg faktiskt anropar under huven:
- Be assistenten att logga in. På vanligt språk: "Logga in mig på PushEngage." Detta anropar
pushengage_auth_login, som öppnar en webbläsarflik till PushEngage-auktorisationssidan. - Klicka på Auktorisera. Instrumentpanelen skickar token till servern som en POST-begäran — den visas aldrig i en URL, webbhistorik eller åtkomstlogg. Token sparas lokalt med
0600-behörigheter, läsbar endast av din användare. - Be assistenten att visa dina webbplatser, välj sedan en. "Visa mina PushEngage-webbplatser" anropar
pushengage_list_sites; "Använd webbplats 12345" anroparpushengage_select_site. Valet sparas mellan omstarter, och varje webbplats-specifikt verktyg agerar på det om du inte uttryckligen anger en annansite_id.
De inblandade verktygen, efter namn:
| Verktyg | Syfte |
|---|---|
pushengage_auth_login | Öppnar webbläsaren till PushEngage och lagrar token vid lyckat resultat. |
pushengage_auth_status | Visar om du är autentiserad och vilken webbplats som för närvarande är vald. |
pushengage_list_sites | Listar PushEngage-webbplatser som ditt konto kan komma åt. |
pushengage_select_site | Ställer in den aktuella webbplatsen som de andra verktygen kommer att agera på. |
När du har valt en webbplats, kör pushengage_auth_status (att fråga "vad är min PushEngage-autentiseringsstatus" räcker) och bekräfta att den rapporterar både en autentiserad session och en vald webbplats innan du försöker något annat. Det är den faktiska mållinjen för installationen, inte ögonblicket då klienten först visar servern som ansluten.
Felsökning, efter orsak
De flesta anslutningsproblem spåras tillbaka till en av tre specifika orsaker. Diagnostisera i denna ordning.
Servern ansluter inte alls, och din klient visar "Anslutning stängd." Detta är nästan alltid ett PATH-problem, inte en bugg i servern. Claude Desktop, Cursor och liknande klienter startas från din Dock eller Finder, inte från en terminal, så de laddar aldrig dina skal-startfiler. Om Node installerades via en versionshanterare (nvm, fnm, volta), kan klienten inte hitta npx alls. Processen startar aldrig, och du får ett generiskt anslutningsfel istället för ett tydligt "kommando hittades inte". Kör which npx i en terminal för att få den absoluta sökvägen, peka sedan din klient direkt 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"
}
}
}
}Starta om klienten efter redigering. Om which npx istället skriver ut en sökväg under /usr/local/bin eller /opt/homebrew/bin, är en versionshanterare troligen inte ditt problem; kontrollera klientens egna MCP-loggar för det faktiska felet.
[AUTH_EXPIRED]. Din token har gått ut. Be assistenten att logga in igen — det är hela lösningen.
[NO_SITE_SELECTED]. Du är autentiserad, men ingen webbplats är vald ännu. Anropa pushengage_list_sites, be sedan om att få använda en av de returnerade webbplatserna, innan du försöker använda något webbplats-specifikt verktyg igen.
Ännu ett fall värt att känna till, även om det inte är ett fel: om webbläsaren inte öppnas automatiskt, befinner du dig troligen i en headless- eller fjärrsession (SSH, en container). Auktoriserings-URL:en skrivs ut i terminalen som kör servern. Öppna den manuellt.
Köra fler än ett PushEngage-konto eller klient
Om du hanterar PushEngage för mer än ett varumärke, eller om du är en byrå som kör MCP mot flera klientkonton, är lösningen PE_MCP_CONFIG_PATH från tidigare: registrera servern under två olika namn, var och en med sin egen sökväg så att token inte kolliderar.
{
"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)"
}
}
}
}Logga in under varje servernamn separat, auktorisera vilket PushEngage-konto du än väljer i webbläsaren varje gång. Varje serverpost behåller sin egen tokenfil, så att växla mellan klientkonton är en fråga om vilket verktygsnamn du anropar, inte en om-inloggning varje gång. Om detta är ditt faktiska användningsfall, har serien en fullständig genomgång av att köra flera PushEngage-klientkonton från en AI-assistent.
Vad du ska göra när du är ansluten
Med autentisering klar och en webbplats vald, delas de 27 verktygen in i några praktiska grupper som är värda att känna till vid namn, inte bara till antalet.
För det dagliga arbetet med att köra kampanjer, täcker serien hur man skickar och schemalägger push-notiser från din AI-assistent istället för instrumentpanelen, och hur man A/B-testar push-notiser och låter AI välja vinnaren baserat på klickfrekvens. För att bygga din lista finns en komplett guide för att bygga segment av prenumeranter på enkel svenska.
För mätning, läs analysdata för push-notiser via din AI-assistent går igenom livstidssammanfattningar och dagliga tidsserier. Det är samma analysverktyg som gör att ett A/B-testresultat eller en kampanjutskick är värt att rapportera om, inte bara att köra. Serien täcker också granskning av drip-kampanjer och arbetsflöden för att kontrollera vad som faktiskt är aktivt, och hantering av chattwidgeten som visar WhatsApp och andra kanaler på webbplatsen.
För webbplatsnivåarbete, täcker ändra PushEngage-webbplatsinställningar från en AI-assistent tidszon, geolokalisering och konfiguration av service worker. Och om du konfigurerar detta för mer än ett PushEngage-konto, går det byråfokuserade inlägget om att köra flera PushEngage-klientkonton från en AI-assistent (länkat ovan) djupare än konfigurationsexemplet i den här guiden.
Om du konfigurerar detta för någon mindre teknisk (en grundare som vill att AI-assistenten ska hantera PushEngage dagligen utan att själv röra en konfigurationsfil), är en icke-teknisk grundares första vecka med PushEngage MCP den narrativa versionen av samma konfiguration, skriven för den läsaren.
Installationen fungerar i sig på samma sätt oavsett din PushEngage-plan. Varje PushEngage-plan, inklusive gratisnivån, stöder MCP-servern. Om du bestämmer dig för vilken plan som passar innan du ansluter något, har PushEngages prissida de aktuella nivåerna.
