Netmera MCP Sunucusunu Kurma

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.

Şununla başlayın mcp:read.

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

İ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

Kapsam	Ne sağlar	En uygun kullanım
mcp:read	Raporlama, inceleme, analiz ve sorgulama	İlk bağlantı ve güvenli keşif
mcp:write	mcp:read ayrıca oluşturma, güncelleme, gönderme, duraklatma, devam ettirme ve onay işlemleri	İnsan onaylı operasyonel çalışmalar

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

Token geçerlilik süresi

Token türü	Geçerlilik süresi
JWT	30 gün
OAuth erişim tokenı	8 saat

Bağlantıyı kurun

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

1

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.

2

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:

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

{
  "email": "[e-mail]",
  "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.

3

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ılarveya MCP.

2. Şuna tıklayın Bağlayıcı ekle, Kaynak ekleveya 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):

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

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

İstemci etiketleri değişebilir.

Bazı istemciler buna bir bağlayıcıder. Diğerleri buna bir MCP sunucusu, araç kaynağıveya entegrasyon

4

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

5

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.

6

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.

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.

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.

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 ile devam edin.