Netmera MCP sunucusunu kurun

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

Netmera MCP Sunucusuna ilk kez bağlanıyorsanız buradan başlayın.

Sonunda şunları yapabileceksiniz:

• MCP uyumlu istemcinizi bağlayın,

• bağlantının çalıştığını doğrulayın,

• ve yazma erişimini ne zaman etkinleştireceğinizi anlayın.

Şundan başlayın mcp:read.

Yazma işlemlerini etkinleştirmeden raporlama, analiz ve sorgulamalar yapabilirsiniz.

İhtiyacınız olanlar

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 yetki seviyesi.

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

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

Token ayrıca Netmera paneli izinlerinizi devralır.

MCP istemciniz, kullanıcı hesabınızın yapabildiklerinden fazlasını yapamaz.

Kapsamlar

Kapsam	Neye izin verir	En uygun olduğu durum
mcp:read	Raporlama, inceleme, analiz ve sorgulamalar	İlk bağlantı ve güvenli keşif
mcp:write	mcp:read artı oluşturma, güncelleme, gönderme, duraklatma, sürdürme ve onay işlemleri	İnsan incelemesiyle operasyonel çalışma

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

Token süresi

Token türü	Süre
JWT	30 gün
OAuth erişim tokenı	8 saat

Bağlantıyı kurun

Amacınız mümkün olan en kısa sürede çalışan bir bağlantı kurmaksa bu akışı izleyin.

1

1) Hedef uygulamayı seçin

İstemcinin erişmesini istediğiniz Netmera uygulamasını seçin.

Her token yalnızca 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ş sürecini orada tamamlayın.

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

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

{
  "email": "[e-mail]",
  "password": "your-netmera-password",
  "scope": "mcp:read"
}

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

1. Açın 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 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 oturum açı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ü isterse şunu kullanın 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, Warp, ve diğer MCP uyumlu istemciler aynı URL + Authorization başlığı kombinasyonunu kabul eder.

İstemci etiketleri değişebilir.

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

4

4) Birkaç basit soru sorun

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

İlk iyi promptlar:

• “Bugün uygulamamın sağlık durumu nedir?”

• “VIP segmentinde kaç kullanıcı var?”

• “Son 30 günün günlük gelirini gösterin.”

5

5) Bağlantının gerçekten kurulduğunu 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) Yazma erişimini daha sonra etkinleştirin

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

Şununla yeni bir token oluşturun: "scope": "mcp:write" hazır olduğunuzda.

Başarılı bir ilk kurulumun nasıl göründüğü

Kurulumunuz şu durumda hazırdır:

• istemci, salt okunur soruları canlı Netmera verileriyle yanıtlar,

• uygulama bağlamı beklediğiniz uygulamayla eşleşir,

• ve siz etkinleştirmedikçe yazma yeteneğine sahip araçlar görünmez mcp:write.

Daha iyi promptlar yazın

En iyi promptlar nettir.

İlgili 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ırlayın, önizlemeyi gösterin, göndermeyin

Örnek prompt kalıpları

Analiz

• “Son 7 gündeki uygulama performansını özetleyin.”

• “Son 14 gündeki push ve e-posta performansını karşılaştırın.”

• “Geçen hafta en çok geliri hangi kampanyalar sağladı?”

Hedef kitle ve kullanıcı incelemesi

• “Churn riski taşıyan segmentte kaç kullanıcı var?”

• “Bu kullanıcı için son etkinlikleri gösterin.”

• “Bu kullanıcıya son 3 günde gönderilen mesajları listeleyin.”

Güvenli operasyonel istekler

• “Pasif 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şimi ne zaman etkinleştirilir

Yalnızca şuna ihtiyacınız var mcp:write istemci 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 operasyonel bir nesneyi yenilemek.

100.000 kullanıcının üzerindeki büyük gönderimler

Hedef kitle şu sınırı aşarsa AI yürütmesinden engellenir., 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 önizleme ve onay gerektirir.

• Tüm işlemler panel izinlerinize göre çalışır.

• Büyük gönderimler doğrudan MCP yürütmesinde engellenir.

• Tüm işlemler denetim günlüklerine kaydedilir.

Sorun giderme

Kurulum çalışmazsa önce şunları kontrol edin:

1. token hâlâ geçerli,

2. token doğru kapsama sahip,

3. seçilen uygulama doğru olan,

4. ve kullanıcı izinleriniz bu işleme izin veriyor.

Tokenın süresi doldu

Yeni bir token isteyin.

Token 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 şu kapsamla oluşturulduğu anlamına gelir mcp:read.

Şununla yeni bir token oluşturun: "scope": "mcp:write" 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 şu sınırın altında, AI yürütmesinden engellenir.,

• önizleme tamamlandı,

• gerektiğinde onay tamamlandı,

• ya da panel izinleriniz bu işleme izin veriyor.

Kullanıcı alanları maskelenmiştir

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

PII'yi ifşa etmeden inceleme yapmak için profil, etkinlik ve mesaj geçmişini kullanın.

Sonraki adım

Bağlantı çalıştıktan sonra şuna devam edin Kullanılabilir API İşlevleri MCP sunucusunun neler yapabildiğini görmek için.