> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OneSignal MCP sunucusu

> Uzak MCP sunucularını destekleyen herhangi bir AI aracını veya ajanını, barındırılan MCP sunucusu URL'si ile OneSignal'a bağlayın. Claude Code, Codex CLI, Cursor, VS Code ve özel bağlayıcılarda kurulumu ve Journey araçları dahil sunucunun desteklediği tüm araçları kapsar.

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](https://documentation.onesignal.com/docs/en/onesignal-in-claude-chatgpt.md) sayfasına bakın.

[MCP](https://modelcontextprotocol.io/docs/getting-started/intro), 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:

```text theme={null}
https://api.onesignal.com/mcp/oauth
```

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](https://cursor.com/marketplace/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:

```json theme={null}
{
  "mcpServers": {
    "onesignal": {
      "url": "https://api.onesignal.com/mcp/oauth"
    }
  }
}
```

### Claude Code \\

**1. OneSignal MCP sunucusunu ekleyin**

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

```bash theme={null}
claude mcp add --transport http onesignal https://api.onesignal.com/mcp/oauth
```

**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](https://claude.ai/directory/connectors/onesignal) 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:

```json theme={null}
{
  "servers": {
    "onesignal": {
      "type": "http",
      "url": "https://api.onesignal.com/mcp/oauth"
    }
  }
}
```

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:

```text theme={null}
Use the list_apps tool to list the OneSignal apps I can access.
```

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](#troubleshooting) 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ç) \\

| İşlem | Araç |
| - | - |
| Kimliği doğrulanmış kullanıcının erişebildiği uygulamaları listeleme | `list_apps` |
| Bir uygulama için hangi mesajlaşma kanallarının etkin olduğunu kontrol etme | `get_app_channel_availability` |

### Journeys (9 araç) \\

| İşlem | Araç |
| - | - |
| Bir uygulamanın Journeys'lerini listeleme | `list_journeys` |
| Bir Journey'nin yapısını ve geçerli eşzamanlılık anahtarını görüntüleme | `get_journey` |
| Journey, adım, dal ve mesaj istatistiklerini görüntüleme | `get_journey_stats` |
| Bir Journey veya adım oluşturmak, çoğaltmak ya da güncellemek için JSON Schema alma | `get_journey_schema` |
| Taslak olarak bir Journey oluşturma | `create_journey_draft` |
| Bir Journey'yi yeni bir taslak olarak çoğaltma | `duplicate_journey` |
| Journey alanlarını güncelleme veya durumunu değiştirme | `update_journey` |
| Tek bir Journey adımını güncelleme | `update_journey_node` |
| Bir Journey'yi kalıcı olarak silme | `delete_journey` |

> [card] [MCP ile Journeys yönetimi](https://documentation.onesignal.com/docs/en/mcp-journeys.md)
>
> Araç isteklerini yapılandırın, şemaları alın ve Journey değişikliklerini güvenle uygulayın.

### Mesajlaşma (3 araç) \\

| İşlem | Araç |
| - | - |
| Push bildirimi, e-posta veya SMS gönderme | `send_message` |
| Son bildirimleri listeleme | `list_messages` |
| Bildirim ayrıntılarını ve teslimat istatistiklerini görüntüleme | `view_message` |

Bir Live Activity başlatmak veya güncellemek için aşağıdaki [Live Activities](#live-activities-2-tools) bölümüne bakın.

### Kullanıcılar ve abonelikler (12 araç) \\

| İşlem | Araç |
| - | - |
| Bir kullanıcıyı takma adla arama | `view_user` |
| Bir kullanıcının kimlik takma adlarını alma | `get_user_identity` |
| Abonelik kimliğine göre kimlik alma | `get_user_identity_by_subscription` |
| Özelliklerle yeni bir kullanıcı oluşturma | `create_user` |
| Kullanıcı özelliklerini güncelleme (etiketler, dil ve daha fazlası) | `update_user` |
| Kimlik takma adları ekleme veya güncelleme | `create_or_update_alias` |
| Abonelik kimliği ile takma ad ekleme | `create_alias_by_subscription` |
| Push, e-posta veya SMS aboneliği ekleme | `create_subscription` |
| Mevcut bir aboneliği güncelleme | `update_subscription` |
| Bir aboneliği token ile güncelleme | `update_subscription_by_token` |
| Bir e-posta adresinin aboneliğini iptal etme | `unsubscribe_email` |
| Bir aboneliği farklı bir kullanıcıya aktarma | `transfer_subscription` |

### Şablonlar (4 araç) \\

| İşlem | Araç |
| - | - |
| Şablonları listeleme | `list_templates` |
| Bir şablonu görüntüleme | `get_template` |
| Şablon oluşturma | `create_template` |
| Şablon güncelleme | `update_template` |

### Segmentler (4 araç) \\

| İşlem | Araç |
| - | - |
| Segmentleri listeleme | `list_segments` |
| Bir segmenti ve filtrelerini görüntüleme | `get_segment` |
| Segment oluşturma | `create_segment` |
| Segment güncelleme | `update_segment` |

### Live Activities (2 araç) \\

| İşlem | Araç |
| - | - |
| Bir iOS Live Activity başlatma | `start_live_activity` |
| Bir Live Activity'yi güncelleme veya sonlandırma | `update_live_activity` |

### Dışa aktarmalar (2 araç) \\

| İşlem | Araç |
| - | - |
| Abonelikleri CSV olarak dışa aktarma | `export_subscriptions_csv` |
| Bildirim hedef kitle etkinliğini CSV olarak dışa aktarma | `export_audience_activity_csv` |

### Özel olaylar (2 araç) \\

| İşlem | Araç |
| - | - |
| Kullanıcılar için özel olaylar oluşturma | `create_custom_events` |
| Dizine eklenmiş özel olay tanımlarını listeleme | `get_custom_events` |

### E-posta teslim edilebilirliği (4 araç) \\

| İşlem | Araç |
| - | - |
| E-posta alan adı DNS doğrulama durumunu kontrol etme (SPF, DKIM, DMARC) | `get_email_domains` |
| Uygulama genelinde geri dönme ve spam şikayeti oranlarını görüntüleme | `get_email_reputation` |
| Bir alan adı için gelen kutusu sağlayıcısı başına teslim edilebilirlik metriklerini alma | `get_provider_metrics` |
| Sağlayıcı teslim edilebilirlik metriklerinin zaman serisini alma | `get_provider_metrics_timeseries` |

### E-posta ısınması (5 araç) \\

| İşlem | Araç |
| - | - |
| Bir gönderimin IP veya alan adı ısınması gerektirip gerektirmediğini kontrol etme | `check_send_volume` |
| Segmentlerden ve filtrelerden alıcı sayısını tahmin etme | `estimate_recipient_count` |
| Önerilen aşamalı ısınma planını alma | `recommended_warm_up_schedule` |
| Taslak bir kampanyaya ısınma planı uygulama | `apply_warm_up_schedule` |
| Şu anda devam eden ısınma planlarını listeleme | `get_active_warm_up_schedules` |

### Analiz ve yardımcı araçlar (4 araç) \\

| İşlem | Araç |
| - | - |
| Sonuç analizlerini görüntüleme | `view_outcomes` |
| Sunucu durumunu kontrol etme | `onesignal_health` |
| Sunucu yapılandırmasını görüntüleme | `onesignal_config` |
| Tüm araçların başvuru özetini görüntüleme | `onesignal_reference_overview` |

## 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](https://documentation.onesignal.com/docs/en/mcp-journeys.md) 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](https://dashboard.onesignal.com/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 \\

> [card] [OneSignal'ı Claude ve ChatGPT'de kullanın](https://documentation.onesignal.com/docs/en/onesignal-in-claude-chatgpt.md)
>
> OneSignal'ı Claude veya ChatGPT dizininden yükleyin.

> [card] [MCP ile Journeys yönetimi](https://documentation.onesignal.com/docs/en/mcp-journeys.md)
>
> MCP istemcinizden taslaklar oluşturun, Journey adımlarını güncelleyin ve Journey durumunu yönetin.

> [card] [REST API'ye genel bakış](https://documentation.onesignal.com/reference/rest-api-overview.md)
>
> OneSignal MCP sunucusunun çağırdığı uç noktalar için başvuru.

> [card] [Mesaj oluşturma API'si](https://documentation.onesignal.com/reference/create-message.md)
>
> `send_message` aracının arkasındaki uç nokta başvurusu.

> [card] [AI veri uygulamaları](https://documentation.onesignal.com/docs/en/ai-data-practices.md)
>
> OneSignal'ın AI özellikleri ve bağlı AI araçları için verileri nasıl işlediği.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.