Ana içeriğe atla
OneSignal MCP sunucusu URL’sini ekleyerek OneSignal’ı, uzak Model Context Protocol (MCP) sunucularını destekleyen herhangi bir AI aracına veya ajanına bağlayın. Cursor, Claude Code, Codex CLI, VS Code veya kendi ajanınızı bağlamak ya da araçların tam listesini görmek için bu sayfayı kullanın. OneSignal’ı Claude veya ChatGPT dizininden yüklemek için OneSignal’ı Claude ve ChatGPT’de kullanın sayfasına bakın. MCP, AI uygulamalarını harici sistemlere bağlamak için açık bir standarttır. OneSignal MCP sunucusu, bir kullanıcıyı aramak veya mesaj göndermek gibi OneSignal işlemlerini AI aracınızın çağırabileceği araçlar olarak sunar.

Ö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:
Tarayıcınızda OneSignal’a giriş yapıp erişimi onaylayarak kimlik doğrularsınız. Yapılandırılacak bir REST API anahtarı yoktur. OAuth istemci kimliği ve istemci gizli anahtarı alanlarını boş bırakın: OneSignal AI aracınızı otomatik olarak kaydeder ve doldurulmuş değerler bağlantının başarısız olmasına neden olur.

AI aracınızı kurun \

Cursor \

OneSignal’ı Cursor Marketplace’ten yükleyin.
1

OneSignal eklentisini açın

Cursor Marketplace’teki OneSignal sayfasına gidin veya Cursor’ın marketplace’inde OneSignal araması yapın.
2

Eklentiyi yükleyin

Add to Cursor düğmesine tıklayın. Cursor, MCP sunucusu dahil OneSignal eklentisini yükler.
3

OneSignal'a giriş yapın

Settings > MCP & Integrations bölümünü açın ve OneSignal’ın yanındaki Authenticate düğmesine tıklayın. Tarayıcınızda giriş yapın ve Agree & Allow Access düğmesine tıklayın.
4

OneSignal'ı Agent sohbetinde kullanın

Yeni bir Agent sohbeti başlatın ve OneSignal’dan, OneSignal uygulamalarınızı listelemek gibi salt okunur bir kontrol çalıştırmasını isteyin.
Cursor’ı bunun yerine elle yapılandırmak için OneSignal’ı mcp.json dosyanıza ekleyin:

Claude Code \

1

OneSignal MCP sunucusunu ekleyin

Terminalinizde şu komutu çalıştırın:
2

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.
3

Erişimi onaylayın

Giriş yapın ve Agree & Allow Access düğmesine tıklayın. Claude Code’a dönün. Sunucu durumu connected olarak değişir.
Araç sayısını görmek için 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 yerel stdio sunucuları için olan claude_desktop_config.json üzerinden eklenemez.
1

Özel bağlayıcı ekleyin

Customize > Connectors bölümüne gidin ve Add custom connector düğmesine tıklayın.
2

Sunucu ayrıntılarını girin

Name alanını 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.
3

OneSignal'a giriş yapın

Add düğmesine tıklayın, ardından tarayıcınızda OneSignal girişini tamamlayın ve Agree & Allow Access düğmesine tıklayın.

Codex CLI \

1

Eklenti tarayıcısını açın

codex komutunu çalıştırın, ardından /plugins girin.
2

OneSignal'ı yükleyin

OneSignal’ı bulun, açın ve yükleyin.
3

Yeni bir oturum başlatın ve giriş yapın

Yeni bir oturum başlatın. Codex sizden kimlik doğrulamanızı istediğinde tarayıcınızda OneSignal’a giriş yapın ve Agree & Allow Access düğmesine tıklayın.
Codex IDE uzantısı eklentileri desteklemez. OneSignal’ı Codex ile kullanmak için Codex CLI’dan veya ChatGPT masaüstü uygulamasındaki Plugins sekmesinden yükleyin.

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:
Copilot ilk kez bir OneSignal aracına ihtiyaç duyduğunda VS Code sizden kimlik doğrulamanızı ister ve OneSignal giriş sayfasını açar.

Diğer AI araçları ve ajanlar \

AI aracınızın uzak MCP sunucusu ayarlarına https://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:
Yanıt OneSignal uygulamalarınızı listeliyorsa bağlantı çalışıyordur. “tool access is not enabled for this application” döndürürse Sorun giderme bölümüne bakın. Yalnızca AI aracınızın sunucuya ulaşıp ulaşmadığını kontrol etmek için 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/oauth olmalı; 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

Araç isteklerini yapılandırın, şemaları alın ve Journey değişikliklerini güvenle uygulayın.

Mesajlaşma (3 araç) \

Bir Live Activity başlatmak veya güncellemek için aşağıdaki Live Activities bölümüne bakın.

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_message aracı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çin list_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.

OneSignal'ı Claude ve ChatGPT'de kullanın

OneSignal’ı Claude veya ChatGPT dizininden yükleyin.

MCP ile Journeys yönetimi

MCP istemcinizden taslaklar oluşturun, Journey adımlarını güncelleyin ve Journey durumunu yönetin.

REST API'ye genel bakış

OneSignal MCP sunucusunun çağırdığı uç noktalar için başvuru.

Mesaj oluşturma API'si

send_message aracının arkasındaki uç nokta başvurusu.

AI veri uygulamaları

OneSignal’ın AI özellikleri ve bağlı AI araçları için verileri nasıl işlediği.