Έχετε ήδη το Claude Desktop, το Claude Code ή το Cursor ανοιχτά περισσότερες ώρες την ημέρα από τον πίνακα ελέγχου του PushEngage. Κάθε φορά που χρειάζεται να ελέγξετε ένα ποσοστό κλικ ή να στείλετε μια ειδοποίηση, απομακρύνεστε από το παράθυρο όπου γίνεται η πραγματική εργασία. Η ρύθμιση του PushEngage MCP κλείνει αυτό το κενό: μια εντολή npx, μια σύνδεση μέσω προγράμματος περιήγησης και τα εργαλεία του PushEngage βρίσκονται μέσα στην ίδια συνεδρία συνομιλίας που ήδη χρησιμοποιείτε για να γράψετε κώδικα, να διορθώσετε μια ροή εργασίας ή να απαντήσετε σε μια ερώτηση από την ομάδα σας.
Αυτός είναι ο πλήρης οδηγός εγκατάστασης: εγκατάσταση, οι δύο μεταβλητές περιβάλλοντος που αξίζει να γνωρίζετε, η πρώτη σύνδεση και τα τρία συγκεκριμένα πράγματα που διακόπτουν τη σύνδεση όταν δεν λειτουργεί με την πρώτη προσπάθεια. Στο τέλος, θα έχετε μια πιστοποιημένη συνεδρία με επιλεγμένο ιστότοπο, όχι απλώς μια πράσινη ένδειξη “συνδέθηκε”.
Τι θα μπορείτε να κάνετε μόλις συνδεθείτε
Το @pushengage/mcp διαθέτει 27 εργαλεία σε 10 τομείς, και μόλις πιστοποιηθείτε σε έναν ιστότοπο, όλα είναι σε απόσταση μιας πρότασης αντί για ένα κλικ στον πίνακα ελέγχου. Μερικά παραδείγματα του πώς μοιάζει αυτό μόλις ολοκληρωθεί η ρύθμιση:
- Στείλτε μια ειδοποίηση push τώρα, προγραμματίστε την για μια συγκεκριμένη ώρα ή ρυθμίστε μια επαναλαμβανόμενη αποστολή — στην τοπική ζώνη ώρας κάθε συνδρομητή, αν το ζητήσετε.
- Εκτελέστε μια δοκιμή A/B μεταξύ δύο τίτλων και αφήστε τον βοηθό να αναφέρει το ποσοστό κλικ μόλις ληφθούν τα αποτελέσματα.
- Δημιουργήστε ένα τμήμα ή μια ομάδα κοινού από μια περιγραφή σε απλή γλώσσα αντί για ένα UI κανόνων.
- Ανακτήστε αναλυτικά στοιχεία ως σύνοψη διάρκειας ζωής ή ως χρονοσειρά ημέρα προς ημέρα.
- Λίστα με τις καμπάνιες σταγόνας, τις καμπάνιες ενεργοποίησης και τις ροές εργασίας σας για να ελέγξετε τι εκτελείται πραγματικά.
- Διαβάστε τις ρυθμίσεις του ιστότοπού σας, τη διαμόρφωση του service worker και τη ρύθμιση του widget συνομιλίας.
Τίποτα από αυτά δεν απαιτεί από τον βοηθό να έχει τον κωδικό πρόσβασης του PushEngage σας, και τίποτα από αυτά δεν απαιτεί να φύγετε από τον επεξεργαστή ή το τερματικό σας. Το PushEngage εκτελεί αυτήν την ενσωμάτωση για μια βάση λογαριασμών με πάνω από 25.000 ιδιοκτήτες επιχειρήσεων σε 150+ χώρες, στέλνοντας 15,2 δισεκατομμύρια ειδοποιήσεις τις τελευταίες 30 ημέρες. Ο διακομιστής MCP επικοινωνεί με το ίδιο API παραγωγής στο οποίο λειτουργεί αυτός ο όγκος, όχι με ένα demo σε sandbox.
Πριν ξεκινήσετε: τι χρειάζεστε
Τρία πράγματα, και πιθανότατα έχετε ήδη τουλάχιστον δύο από αυτά:
- Ένας λογαριασμός PushEngage — δωρεάν ή επί πληρωμή, με τουλάχιστον έναν ιστότοπο προστιθέμενο. Ο διακομιστής MCP δεν δημιουργεί ιστότοπο για εσάς· λειτουργεί σε ιστότοπους που έχετε ήδη ρυθμίσει στον πίνακα ελέγχου του PushEngage.
- Node.js 18 ή νεότερη έκδοση — ο βοηθός εκτελεί τον διακομιστή μέσω
npx, το οποίο έρχεται με το Node. Ελέγξτε μεnode -vσε ένα τερματικό. - Ένας πελάτης συμβατός με MCP — Claude Desktop, Claude Code, Cursor ή οποιοσδήποτε άλλος πελάτης που μιλάει MCP μέσω τυπικής εισόδου/εξόδου (stdio).
Ένα πράγμα που αξίζει να αναφερθεί ευθέως πριν ξεκινήσετε την επεξεργασία αρχείων διαμόρφωσης: το @pushengage/mcp εκτελείται τοπικά στη μηχανή σας μέσω stdio. Δεν υπάρχει απομακρυσμένος διακομιστής για να δείξετε και καμία φιλοξενούμενη διεύθυνση URL σύνδεσης. Ο πελάτης εκκινεί τη διαδικασία και η διαδικασία μιλάει με το API του PushEngage εκ μέρους σας. Εάν ένας οδηγός εγκατάστασης για ένα διαφορετικό εργαλείο σας λέει να επικολλήσετε ένα απομακρυσμένο τελικό σημείο, αυτό είναι ένα διαφορετικό είδος διακομιστή MCP από αυτόν.
Ρύθμιση του διακομιστή σε Claude Desktop, Claude Code και Cursor
Καμία καθολική εγκατάσταση. Το npx ανακτά το @pushengage/mcp κατά παραγγελία την πρώτη φορά που ο πελάτης σας το εκκινεί, χρησιμοποιώντας την ακριβή εντολή npx -y @pushengage/mcp. Προσθέτετε αυτήν την εντολή στη διαμόρφωση MCP του πελάτη σας, επανεκκινείτε τον πελάτη και ο διακομιστής εμφανίζεται στη λίστα εργαλείων σας.
Κάθε πελάτης διατηρεί τη διαμόρφωσή του σε διαφορετικό μέρος.
Claude Desktop
Επεξεργαστείτε το ~/Library/Application Support/Claude/claude_desktop_config.json στο macOS (ή την αντίστοιχη διαδρομή στην πλατφόρμα σας):
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Επανεκκινήστε το Claude Desktop. Ο διακομιστής "pushengage" θα πρέπει να εμφανιστεί στη λίστα εργαλείων σας.
Δείκτης
Επεξεργαστείτε το ~/.cursor/mcp.json:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Code
Το Claude Code μιλάει MCP μέσω stdio με τον ίδιο τρόπο που το κάνουν το Claude Desktop και το Cursor, οπότε η ίδια δομή command/args λειτουργεί αν επεξεργαστείτε απευθείας το αρχείο διαμόρφωσης MCP του. Αν προτιμάτε να μην επεξεργάζεστε χειροκίνητα JSON, το Claude Code δέχεται επίσης διακομιστές μέσω της δικής του εντολής CLI claude mcp add, η οποία είναι γενική συμπεριφορά του Claude Code και όχι κάτι συγκεκριμένο για το PushEngage. Ελέγξτε τα δικά σας έγγραφα του Claude Code για την ακριβή σύνταξη της σημαίας αν ακολουθήσετε αυτήν τη διαδρομή.
Οποιοσδήποτε άλλος πελάτης MCP
Εάν ο πελάτης σας δεν είναι ένας από τους τρεις παραπάνω, η υποκείμενη απαίτηση είναι η ίδια παντού: διαμορφώστε τον για να εκτελέσει npx -y @pushengage/mcp ως διακομιστή stdio. Αυτό είναι ολόκληρο το βήμα εγκατάστασης, ανεξάρτητα από το ποιος πελάτης διαβάζει τη διαμόρφωση.
Ονομασία της σύνδεσης και απομόνωση διακριτικών: PE_MCP_CLIENT_NAME και PE_MCP_CONFIG_PATH
Δεν απαιτείται διαμόρφωση πέρα από το βήμα εγκατάστασης. Ο διακομιστής επικοινωνεί με το παραγωγικό API του PushEngage από προεπιλογή. Υπάρχουν δύο μεταβλητές περιβάλλοντος για λιγότερο συνηθισμένες ρυθμίσεις:
| Μεταβλητή περιβάλλοντος | Προεπιλογή | Σκοπός |
|---|---|---|
PE_MCP_CLIENT_NAME | Βοηθός AI | Η ετικέτα που εμφανίζεται στην οθόνη εξουσιοδότησης του PushEngage ως η εφαρμογή που ζητά πρόσβαση. Ορίστε την αν θέλετε κάτι πιο συγκεκριμένο, όπως "Claude Desktop". |
PE_MCP_CONFIG_PATH | ~/.pushengage/mcp.json | Πού αποθηκεύεται το διακριτικό πρόσβασης. Ορίστε αυτό για να εκτελέσετε περισσότερους από έναν λογαριασμούς PushEngage παράλληλα. Πρέπει να είναι απόλυτη διαδρομή — χωρίς επέκταση ~. |
Οι περισσότερες ρυθμίσεις ενός λογαριασμού δεν χρειάζεται ποτέ να αγγίξουν καμία από τις δύο μεταβλητές. Το PE_MCP_CLIENT_NAME είναι μια καλλυντική ευκολία, χρήσιμο αν θέλετε η οθόνη εξουσιοδότησης να λέει κάτι πιο ευανάγνωστο από "Βοηθός AI" όταν είστε εσείς αυτός που πατάει Εξουσιοδότηση. Το PE_MCP_CONFIG_PATH έχει σημασία τη στιγμή που χρειάζεστε ένα δεύτερο, ξεχωριστό αρχείο διακριτικού, το οποίο είναι ακριβώς η περίπτωση που καλύπτεται στη συνέχεια.
Πρώτη εκκίνηση: σύνδεση και επιλογή ιστοτόπου
Η πιστοποίηση γίνεται μέσω του προγράμματος περιήγησης, οπότε ο βοηθός δεν βλέπει ποτέ τον κωδικό πρόσβασης PushEngage. Η ροή αποτελείται από τρία βήματα, και αξίζει να εξετάσουμε τι καλεί το καθένα στο παρασκήνιο:
- Ζητήστε από τον βοηθό να συνδεθεί. Με απλά λόγια: «Σύνδεσέ με στο PushEngage». Αυτό καλεί το
pushengage_auth_login, το οποίο ανοίγει μια καρτέλα στο πρόγραμμα περιήγησης στη σελίδα εξουσιοδότησης του PushEngage. - Κάντε κλικ στο Authorize. Ο πίνακας ελέγχου στέλνει το διακριτικό στον διακομιστή ως αίτημα POST — δεν εμφανίζεται ποτέ σε URL, ιστορικό προγράμματος περιήγησης ή αρχείο καταγραφής πρόσβασης. Το διακριτικό αποθηκεύεται τοπικά με δικαιώματα
0600, προσβάσιμο μόνο από τον χρήστη σας. - Ζητήστε από τον βοηθό να εμφανίσει τους ιστοτόπους σας και, στη συνέχεια, επιλέξτε έναν. Το «Εμφάνισε τους ιστοτόπους μου στο PushEngage» καλεί το
pushengage_list_sites· το «Χρησιμοποίησε τον ιστότοπο 12345» καλεί τοpushengage_select_site. Η επιλογή απομνημονεύεται σε επανεκκινήσεις και κάθε εργαλείο που εστιάζει σε ιστότοπο ενεργεί σε αυτήν, εκτός αν περάσετε ρητά ένα διαφορετικόsite_id.
Τα εργαλεία που εμπλέκονται, κατά όνομα:
| Εργαλείο | Σκοπός |
|---|---|
pushengage_auth_login | Ανοίγει το πρόγραμμα περιήγησης στο PushEngage και αποθηκεύει το διακριτικό σε περίπτωση επιτυχίας. |
pushengage_auth_status | Δείχνει αν είστε πιστοποιημένοι και ποιος ιστότοπος είναι επί του παρόντος επιλεγμένος. |
pushengage_list_sites | Λίστα με τους ιστοτόπους PushEngage στους οποίους έχει πρόσβαση ο λογαριασμός σας. |
pushengage_select_site | Ορίζει τον τρέχοντα ιστότοπο στον οποίο θα ενεργούν τα άλλα εργαλεία. |
Αφού επιλέξετε έναν ιστότοπο, εκτελέστε το pushengage_auth_status (αρκεί να ρωτήσετε «ποια είναι η κατάσταση πιστοποίησης PushEngage μου») και επιβεβαιώστε ότι αναφέρει τόσο μια πιστοποιημένη συνεδρία όσο και έναν επιλεγμένο ιστότοπο, προτού δοκιμάσετε οτιδήποτε άλλο. Αυτή είναι η πραγματική γραμμή τερματισμού για τη ρύθμιση, όχι η στιγμή που ο πελάτης δείχνει για πρώτη φορά ότι ο διακομιστής είναι συνδεδεμένος.
Αντιμετώπιση προβλημάτων, κατά αιτία
Τα περισσότερα προβλήματα σύνδεσης οφείλονται σε μία από τις τρεις συγκεκριμένες αιτίες. Διαγνώστε με αυτήν τη σειρά.
Ο διακομιστής δεν συνδέεται καθόλου και ο πελάτης σας εμφανίζει «Σύνδεση έκλεισε». Αυτό οφείλεται σχεδόν πάντα σε πρόβλημα PATH, όχι σε σφάλμα στον διακομιστή. Οι πελάτες Claude Desktop, Cursor και παρόμοιοι ξεκινούν από το Dock ή το Finder σας, όχι από τερματικό, οπότε δεν φορτώνουν ποτέ τα αρχεία εκκίνησης του κελύφους σας. Εάν το Node εγκαταστάθηκε μέσω ενός διαχειριστή εκδόσεων (nvm, fnm, volta), ο πελάτης δεν μπορεί να βρει καθόλου το npx. Η διαδικασία δεν ξεκινά ποτέ και λαμβάνετε ένα γενικό σφάλμα σύνδεσης αντί για ένα σαφές «εντολή δεν βρέθηκε». Εκτελέστε which npx σε ένα τερματικό για να λάβετε την απόλυτη διαδρομή και, στη συνέχεια, κατευθύνετε τον πελάτη σας απευθείας σε αυτήν:
{
"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"
}
}
}
}Επανεκκινήστε τον πελάτη μετά την επεξεργασία. Εάν το which npx εκτυπώσει αντ' αυτού μια διαδρομή κάτω από το /usr/local/bin ή το /opt/homebrew/bin, ένας διαχειριστής εκδόσεων πιθανότατα δεν είναι το πρόβλημά σας· ελέγξτε τα αρχεία καταγραφής MCP του ίδιου του πελάτη για το πραγματικό σφάλμα.
[AUTH_EXPIRED]. Το διακριτικό σας έληξε. Ζητήστε από τον βοηθό να συνδεθεί ξανά — αυτή είναι ολόκληρη η λύση.
[NO_SITE_SELECTED]. Έχετε πιστοποιηθεί, αλλά δεν έχει επιλεγεί ακόμη κανένας ιστότοπος. Καλέστε την pushengage_list_sites, στη συνέχεια ζητήστε να χρησιμοποιήσετε έναν από τους ιστότοπους που επιστράφηκαν, πριν δοκιμάσετε ξανά οποιοδήποτε εργαλείο που σχετίζεται με τον ιστότοπο.
Μια ακόμη περίπτωση που αξίζει να γνωρίζετε, παρόλο που δεν είναι σφάλμα: εάν το πρόγραμμα περιήγησης δεν ανοίξει αυτόματα, πιθανότατα βρίσκεστε σε μια κεφαλίδα ή απομακρυσμένη συνεδρία (SSH, κοντέινερ). Η διεύθυνση URL εξουσιοδότησης εκτυπώνεται στο τερματικό που εκτελεί τον διακομιστή. Ανοίξτε την χειροκίνητα.
Εκτέλεση περισσότερων από ενός λογαριασμών ή πελατών PushEngage
Εάν διαχειρίζεστε το PushEngage για περισσότερες από μία επωνυμίες, ή είστε πρακτορείο που εκτελεί το MCP σε πολλούς λογαριασμούς πελατών, η λύση είναι η PE_MCP_CONFIG_PATH από νωρίτερα: καταχωρήστε τον διακομιστή με δύο διαφορετικά ονόματα, καθένα με τη δική του διαδρομή, ώστε τα διακριτικά να μην συγκρούονται.
{
"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)"
}
}
}
}Συνδεθείτε ξεχωριστά κάτω από κάθε όνομα διακομιστή, εξουσιοδοτώντας όποιον λογαριασμό PushEngage επιλέξετε στο πρόγραμμα περιήγησης κάθε φορά. Κάθε καταχώρηση διακομιστή διατηρεί το δικό της αρχείο διακριτικών, οπότε η εναλλαγή μεταξύ λογαριασμών πελατών είναι θέμα του ονόματος του εργαλείου που καλείτε, όχι επανασύνδεση κάθε φορά. Εάν αυτή είναι η πραγματική σας περίπτωση χρήσης, η σειρά έχει μια πλήρη παρουσίαση του τρόπου εκτέλεσης πολλαπλών λογαριασμών πελατών PushEngage από έναν βοηθό AI.
Τι να κάνετε μόλις συνδεθείτε
Με την εξουσιοδότηση ολοκληρωμένη και έναν ιστότοπο επιλεγμένο, τα 27 εργαλεία χωρίζονται σε μερικές πρακτικές ομάδες που αξίζει να γνωρίζετε με το όνομά τους, όχι μόνο με τον αριθμό τους.
Για την καθημερινή εργασία της εκτέλεσης καμπανιών, η σειρά καλύπτει πώς να στέλνετε και να προγραμματίζετε ειδοποιήσεις push από τον βοηθό AI σας αντί για τον πίνακα ελέγχου, και πώς να κάνετε A/B test ειδοποιήσεων push και να αφήνετε την AI να επιλέγει τον νικητή με βάση το ποσοστό κλικ. Για τη δημιουργία της λίστας σας, υπάρχει ένας πλήρης οδηγός για δημιουργία τμημάτων συνδρομητών σε απλή γλώσσα.
Για τη μέτρηση, ανάγνωση αναλυτικών στοιχείων ειδοποιήσεων push μέσω του βοηθού AI σας παρουσιάζει περιλήψεις διάρκειας ζωής και χρονοσειρές ημέρα προς ημέρα. Αυτά είναι τα ίδια εργαλεία αναλυτικών που κάνουν ένα αποτέλεσμα A/B test ή μια αποστολή καμπάνιας άξια αναφοράς, όχι απλώς εκτέλεσης. Η σειρά καλύπτει επίσης την επιθεώρηση καμπανιών στάγματος και ροών εργασίας για να ελέγξετε τι είναι πραγματικά ενεργό, και τη διαχείριση του widget συνομιλίας που εμφανίζει το WhatsApp και άλλα κανάλια στον ιστότοπο.
Για εργασίες σε επίπεδο ιστότοπου, αλλαγή ρυθμίσεων ιστότοπου PushEngage από έναν βοηθό AI καλύπτει τη ζώνη ώρας, τη γεωγραφική τοποθεσία και τη διαμόρφωση του service worker. Και αν το ρυθμίζετε αυτό για περισσότερους από έναν λογαριασμούς PushEngage, η ανάρτηση εστιασμένη σε πρακτορεία σχετικά με την εκτέλεση πολλαπλών λογαριασμών πελατών PushEngage από έναν βοηθό AI (συνδέεται παραπάνω) πηγαίνει βαθύτερα από το παράδειγμα διαμόρφωσης σε αυτόν τον οδηγό.
Εάν το ρυθμίζετε αυτό για κάποιον λιγότερο τεχνικό (έναν ιδρυτή που θέλει ο βοηθός AI να χειρίζεται το PushEngage καθημερινά χωρίς να αγγίζει ο ίδιος ένα αρχείο διαμόρφωσης), η πρώτη εβδομάδα ενός μη τεχνικού ιδρυτή με το PushEngage MCP είναι η αφηγηματική έκδοση αυτής της ίδιας ρύθμισης, γραμμένη για αυτόν τον αναγνώστη.
Η ρύθμιση από μόνη της λειτουργεί το ίδιο ανεξάρτητα από το πρόγραμμα PushEngage σας. Κάθε πρόγραμμα PushEngage, συμπεριλαμβανομένης της δωρεάν βαθμίδας, υποστηρίζει τον διακομιστή MCP. Εάν αποφασίζετε ποιο πρόγραμμα ταιριάζει πριν συνδέσετε οτιδήποτε, η σελίδα τιμολόγησης του PushEngage έχει τις τρέχουσες βαθμίδες.
