Sie haben Claude Desktop, Claude Code oder Cursor bereits mehr Stunden am Tag geöffnet als das PushEngage-Dashboard. Jedes Mal, wenn Sie eine Klickrate überprüfen oder eine Benachrichtigung senden müssen, wechseln Sie zum Fenster, in dem die eigentliche Arbeit stattfindet. Die PushEngage MCP-Einrichtung schließt diese Lücke: ein npx-Befehl, eine Browser-Anmeldung, und die Tools von PushEngage befinden sich in derselben Chatsitzung, die Sie bereits zum Schreiben von Code, Debuggen eines Workflows oder Beantworten einer Frage Ihres Teams verwenden.
Dies ist die vollständige Einrichtungsanleitung: Installation, die beiden Umgebungsvariablen, die Sie kennen sollten, die erste Anmeldung und die drei spezifischen Dinge, die die Verbindung unterbrechen, wenn sie nicht sofort funktioniert. Am Ende haben Sie eine authentifizierte Sitzung mit einer ausgewählten Website, nicht nur eine grüne „verbunden“-Anzeige.
Was Sie tun können, sobald Sie verbunden sind
@pushengage/mcp bietet 27 Tools in 10 Domänen, und sobald Sie gegen eine Website authentifiziert sind, ist jedes davon einen Satz entfernt, anstatt einen Dashboard-Klick entfernt. Hier sind einige Beispiele, wie das nach Abschluss der Einrichtung aussieht:
- Senden Sie jetzt eine Push-Benachrichtigung, planen Sie sie für eine bestimmte Zeit oder richten Sie einen wiederkehrenden Versand ein – in der lokalen Zeitzone jedes Abonnenten, wenn Sie dies wünschen.
- Führen Sie einen A/B-Test zwischen zwei Schlagzeilen durch und lassen Sie den Assistenten die Klickrate melden, sobald die Ergebnisse vorliegen.
- Erstellen Sie ein Segment oder eine Zielgruppe anhand einer Beschreibung in natürlicher Sprache anstelle einer Benutzeroberfläche mit Regeln.
- Rufen Sie Analysen als lebenslange Zusammenfassung oder als tägliche Zeitreihe ab.
- Listen Sie Ihre Drip-Kampagnen, Trigger-Kampagnen und Workflows auf, um zu überprüfen, was tatsächlich läuft.
- Lesen Sie die Einstellungen Ihrer Website, die Service-Worker-Konfiguration und die Chat-Widget-Einrichtung.
Nichts davon erfordert, dass der Assistent Ihr PushEngage-Passwort hat, und nichts davon erfordert, dass Sie Ihren Editor oder Ihr Terminal verlassen. PushEngage betreibt diese Integration für einen Kundenstamm von über 25.000 Geschäftsinhabern in über 150 Ländern und versendet in den letzten 30 Tagen 15,2 Milliarden Benachrichtigungen. Der MCP-Server spricht mit derselben Produktions-API, auf der dieses Volumen läuft, nicht mit einer Sandbox-Demo.
Bevor Sie beginnen: Was Sie brauchen
Drei Dinge, und Sie haben wahrscheinlich bereits mindestens zwei davon:
- Ein PushEngage-Konto – kostenlos oder bezahlt, mit mindestens einer hinzugefügten Website. Der MCP-Server erstellt keine Website für Sie; er arbeitet mit Websites, die Sie bereits in Ihrem PushEngage-Dashboard eingerichtet haben.
- Node.js 18 oder neuer – der Assistent führt den Server über
npxaus, das mit Node geliefert wird. Überprüfen Sie dies mitnode -vin einem Terminal. - Ein MCP-fähiger Client – Claude Desktop, Claude Code, Cursor oder ein anderer Client, der MCP über Standard-Ein-/Ausgabe (stdio) spricht.
Eine Sache, die man klarstellen sollte, bevor Sie mit der Bearbeitung von Konfigurationsdateien beginnen: @pushengage/mcp läuft lokal auf Ihrem Computer über stdio. Es gibt keinen Remote-Server, auf den Sie verweisen können, und keine gehostete Connector-URL. Der Client startet den Prozess, und der Prozess spricht im Auftrag von PushEngage mit der API. Wenn eine Einrichtungsanleitung für ein anderes Tool Sie auffordert, einen Remote-Endpunkt einzufügen, handelt es sich um eine andere Art von MCP-Server als diese.
Einrichten des Servers in Claude Desktop, Claude Code und Cursor
Keine globale Installation. npx ruft @pushengage/mcp bei Bedarf ab, wenn Ihr Client ihn zum ersten Mal startet, und verwendet den genauen Befehl npx -y @pushengage/mcp. Sie fügen diesen Befehl zur MCP-Konfiguration Ihres Clients hinzu, starten den Client neu, und der Server erscheint in Ihrer Tool-Liste.
Jeder Client speichert seine Konfiguration an einem anderen Ort.
Claude Desktop
Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json unter macOS (oder den entsprechenden Pfad auf Ihrer Plattform):
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Starten Sie Claude Desktop neu. Der Server „pushengage“ sollte in Ihrer Tool-Liste erscheinen.
Cursor
Bearbeiten Sie ~/.cursor/mcp.json:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Code
Claude Code spricht MCP über stdio genauso wie Claude Desktop und Cursor, daher funktioniert die gleiche command/args-Struktur, wenn Sie seine MCP-Konfigurationsdatei direkt bearbeiten. Wenn Sie es vorziehen, JSON nicht von Hand zu bearbeiten, akzeptiert Claude Code Server auch über seinen eigenen CLI-Befehl claude mcp add, was ein allgemeines Verhalten von Claude Code ist und nichts Spezifisches für PushEngage. Schauen Sie in die Dokumentation von Claude Code, um die genaue Flag-Syntax zu erfahren, wenn Sie diesen Weg wählen.
Jeder andere MCP-Client
Wenn Ihr Client keiner der drei oben genannten ist, ist die zugrunde liegende Anforderung überall gleich: Konfigurieren Sie ihn so, dass er npx -y @pushengage/mcp als stdio-Server ausführt. Das ist der gesamte Installationsschritt, unabhängig davon, welcher Client die Konfiguration liest.
Benennen der Verbindung und Isolieren von Tokens: PE_MCP_CLIENT_NAME und PE_MCP_CONFIG_PATH
Über die Installation hinaus ist keine weitere Konfiguration erforderlich. Der Server spricht standardmäßig mit der Produktions-API von PushEngage; für seltenere Setups gibt es zwei Umgebungsvariablen:
| Umgebungsvariable | Standard | Zweck |
|---|---|---|
PE_MCP_CLIENT_NAME | KI-Assistent | Die Bezeichnung, die auf dem PushEngage-Autorisierungsbildschirm als die App angezeigt wird, die Zugriff anfordert. Legen Sie sie fest, wenn Sie etwas Spezifischeres wünschen, z. B. "Claude Desktop". |
PE_MCP_CONFIG_PATH | ~/.pushengage/mcp.json | Wo das Zugriffstoken gespeichert ist. Legen Sie dies fest, um mehr als ein PushEngage-Konto nebeneinander zu betreiben. Muss ein absoluter Pfad sein – keine ~-Erweiterung. |
Die meisten Einzelkonten-Setups müssen keine der beiden Variablen berühren. PE_MCP_CLIENT_NAME ist eine kosmetische Annehmlichkeit, nützlich, wenn Sie möchten, dass auf dem Autorisierungsbildschirm etwas Lesbareres als „KI-Assistent“ steht, wenn Sie derjenige sind, der auf „Autorisieren“ klickt. PE_MCP_CONFIG_PATH ist wichtig, sobald Sie eine zweite, separate Token-Datei benötigen, was genau der nächste Fall ist.
Erste Ausführung: anmelden und eine Website auswählen
Die Authentifizierung erfolgt browserbasiert, sodass der Assistent niemals Ihr PushEngage-Passwort sieht. Der Ablauf besteht aus drei Schritten, und es lohnt sich, genauer zu betrachten, was jeder Schritt tatsächlich im Hintergrund aufruft:
- Bitten Sie den Assistenten, sich anzumelden. In einfacher Sprache: „Melde mich bei PushEngage an.“ Dies ruft
pushengage_auth_loginauf, was einen Browser-Tab zur PushEngage-Autorisierungsseite öffnet. - Klicken Sie auf „Autorisieren“. Das Dashboard sendet das Token als POST-Anfrage an den Server – es erscheint niemals in einer URL, im Browserverlauf oder im Zugriffsprotokoll. Das Token wird lokal mit
0600-Berechtigungen gespeichert, die nur von Ihrem Benutzer gelesen werden können. - Bitten Sie den Assistenten, Ihre Websites anzuzeigen, und wählen Sie dann eine aus. „Zeige meine PushEngage-Websites“ ruft
pushengage_list_sitesauf; „Verwende Website 12345“ ruftpushengage_select_siteauf. Die Auswahl wird über Neustarts hinweg gespeichert, und jedes websitebezogene Tool wirkt darauf, es sei denn, Sie übergeben explizit eine anderesite_id.
Die beteiligten Tools, nach Namen:
| Werkzeug | Zweck |
|---|---|
pushengage_auth_login | Öffnet den Browser zu PushEngage und speichert das Token bei Erfolg. |
pushengage_auth_status | Zeigt an, ob Sie authentifiziert sind und welche Website derzeit ausgewählt ist. |
pushengage_list_sites | Listet die PushEngage-Websites auf, auf die Ihr Konto zugreifen kann. |
pushengage_select_site | Legt die aktuelle Website fest, auf die sich die anderen Tools auswirken werden. |
Sobald Sie eine Website ausgewählt haben, führen Sie pushengage_auth_status aus (die Frage „Wie ist mein PushEngage-Authentifizierungsstatus?“ reicht aus) und bestätigen Sie, dass sowohl eine authentifizierte Sitzung als auch eine ausgewählte Website gemeldet werden, bevor Sie etwas anderes versuchen. Das ist die eigentliche Ziellinie für die Einrichtung, nicht der Moment, in dem der Client den Server zum ersten Mal als verbunden anzeigt.
Fehlerbehebung nach Ursache
Die meisten Verbindungsprobleme lassen sich auf eine von drei spezifischen Ursachen zurückführen. Diagnostizieren Sie in dieser Reihenfolge.
Der Server stellt überhaupt keine Verbindung her und Ihr Client zeigt „Verbindung geschlossen“ an. Dies ist fast immer ein PATH-Problem, kein Fehler im Server. Claude Desktop, Cursor und ähnliche Clients werden von Ihrem Dock oder Finder gestartet, nicht von einem Terminal, sodass sie niemals die Startdateien Ihrer Shell laden. Wenn Node über einen Versionsmanager (nvm, fnm, volta) installiert wurde, kann der Client npx überhaupt nicht finden. Der Prozess startet nie, und Sie erhalten eine generische Verbindungsfehlermeldung anstelle einer klaren Meldung „Befehl nicht gefunden“. Führen Sie which npx in einem Terminal aus, um den absoluten Pfad zu erhalten, und leiten Sie Ihren Client dann direkt darauf:
{
"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"
}
}
}
}Starten Sie den Client nach der Bearbeitung neu. Wenn which npx stattdessen einen Pfad unter /usr/local/bin oder /opt/homebrew/bin ausgibt, ist ein Versionsmanager wahrscheinlich nicht Ihr Problem; überprüfen Sie die MCP-Protokolle des Clients selbst auf den tatsächlichen Fehler.
[AUTH_EXPIRED]. Ihr Token ist abgelaufen. Bitten Sie den Assistenten, sich erneut anzumelden – das ist die gesamte Lösung.
[NO_SITE_SELECTED]. Sie sind authentifiziert, aber es wurde noch keine Website ausgewählt. Rufen Sie pushengage_list_sites auf, wählen Sie dann eine der zurückgegebenen Websites aus, bevor Sie erneut ein Tool verwenden, das sich auf eine Website bezieht.
Ein weiterer Fall, der es wert ist, bekannt zu sein, auch wenn es kein Fehler ist: Wenn sich der Browser nicht automatisch öffnet, befinden Sie sich wahrscheinlich in einer Headless- oder Remote-Sitzung (SSH, ein Container). Die Autorisierungs-URL wird im Terminal ausgegeben, auf dem der Server ausgeführt wird. Öffnen Sie sie manuell.
Mehrere PushEngage-Konten oder Clients gleichzeitig ausführen
Wenn Sie PushEngage für mehr als eine Marke verwalten oder eine Agentur sind, die MCP für mehrere Kundenkonten ausführt, ist die Lösung PE_MCP_CONFIG_PATH von früher: Registrieren Sie den Server unter zwei verschiedenen Namen, jeweils mit eigenem Pfad, damit die Tokens nicht kollidieren.
{
"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)"
}
}
}
}Melden Sie sich separat unter jedem Servernamen an und autorisieren Sie jedes Mal das PushEngage-Konto, das Sie im Browser auswählen. Jeder Servereintrag speichert seine eigene Token-Datei. Das Wechseln zwischen Kundenkonten ist daher eine Frage des aufgerufenen Toolnamens und kein erneutes Anmelden jedes Mal. Wenn dies Ihr tatsächlicher Anwendungsfall ist, enthält die Serie eine vollständige Anleitung zum Ausführen mehrerer PushEngage-Kundenkonten von einem KI-Assistenten aus.
Was zu tun ist, sobald Sie verbunden sind
Nachdem die Authentifizierung abgeschlossen und eine Website ausgewählt wurde, lassen sich die 27 Tools in einige praktische Gruppen aufteilen, die es wert sind, namentlich bekannt zu sein, nicht nur nach Anzahl.
Für die tägliche Arbeit bei der Durchführung von Kampagnen behandelt die Serie, wie Sie Push-Benachrichtigungen von Ihrem KI-Assistenten aus senden und planen anstelle des Dashboards und wie Sie Push-Benachrichtigungen A/B-testen und die KI den Gewinner nach Klickrate auswählen lassen. Zum Aufbau Ihrer Liste gibt es eine vollständige Anleitung zum Erstellen von Abonnentensegmenten in einfacher Sprache.
Für die Messung führt Push-Benachrichtigungsanalysen über Ihren KI-Assistenten lesen durch Lebenszusammenfassungen und tägliche Zeitreihen. Dies sind dieselben Analysetools, die ein A/B-Testergebnis oder einen Kampagnenversand berichtenswert machen, nicht nur die Ausführung. Die Serie behandelt auch die Überprüfung von Drip-Kampagnen und Workflows, um zu sehen, was tatsächlich aktiv ist, und die Verwaltung des Chat-Widgets, das WhatsApp und andere Kanäle auf der Website anzeigt.
Für die Website-Arbeit behandelt PushEngage-Website-Einstellungen von einem KI-Assistenten aus ändern Zeitzone, Geolocation und Service-Worker-Konfiguration. Und wenn Sie dies für mehr als ein PushEngage-Konto einrichten, geht der Agentur-fokussierte Beitrag zum Ausführen mehrerer PushEngage-Kundenkonten von einem KI-Assistenten aus (oben verlinkt) tiefer als das Konfigurationsbeispiel in dieser Anleitung.
Wenn Sie dies für jemanden einrichten, der weniger technisch versiert ist (ein Gründer, der möchte, dass der KI-Assistent PushEngage täglich verwaltet, ohne selbst eine Konfigurationsdatei zu berühren), ist Die erste Woche eines nicht-technischen Gründers mit PushEngage MCP die narrative Version dieses Setups, geschrieben für diesen Leser.
Die Einrichtung selbst funktioniert unabhängig von Ihrem PushEngage-Plan. Jeder PushEngage-Plan, einschließlich der kostenlosen Stufe, unterstützt den MCP-Server. Wenn Sie entscheiden, welcher Plan passt, bevor Sie etwas verbinden, finden Sie auf der Preisgestaltungs-Seite von PushEngage die aktuellen Stufen.
