Ön koşullar \
- Yönetmek istediğiniz OneSignal uygulamalarına erişimi olan bir OneSignal hesabı.
- OneSignal’ın kullandığı tarayıcı tabanlı oturum açma yöntemi olan OAuth ile OneSignal erişimini onaylama izni.
- OAuth ile HTTP üzerinden uzak MCP sunucularını destekleyen bir AI aracı.
Bağlantı ayrıntıları \
Her AI aracı aynı barındırılan uç noktaya bağlanır:AI aracınızı kurun \
Cursor \
OneSignal’ı Cursor Marketplace’ten yükleyin.OneSignal eklentisini açın
Eklentiyi yükleyin
OneSignal'a giriş yapın
OneSignal'ı Agent sohbetinde kullanın
mcp.json dosyanıza ekleyin:
Claude Code \
OneSignal MCP sunucusunu ekleyin
Claude Code içinden kimlik doğrulayın
claude komutunu başlatın, ardından MCP panelini açmak için /mcp yazın. onesignal seçeneğini seçin, ardından tarayıcınızda OneSignal giriş sayfasını açmak için Authenticate seçeneğini seçin.Erişimi onaylayın
claude mcp list komutunu veya Claude Code içinde /mcp komutunu çalıştırın.
Claude özel bağlayıcısı \
Özel bağlayıcıyı yalnızca OneSignal’ı Claude dizininden yükleyemediğinizde kullanın. Uzak MCP sunucuları, yalnızca yerelstdio sunucuları için olan claude_desktop_config.json üzerinden eklenemez.
Özel bağlayıcı ekleyin
Sunucu ayrıntılarını girin
OneSignal, Remote MCP server URL alanını https://api.onesignal.com/mcp/oauth olarak ayarlayın. Advanced settings altındaki OAuth Client ID ve OAuth Client Secret alanlarını boş bırakın.OneSignal'a giriş yapın
Codex CLI \
Eklenti tarayıcısını açın
codex komutunu çalıştırın, ardından /plugins girin.OneSignal'ı yükleyin
Yeni bir oturum başlatın ve giriş yapın
VS Code’da GitHub Copilot \
Ekibinizle paylaşmak için OneSignal’ı çalışma alanınızdaki.vscode/mcp.json dosyasına ekleyin veya kullanıcı profiliniz için yüklemek üzere Komut Paleti’nden MCP: Open User Configuration komutunu çalıştırın:
Diğer AI araçları ve ajanlar \
AI aracınızın uzak MCP sunucusu ayarlarınahttps://api.onesignal.com/mcp/oauth adresini ekleyin. AI aracı bir OneSignal aracını ilk kez çağırdığında tarayıcınızda OneSignal giriş sayfasını açar. Giriş yapın ve Agree & Allow Access düğmesine tıklayın. Bağlantı başarılı olduğunda AI aracınız OneSignal araçlarını listeler.
Bağlantıyı doğrulayın \
Yeni bir sohbet veya oturum başlatın ve şunu gönderin:onesignal_health aracını çağırın. Bu araç AI aracı erişimi açılmadan önce de yanıt verir; bu nedenle sağlıklı bir sonuç diğer araçların çalıştığını doğrulamaz.
Sorun giderme \
- Yeniden kimlik doğrulayın. OneSignal’ı AI aracınızın MCP veya bağlayıcı ayarlarından yeniden bağlayın, ardından yeni bir oturum başlatın.
-
Sunucu URL’sini kontrol edin. URL tam olarak
https://api.onesignal.com/mcp/oautholmalı; ek yol veya sonda fazladan karakter içermemelidir. - OAuth istemci alanlarını temizleyin. AI aracınızda OAuth istemci kimliği veya gizli anahtar alanları varsa bunları boş bırakın.
- AI aracı erişimini kontrol edin. Bir araç “tool access is not enabled for this application” döndürürse: OneSignal, OneSignal girişiniz için AI aracı erişimini henüz açmadı. OneSignal destek ekibiyle iletişime geçin.
- AI aracınızı yeniden başlatın ve yeni bir oturum başlatın. Bu, geçici bağlantı sorunlarının çoğunu çözer.
Araçlar \
Aşağıdaki araçları inceleyin. Araç keşfi, OneSignal uygulamanız veya hesabınız için MCP’nin etkin olmasına bağlıdır. Her işlem ayrıca OneSignal uygulama izinlerinizi de kontrol eder.Uygulamalar (2 araç) \
Journeys (9 araç) \
MCP ile Journeys yönetimi
Mesajlaşma (3 araç) \
Kullanıcılar ve abonelikler (12 araç) \
Şablonlar (4 araç) \
Segmentler (4 araç) \
Live Activities (2 araç) \
Dışa aktarmalar (2 araç) \
Özel olaylar (2 araç) \
E-posta teslim edilebilirliği (4 araç) \
E-posta ısınması (5 araç) \
Analiz ve yardımcı araçlar (4 araç) \
Güvenlik ve koruma önlemleri \
- OneSignal,
send_messagearacını yüksek etkili bir araç olarak işaretler; bu nedenle araç açıklamalarını dikkate alan AI araçları çalıştırmadan önce onay isteyebilir. send_message, göndermeden önce hedeflemeyi doğrular: istek başına yalnızca bir hedefleme yöntemi kullanılabilir ve filtre sayısı sınırlıdır.- OneSignal, tanımlayıcılar, e-posta adresleri ve telefon numaraları dahil girdileri yürütmeden önce doğrular.
- Journey eşzamanlılık gereksinimleri, yaşam döngüsü kontrolleri ve belirsiz yazma işlemlerinden sonra kurtarma için Journey istek kılavuzuna bakın.
- OneSignal, AI aracı erişimini her OneSignal girişi için ayrı ayrı açar veya kapatır.
- MCP sunucusu müşteri verilerinizi (aboneler, mesajlar, dışa aktarmalar) saklamaz.
Sınırlar ve kullanım \
OneSignal’ı bağlamak ücretsizdir. Her işlem normal OneSignal API kullanım limitlerinize dahil edilir. AI sağlayıcınızın planının kendi maliyetleri olabilir.- Araçların kontrolsüz döngülere girmesini önlemek için araç çağrılarına hız sınırı uygulanır.
- Bir bağlantı, oturum açmış kullanıcının izinlerini izler ve bu kullanıcının yönetebildiği her OneSignal uygulamasına erişebilir.
- Yardımcı araçlar dışındaki araçların çalışması için OneSignal’ın girişiniz için AI aracı erişimini açması gerekebilir.
FAQ \
REST API anahtarına ihtiyacım var mı? \
Hayır. Her bağlantı OneSignal OAuth kullanır. Tarayıcınızdan giriş yapıp erişimi onaylarsınız; bu nedenle kopyalanacak, saklanacak veya yenilenecek bir API anahtarı yoktur.Birden fazla OneSignal uygulamasıyla nasıl çalışırım? \
Tek bir bağlantı, OneSignal hesabınızın yönetebildiği tüm uygulamaları kapsar. Uygulama kimliklerini bulmak içinlist_apps aracını çağırın. Her uygulama için ayrı bir yapılandırmaya ihtiyacınız yoktur.
Yalnızca yerel stdio sunucularını destekleyen bir AI aracını bağlayabilir miyim? \
Hayır. OneSignal MCP sunucusu HTTP üzerinden çalışan uzak bir sunucudur. AI aracınızın OAuth ile uzak MCP sunucularını desteklemesi gerekir.Bir AI aracının erişimini nasıl iptal ederim? \
OneSignal’da Settings > Account settings > Connected apps bölümüne gidin ve bağlantıyı iptal edin. Bağlantıyı iptal etmek ekip arkadaşlarınızın bağlantılarını etkilemez.İlgili sayfalar \
OneSignal'ı Claude ve ChatGPT'de kullanın
MCP ile Journeys yönetimi
REST API'ye genel bakış
Mesaj oluşturma API'si
send_message aracının arkasındaki uç nokta başvurusu.