Claude Desktop, Claude Code veya Cursor'ı zaten PushEngage kontrol panelinden daha fazla saat açık tutuyorsunuz. Bir tıklama oranını kontrol etmek veya bir bildirim göndermek istediğinizde, gerçek işin gerçekleştiği pencereden uzaklaşıyorsunuz. PushEngage MCP kurulumu bu boşluğu kapatır: bir npx komutu, bir tarayıcı oturum açma ve PushEngage'ın araçları, kod yazmak, bir iş akışını hata ayıklamak veya ekibinizden bir soruyu yanıtlamak için zaten kullandığınız aynı sohbet oturumunda yer alır.
Bu eksiksiz kurulum kılavuzudur: kurulum, bilinmesi gereken iki ortam değişkeni, ilk oturum açma ve ilk denemede çalışmadığında bağlantıyı kesen üç özel şey. Sonunda, sadece yeşil bir "bağlı" göstergesi değil, seçili bir site ile kimliği doğrulanmış bir oturuma sahip olacaksınız.
Bağlandığınızda neler yapabileceksiniz
@pushengage/mcp, 10 alan genelinde 27 araç sunar ve bir siteye kimliğiniz doğrulandıktan sonra, hepsi kontrol panelinden bir tıklama uzakta yerine bir cümle uzaktadır. Kurulum tamamlandıktan sonra bunun neye benzediğine dair birkaç örnek:
- Şimdi bir anlık bildirim gönderin, belirli bir zaman için planlayın veya yinelenen bir gönderi ayarlayın - isterseniz her abonenin yerel saat diliminde.
- İki başlık arasında bir A/B testi çalıştırın ve sonuçlar geldiğinde tıklama oranı hakkında asistanın geri bildirimde bulunmasına izin verin.
- Kurallar kullanıcı arayüzü yerine düz dilde bir açıklamadan bir segment veya bir kitle grubu oluşturun.
- Analitikleri ömür boyu özet olarak veya günlük zaman serisi olarak çekin.
- Gerçekte neyin çalıştığını kontrol etmek için damla kampanyalarınızı, tetiklenen kampanyalarınızı ve iş akışlarınızı listeleyin.
- Sitenizin ayarlarını, hizmet çalışanı yapılandırmasını ve sohbet penceresi kurulumunu okuyun.
Bunların hiçbiri, asistanın PushEngage şifrenize sahip olmasını gerektirmez ve hiçbiri düzenleyicinizden veya terminalinizden ayrılmanızı gerektirmez. PushEngage, bu entegrasyonu 150'den fazla ülkedeki 25.000'den fazla işletme sahibinden oluşan bir hesap tabanı için yürütür ve son 30 günde 15,2 milyar bildirim gönderir. MCP sunucusu, kum havuzunda bir demo değil, bu hacmin çalıştığı aynı üretim API'si ile konuşur.
Başlamadan önce: ihtiyacınız olanlar
Üç şey ve muhtemelen zaten en az ikisine sahipsiniz:
- Bir PushEngage hesabı - ücretsiz veya ücretli, en az bir site eklenmiş. MCP sunucusu sizin için bir site oluşturmaz; PushEngage kontrol panelinizde zaten ayarladığınız sitelerde çalışır.
- Node.js 18 veya daha yenisi - asistan, Node ile birlikte gelen
npxaracılığıyla sunucuyu çalıştırır. Bir terminaldenode -vile kontrol edin. - MCP uyumlu bir istemci — Claude Desktop, Claude Code, Cursor veya standart giriş/çıkış (stdio) üzerinden MCP konuşan diğer istemciler.
Yapılandırma dosyalarını düzenlemeye başlamadan önce açıkça belirtilmesi gereken bir şey var: @pushengage/mcp makinenizde stdio üzerinden yerel olarak çalışır. Yönlendirilecek uzak bir sunucu veya barındırılan bir bağlayıcı URL'si yoktur. İstemci işlemi başlatır ve işlem sizin adınıza PushEngage'in API'si ile konuşur. Farklı bir araç için bir kurulum kılavuzu uzak bir uç nokta yapıştırmanızı söylüyorsa, bu, bu sunucudan farklı bir MCP sunucusu türüdür.
Claude Desktop, Claude Code ve Cursor'da sunucuyu ayarlama
Genel kurulum yok. npx, istemciniz ilk başlattığında @pushengage/mcp'yi isteğe bağlı olarak getirir ve tam npx -y @pushengage/mcp komutunu kullanır. Bu komutu istemcinizin MCP yapılandırmasına eklersiniz, istemciyi yeniden başlatırsınız ve sunucu araç listenizde görünür.
Her istemci yapılandırmasını farklı bir yerde tutar.
Claude Desktop
macOS'ta ~/Library/Application Support/Claude/claude_desktop_config.json (veya platformunuzdaki eşdeğer yol) dosyasını düzenleyin:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Desktop'ı yeniden başlatın. “pushengage” sunucusu araç listenizde görünmelidir.
İmleç
~/.cursor/mcp.json dosyasını düzenleyin:
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Code
Claude Code, Claude Desktop ve Cursor gibi MCP'yi stdio üzerinden konuşur, bu nedenle doğrudan MCP yapılandırma dosyasını düzenlerseniz aynı command/args şekli çalışır. JSON'u elle düzenlemek istemiyorsanız, Claude Code kendi claude mcp add CLI komutu aracılığıyla da sunucuları kabul eder; bu, PushEngage'e özgü bir şeyden ziyade genel bir Claude Code davranışıdır. Bu yolu seçerseniz tam bayrak sözdizimi için Claude Code'un kendi belgelerine bakın.
Diğer MCP istemcileri
İstemciniz yukarıdaki üçünden biri değilse, temel gereksinim her yerde aynıdır: onu npx -y @pushengage/mcp'yi bir stdio sunucusu olarak çalıştırmak üzere yapılandırın. Yapılandırmayı okuyan istemci hangisi olursa olsun, kurulum adımı budur.
Bağlantıyı adlandırma ve belirteçleri izole etme: PE_MCP_CLIENT_NAME ve PE_MCP_CONFIG_PATH
Kurulum adımı dışında yapılandırma gerekmez. Sunucu varsayılan olarak PushEngage'in üretim API'si ile konuşur; daha az yaygın kurulumlar için iki ortam değişkeni mevcuttur:
| Ortam değişkeni | Varsayılan | Amaç |
|---|---|---|
PE_MCP_CLIENT_NAME | Yapay zeka asistanı | Erişim isteyen uygulamanın PushEngage yetkilendirme ekranında gösterilen etiket. "Claude Desktop" gibi daha belirli bir şey istiyorsanız ayarlayın. |
PE_MCP_CONFIG_PATH | ~/.pushengage/mcp.json | Erişim belirtecinin saklandığı yer. Birden fazla PushEngage hesabını yan yana çalıştırmak için bunu ayarlayın. Mutlak bir yol olmalıdır — ~ genişletmesi yok. |
Çoğu tek hesap kurulumu bu değişkenlerden herhangi birine dokunmaya gerek duymaz. PE_MCP_CLIENT_NAME, siz Yetkilendire tıklarken yetkilendirme ekranının "Yapay zeka asistanı"ndan daha okunabilir bir şey söylemesini istediğinizde kullanışlı, kozmetik bir kolaylıktır. PE_MCP_CONFIG_PATH, ikinci, ayrı bir belirteç dosyasına ihtiyaç duyduğunuz anda önemlidir; bu da bir sonraki bölümde ele alınan durumdur.
İlk çalıştırma: oturum açma ve bir site seçme
Kimlik doğrulama tarayıcı tabanlıdır, bu nedenle asistan asla PushEngage şifrenizi görmez. Akış üç adımdan oluşur ve her birinin aslında arka planda neyi çağırdığını incelemeye değer:
- Asistandan oturum açmasını isteyin. Basit bir dille: “Beni PushEngage'e giriş yap.” Bu, tarayıcıda PushEngage yetkilendirme sayfasını açan
pushengage_auth_loginkomutunu çalıştırır. - Yetkilendir'e tıklayın. Kontrol paneli, belirteci bir POST isteği olarak sunucuya gönderir — asla bir URL'de, tarayıcı geçmişinde veya erişim günlüğünde görünmez. Belirteç, yalnızca sizin tarafınızdan okunabilir şekilde
0600izinleriyle yerel olarak kaydedilir. - Asistandan sitelerinizi göstermesini isteyin, ardından birini seçin. “PushEngage sitelerimi göster”
pushengage_list_siteskomutunu çağırır; “Site 12345'i kullan”pushengage_select_sitekomutunu çağırır. Seçim, yeniden başlatmalar arasında hatırlanır ve açıkça farklı birsite_idgeçirmedikçe her site kapsamlı araç bu seçime göre işlem yapar.
İlgili araçlar, adlarına göre:
| Araç | Amaç |
|---|---|
pushengage_auth_login | Tarayıcıyı PushEngage'e açar ve başarı durumunda belirteci depolar. |
pushengage_auth_status | Kimliğinizin doğrulanıp doğrulanmadığını ve şu anda hangi sitenin seçili olduğunu gösterir. |
pushengage_list_sites | Hesabınızın erişebileceği PushEngage sitelerini listeler. |
pushengage_select_site | Diğer araçların üzerinde işlem yapacağı geçerli siteyi ayarlar. |
Bir site seçtikten sonra, pushengage_auth_status komutunu çalıştırın (“PushEngage kimlik doğrulama durumum nedir?” diye sormak yeterlidir) ve başka bir şey denemeden önce hem kimliği doğrulanmış bir oturumun hem de seçili bir sitenin raporlandığını onaylayın. Kurulumun gerçek bitiş çizgisi budur, istemcinin sunucuyu ilk bağlandı olarak gösterdiği an değil.
Sorun giderme, nedene göre
Çoğu bağlantı sorunu üç belirli nedenden birine dayanır. Bu sırayla teşhis edin.
Sunucu hiç bağlanmıyor ve istemciniz “Bağlantı kapatıldı” gösteriyor. Bu neredeyse her zaman bir PATH sorunudur, sunucuda bir hata değildir. Claude Desktop, Cursor ve benzeri istemciler, Dock'unuzdan veya Finder'dan başlatılır, terminalden değil, bu nedenle kabuk başlangıç dosyalarınızı asla yüklemezler. Node bir sürüm yöneticisi (nvm, fnm, volta) aracılığıyla kurulduysa, istemci npx'i hiç bulamaz. Süreç asla başlamaz ve açık bir “komut bulunamadı” yerine genel bir bağlantı hatası alırsınız. Mutlak yolu almak için bir terminalde which npx komutunu çalıştırın, ardından istemcinizi doğrudan ona yönlendirin:
{
"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"
}
}
}
}Düzenledikten sonra istemciyi yeniden başlatın. which npx komutu bunun yerine /usr/local/bin veya /opt/homebrew/bin altındaki bir yol yazdırırsa, bir sürüm yöneticisi muhtemelen sorununuz değildir; gerçek hatayı istemcinin kendi MCP günlüklerinde kontrol edin.
[AUTH_EXPIRED]. Belirteciniz süresi doldu. Asistandan tekrar giriş yapmasını isteyin — tüm düzeltme budur.
[NO_SITE_SELECTED]. Kimlik doğrulamanız yapıldı ancak henüz bir site seçilmedi. Lütfen site kapsamlı herhangi bir aracı tekrar denemeden önce pushengage_list_sites'ı çağırın, ardından döndürülen sitelerden birini kullanmayı isteyin.
Hata olmasa da bilinmesi gereken bir durum daha var: tarayıcı otomatik olarak açılmazsa, muhtemelen başsız veya uzak bir oturumdasınızdır (SSH, bir kapsayıcı). Yetkilendirme URL'si sunucuyu çalıştıran terminale yazdırılır. Manuel olarak açın.
Birden fazla PushEngage hesabı veya istemcisi çalıştırma
Birden fazla marka için PushEngage yönetiyorsanız veya bir ajans olarak birden fazla istemci hesabına karşı MCP çalıştırıyorsanız, çözüm daha önceki PE_MCP_CONFIG_PATH'dir: sunucuyu, jetonların çakışmaması için her biri kendi yoluyla iki farklı ad altında kaydedin.
{
"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)"
}
}
}
}Her sunucu adının altında ayrı ayrı oturum açın, her seferinde tarayıcıda seçtiğiniz PushEngage hesabını yetkilendirin. Her sunucu girişi kendi jeton dosyasını tutar, bu nedenle istemci hesapları arasında geçiş yapmak, her seferinde yeniden oturum açmak yerine hangi araç adını çağırdığınızla ilgilidir. Gerçek kullanım durumunuz buysa, seride tek bir yapay zeka asistanından birden fazla PushEngage istemci hesabı çalıştırmanın tam bir anlatımı bulunmaktadır.
Bağlandıktan sonra ne yapmalı
Kimlik doğrulama tamamlandıktan ve bir site seçildikten sonra, 27 araç, yalnızca sayılarına göre değil, isimleriyle bilinmeye değer birkaç pratik gruba ayrılır.
Kampanyaları yürütmenin günlük işleri için, seri, gösterge tablosu yerine yapay zeka asistanınızdan anlık bildirim gönderme ve zamanlama ve tıklama oranına göre anlık bildirimleri A/B testi yapma ve yapay zekanın kazananı seçmesine izin verme konularını ele almaktadır. Listenizi oluşturmak için basit İngilizce ile abone segmentleri oluşturma konusunda tam bir kılavuz bulunmaktadır.
Ölçümleme için, yapay zeka asistanınız aracılığıyla anlık bildirim analitiklerini okuma, ömür boyu özetleri ve günlük zaman serilerini kapsar. Bunlar, bir A/B testi sonucunu veya bir kampanya gönderimini yalnızca çalıştırmakla kalmayıp raporlamaya değer kılan aynı analitik araçlarıdır. Seri ayrıca, neyin aktif olduğunu kontrol etmek için toplu kampanya ve iş akışlarını denetlemeyi ve sitede görünen WhatsApp ve diğer kanalları yönetmeyi kapsar.
Site düzeyinde çalışmalar için, yapay zeka asistanından PushEngage site ayarlarını değiştirme saat dilimi, coğrafi konum ve hizmet çalışanı yapılandırmasını kapsar. Ve bunu birden fazla PushEngage hesabı için ayarlıyorsanız, yukarıda bağlantısı verilen tek bir yapay zeka asistanından birden fazla PushEngage istemci hesabı çalıştırma konusundaki ajans odaklı gönderi, bu kılavuzdaki yapılandırma örneğinden daha derinlemesine bilgi vermektedir.
Bunu daha az teknik birisi için (yapay zeka asistanının yapılandırma dosyasına dokunmadan PushEngage'ı günlük olarak yönetmesini isteyen bir kurucu) ayarlıyorsanız, teknik olmayan bir kurucunun PushEngage MCP ile ilk haftası, o okuyucu için yazılmış bu aynı kurulumun anlatı sürümüdür.
Kurulum, PushEngage planınızdan bağımsız olarak aynı şekilde çalışır. Ücretsiz katman dahil her PushEngage planı MCP sunucusunu destekler. Herhangi bir şeyi bağlamadan önce hangi planın uygun olduğuna karar veriyorsanız, PushEngage’ın fiyatlandırma sayfasında mevcut katmanlar bulunmaktadır.
