# Netmera MCP Sunucusunu Kurun

Bu sayfayı ilk kurulum rehberiniz olarak kullanın.

Netmera MCP Sunucusu’na ilk kez bağlanıyorsanız, buradan başlayın.

Sonunda şunları yapabileceksiniz:

* MCP uyumlu istemcinizi bağlamak,
* bağlantının çalıştığını doğrulamak,
* ve yazma erişimini ne zaman etkinleştirmeniz gerektiğini anlamak.

{% hint style="info" %}
Şununla başlayın `mcp:read`.

Yazma işlemlerini açığa çıkarmadan raporlama, analiz ve sorgulama yapabilirsiniz.
{% endhint %}

### İhtiyacınız olanlar

Bağlantı kurmadan önce şunlara sahip olduğunuzdan emin olun:

1. hedef Netmera uygulamasına erişim,
2. MCP uyumlu bir istemci veya ortam,
3. ve Netmera’da doğru yetki seviyesi.

### Erişim nasıl çalışır

Her token tek bir Netmera uygulamasına bağlıdır.

Token ayrıca Netmera panel izinlerinizi devralır.

MCP istemciniz kullanıcı hesabınızın yapabildiğinden fazlasını yapamaz.

#### Kapsamlar

<table><thead><tr><th width="135.90008544921875">Kapsam</th><th width="345.85986328125">Ne sağlar</th><th>En uygun kullanım</th></tr></thead><tbody><tr><td><code>mcp:read</code></td><td>Raporlama, inceleme, analiz ve sorgulama</td><td>İlk bağlantı ve güvenli keşif</td></tr><tr><td><code>mcp:write</code></td><td><code>mcp:read</code> ayrıca oluşturma, güncelleme, gönderme, duraklatma, devam ettirme ve onay işlemleri</td><td>İnsan onaylı operasyonel çalışmalar</td></tr></tbody></table>

ile işaretlenen araçlar `🔒` gerektirir `mcp:write`.

#### Token geçerlilik süresi

<table><thead><tr><th width="322.541259765625">Token türü</th><th>Geçerlilik süresi</th></tr></thead><tbody><tr><td>JWT</td><td>30 gün</td></tr><tr><td>OAuth erişim tokenı</td><td>8 saat</td></tr></tbody></table>

### Bağlantıyı kurun

Amacınız mümkün olan en hızlı şekilde çalışan bir bağlantı kurmaksa bu akışı izleyin.

{% stepper %}
{% step %}

#### 1) Hedef uygulamayı seçin

İstemcinin hangi Netmera uygulamasına erişmesini istediğinize karar verin.

Her token yalnızca tek bir uygulama için çalışır.
{% endstep %}

{% step %}

#### 2) Salt okunur bir token oluşturun

İstemciniz doğrudan bağlayıcıyla oturum açmayı destekliyorsa, giriş akışını orada tamamlayın.

Token’ı doğrudan istemek istiyorsanız şunu kullanın:

```json
POST https://ai.netmera.com/ai/mcp
Content-Type: application/json

{
  "email": "sizin@email.com",
  "password": "netmera-parolanız",
  "scope": "mcp:read"
}
```

Kullanın `mcp:read` salt okunur erişim için veya `mcp:write` kampanya oluşturma ya da gönderme gibi yazma işlemlerine izin vermek için.
{% endstep %}

{% step %}

#### 3) Netmera’yı istemcinize ekleyin

Önce istemcinizin bağlayıcı, entegrasyon veya MCP ayarlarını açın.

Ardından Netmera’yı yeni bir bağlayıcı veya MCP kaynağı olarak ekleyin.

Çoğu istemcide akış şu şekilde görünür:

1. Aç **Ayarlar**, **Entegrasyonlar**, **Bağlayıcılar**veya **MCP**.
2. Şuna tıklayın **Bağlayıcı ekle**, **Kaynak ekle**veya **Sunucu ekle**.
3. Şunu seçin **Netmera** listede görünüyorsa.
4. İstendiğinde oturum açmayı tamamlayın veya token’ınızı yapıştırın.
5. Hedef uygulama için erişimi onaylayın.

Genellikle iki bağlantı yolu vardır:

* **Yerleşik oturum açma** — istemci bir giriş akışı açar. Netmera hesabınızla giriş yapın ve uygulama erişim isteğini onaylayın.
* **Token tabanlı kurulum** — istemci bir token ister. Önceki adımda aldığınız token’ı yapıştırın. İstemci bir yetkilendirme türü sorarsa **Bearer token**.

#### Örnek istemci yapılandırması

**Claude Desktop** (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "netmera": {
     "url": "https://ai.netmera.com/ai/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}
```

**Cursor**, **Warp**ve diğer MCP uyumlu istemciler aynı URL + Authorization header birleşimini kabul eder.

{% hint style="info" %}
İstemci etiketleri değişebilir.

Bazı istemciler buna bir **bağlayıcı**der. Diğerleri buna bir **MCP sunucusu**, **araç kaynağı**veya **entegrasyon**
{% endhint %}
{% endstep %}

{% step %}

#### 4) Birkaç basit soru sorun

Önce düşük riskli istemler kullanın.

İlk kullanıma uygun örnek istemler:

* “Bugün uygulamamın sağlık durumu nedir?”
* “VIP segmentinde kaç kullanıcı var?”
* “Son 30 gün için günlük geliri göster.”
  {% endstep %}

{% step %}

#### 5) Bağlantının gerçekten çalıştığını doğrulayın

Şunlardan emin olun:

* doğru uygulamaya bağlısınız,
* raporlar veri döndürüyor,
* ve yazma işlemleri hâlâ kullanılamıyor.
  {% endstep %}

{% step %}

#### 6) Daha sonra yazma erişimini etkinleştirin

Şuraya geçin `mcp:write` yalnızca taslak oluşturmak veya onaylanmış işlemleri çalıştırmak istediğinizde.

Yeni bir token oluşturun, `"scope: \"mcp:write\""` hazır olduğunuzda.
{% endstep %}
{% endstepper %}

### Başarılı bir ilk kurulum nasıl görünür

Kurulumunuz şu durumlarda hazırdır:

* istemci, salt okunur soruları canlı Netmera verileriyle yanıtlıyor,
* uygulama bağlamı beklediğiniz uygulamayla eşleşiyor,
* ve siz etkinleştirmedikçe yazma yetkili araçlar görünmüyor `mcp:write`.

### Daha iyi istemler yazın

En iyi istemler özeldir.

Uygun olduğunda şu bölümleri ekleyin:

1. **Zaman aralığı** — `son 7 gün`, `dün`, `bu ay`
2. **Hedef** — bir kampanya, segment, kullanıcı, iş akışı, kanal veya etkinlik
3. **Çıktı** — bir özet, trend, karşılaştırma, sıralama veya taslak
4. **İşlem sınırı** — `yalnızca hazırla`, `önizleme göster`, `gönderme`

#### Örnek istem kalıpları

**Analiz**

* “Son 7 gün için uygulama performansını özetle.”
* “Son 14 gün için push ve e-posta performansını karşılaştır.”
* “Geçen hafta en çok geliri hangi kampanyalar sağladı?”

**Hedef kitle ve kullanıcı incelemesi**

* “Churn riski segmentinde kaç kullanıcı var?”
* “Bu kullanıcının son etkinliklerini göster.”
* “Son 3 günde bu kullanıcıya gönderilen mesajları listele.”

**Güvenli operasyonel istekler**

* “Pasif Android kullanıcılar için bir push taslağı oluştur.”
* “Welcome Flow adlı otomasyonu duraklat.”
* “VIP segmenti için sayımı yenile.”

### Yazma erişimi ne zaman etkinleştirilir

Yalnızca `mcp:write` istemcinin bir şeyi değiştirmesi gerekiyorsa.

Tipik durumlar:

* bir kampanya taslağı oluşturmak,
* bir akışı duraklatmak veya devam ettirmek,
* bir onay işlemi göndermek,
* veya operasyonel bir nesneyi yenilemek.

{% hint style="warning" %}
Kampanya gönderimi her zaman önce bir önizleme gerektirir.

Hedef kitle **100.000 kullanıcı**üzerindeyse, istek engellenir. Netmera bunun yerine bir panel bağlantısı döndürür.
{% endhint %}

### Yerleşik korumalar

Yazma işlemleri hem token kapsamı hem de panel izinleri tarafından kontrol altında tutulur.

Netmera ayrıca şu korumaları uygular:

* Yazma işlemleri şunu gerektirir `mcp:write`.
* Kampanya gönderimleri için ön izleme ve onay gerekir.
* Tüm işlemler panel izinlerinize göre yürütülür.
* Büyük gönderimler doğrudan MCP çalıştırmasından engellenir.
* Tüm işlemler denetim kayıtlarına kaydedilir.

### Sorun giderme

Kurulum çalışmıyorsa önce şunları kontrol edin:

1. token hâlâ geçerli mi,
2. token doğru kapsama sahip mi,
3. seçilen uygulama doğru mu,
4. ve kullanıcı izinleriniz işlem yapmaya izin veriyor mu.

#### Token süresi dolmuş

Yeni bir token isteyin.

Token geçerlilik süresi token türüne bağlıdır:

* **JWT** — 30 gün
* **OAuth erişim tokenı** — 8 saat

#### Yazma kapsamı gerekli

Bu, token’ınızın `mcp:read`.

Yeni bir token oluşturun, `"scope: \"mcp:write\""` ile oluşturulduğu anlamına gelir; eğer yazma işlemlerine ihtiyacınız varsa.

#### Başka bir uygulamaya erişilemiyor

Her token tek bir Netmera uygulamasına bağlıdır.

Kullanmak istediğiniz her uygulama için ayrı bir token oluşturun.

#### Gönderme isteği engellendi

Bu genellikle şu koşullardan birinin sağlanmadığı anlamına gelir:

* hedef kitle **100.000 kullanıcı**,
* önizleme tamamlandı,
* gerekli olduğunda onay tamamlandı,
* veya panel izinleriniz işleve izin veriyor.

#### Kullanıcı alanları maskeleniyor

Korumalı kişisel veriler için maskeleme beklenen bir durumdur.

PII’yi açığa çıkarmadan inceleme yapmak için profil, etkinlik ve mesaj geçmişini kullanın.

### Sonraki adım

Bağlantı çalıştıktan sonra, MCP sunucusunun neler yapabildiğini görmek için [Kullanılabilir API İşlevleri](/netmera-user-guide/netmera-user-guide-tr/yapay-zeka-ozellikleri/netmera-mcp-sunucusu/kullanilabilir-api-fonksiyonlari.md) ile devam edin.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/yapay-zeka-ozellikleri/netmera-mcp-sunucusu/netmera-mcp-sunucusunu-kurun.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.