> For the complete documentation index, see [llms.txt](https://user.netmera.com/netmera-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/yapay-zeka-ozellikleri/netmera-mcp-sunucusu/netmera-mcp-sunucusunu-kurma.md).

# Netmera MCP sunucusunu kurma

Bu sayfayı ilk kullanım rehberiniz olarak kullanın.

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

Sonunda şunları yapmış olacaksınız:

* MCP uyumlu istemcinizi bağlayacak,
* bağlantının çalıştığını doğrulayacak,
* ve yazma erişimini ne zaman etkinleştirmeniz gerektiğini anlayacaksınız.

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

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

### Gerekenler

Bağlanmadan ö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 izin seviyesi.

### Erişimin nasıl çalıştığı

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

Token ayrıca Netmera panel izinlerinizi de 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, analitik ve sorgulamalar</td><td>İlk bağlantı ve güvenli keşif</td></tr><tr><td><code>mcp:write</code></td><td><code>mcp:read</code> artı oluşturma, güncelleme, gönderme, duraklatma, sürdürme ve onay işlemleri</td><td>İnsan onayıyla operasyonel işler</td></tr></tbody></table>

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

#### Token ömrü

<table><thead><tr><th width="322.541259765625">Token türü</th><th>Ömür</th></tr></thead><tbody><tr><td>JWT</td><td>30 gündür</td></tr><tr><td>OAuth erişim tokenı</td><td>8 saat</td></tr></tbody></table>

### Bağlantıyı kurun

Hedefiniz 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şeceğine 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ı girişi destekliyorsa, giriş akışını orada tamamlayın.

Tokenı doğrudan istemeniz gerekiyorsa şunu kullanın:

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

{
  "email": "your@email.com",
  "password": "your-netmera-password",
  "scope": "mcp:read"
}
```

Kullanın `mcp:read` salt okunur erişim için veya `mcp:write` kampanyalar oluşturma veya 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 şekildedir:

1. Aç **Ayarlar**, **Entegrasyonlar**, **Bağlayıcılar**, veya **MCP**.
2. Tıklayın **Bağlayıcı ekle**, **Kaynak ekle**, veya **Sunucu ekle**.
3. Seçin **Netmera** listede görünüyorsa.
4. İstendiğinde giriş işlemini 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 giriş** — 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, şunu kullanın **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 başlığı kombinasyonunu kabul eder.

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

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

{% step %}

#### 4) Birkaç basit soru sorun

İlk olarak düşük riskli istemler kullanın.

İlk başta kullanabileceğiniz iyi 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österin.”
  {% endstep %}

{% step %}

#### 5) Bağlantının gerçekten kurulduğunu doğrulayın

Şunlardan emin olun:

* doğru uygulamaya bağlı olduğunuzdan,
* raporların veri döndürdüğünden,
* ve yazma işlemlerinin hâlâ kullanılamadığından.
  {% endstep %}

{% step %}

#### 6) Yazma erişimini daha sonra etkinleştirin

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

ile 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 durumda hazırdır:

* istemci, salt okunur sorulara canlı Netmera verileriyle yanıt verir,
* uygulama bağlamı beklediğiniz uygulamayla eşleşir,
* ve siz etkinleştirmedikçe yazma yeteneği olan araçlar görünmez `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 olay
3. **Çıktı** — bir özet, eğilim, karşılaştırma, sıralama veya taslak
4. **İşlem sınırı** — `yalnızca hazırlayın`, `önizleme gösterin`, `gönderme`

#### Örnek istem kalıpları

**Analiz**

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

**Kitle ve kullanıcı incelemesi**

* “Churn-risk segmentinde kaç kullanıcı var?”
* “Bu kullanıcının son olaylarını gösterin.”
* “Son 3 gün içinde bu kullanıcıya gönderilen mesajları listeleyin.”

**Güvenli operasyonel talepler**

* “Atıl Android kullanıcıları için bir push taslağı oluşturun.”
* “Welcome Flow adlı otomasyonu duraklatın.”
* “VIP segmentinin sayısını yenileyin.”

### Yazma erişimini ne zaman etkinleştirmelisiniz

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

Tipik durumlar:

* bir kampanya taslağı oluşturmak,
* bir akışı duraklatmak veya sürdürmek,
* bir onay işlemi göndermek,
* veya bir operasyonel nesneyi yenilemek.

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

Kitle şu değeri aşarsa **100,000 users**istek engellenir. Netmera bunun yerine bir panel bağlantısı döndürür.
{% endhint %}

### Yerleşik güvenceler

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

Netmera ayrıca şu güvenceleri uygular:

* Yazma işlemleri şunları gerektirir `mcp:write`.
* Kampanya gönderimleri ön izleme ve onay gerektirir.
* Tüm işlemler panel izinlerinize uyar.
* Büyük gönderimler doğrudan MCP yürütmesinden engellenir.
* Tüm işlemler denetim günlüklerine kaydedilir.

### Sorun giderme

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

1. token hâlâ geçerli,
2. tokenın doğru kapsamı var,
3. seçilen uygulama doğru uygulama,
4. ve kullanıcı izinleriniz işlemeyi izin veriyor.

#### Token süresi doldu

Yeni bir token isteyin.

Token ömrü 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`.

ile yeni bir token oluşturun `scope: "mcp:write"` ile oluşturulduğu anlamına gelir; 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önderim isteği engellendi

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

* kitle şu değerin altındadır **100,000 users**,
* önizleme tamamlandı,
* gerektiğinde onay tamamlandı,
* veya panel izinleriniz işlemeye izin veriyor.

#### Kullanıcı alanları maskeleniyor

Maskleme, düzenlemeye tabi kişisel veriler için beklenen bir durumdur.

Kişisel verileri açığa çıkarmadan inceleme yapmak için profil, olay ve mesaj geçmişini kullanın.

### Sonraki adım

Bağlantı çalıştığında, şunla devam edin [Mevcut API İşlevleri](/netmera-user-guide/netmera-user-guide-tr/yapay-zeka-ozellikleri/netmera-mcp-sunucusu/kullanilabilir-mcp-islevleri.md) MCP sunucusunun neler yapabildiğini görmek için.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.