Netmera MCP Sunucusunu Kurun

Netmera MCP Server'ı istemcinize bağlamak ve güvenli bir şekilde kullanmaya başlamak için bu kılavuzu kullanın.

Başlamadan önce

Şunlara sahip olduğunuzdan emin olun:

1. hedef Netmera uygulamasına erişim,

2. bağlayıcıları veya MCP erişimini destekleyen MCP uyumlu bir ortam,

3. ve Netmera panelinde doğru yetki seviyesi.

Erişim modeli

Her token bir Netmera uygulamasına bağlıdır. Token ayrıca panel izinlerinizi devralır. İstemciniz bu izinleri aşamaz.

Kapsamlar

Kapsam	İzin verdiği işlemler	En uygun olduğu kullanım
mcp:read	Raporlama, inceleme, analitik ve sorgulamalar	Güvenli analiz ve keşif
mcp:write	mcp:read artı oluşturma, güncelleme, gönderme, duraklatma, sürdürme ve onay işlemleri	İnsan kontrolüyle yürütülen operasyonel görevler

Şununla 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

Şununla başlayın mcp:read. Şuna geçin mcp:write yalnızca yazma erişimine ihtiyaç duyduğunuzda.

Netmera MCP Server'ı bağlayın

1

Bir token isteyin

Ortamınız doğrudan bağlayıcı oturum açmayı destekliyorsa, istendiğinde giriş akışını tamamlayın.

Ayrıca doğrudan bir token da isteyebilirsiniz:

POST https://<panel-adresi>/ai/mcp/auth/token
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "netmera-şifreniz",
  "scope": "mcp:read"
}

2

Netmera'yı istemcinize ekleyin

Netmera'yı istemcinizde bir bağlayıcı veya MCP kaynağı olarak ekleyin.

Ardından oturum açın ve hedef uygulama için erişimi onaylayın.

3

Bağlantıyı test edin

• “Uygulamamın bugün sağlık durumu nedir?”

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

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

4

Gerektiğinde kapsamı yükseltin

Tokenı şu kapsamla yeniden oluşturun: scope: "mcp:write" taslak oluşturmak veya onaylanmış işlemleri gerçekleştirmek istediğinizde.

İlk kurulum kontrolleri

Bağlandıktan sonra, devam etmeden önce bu temel noktaları doğrulayın:

• Beklenen uygulamaya bağlısınız.

• Gösterge panoları ve raporlar veri döndürüyor.

• Siz etkinleştirmediğiniz sürece yazma işlevleri kullanılamaz durumda kalır mcp:write.

Bir prompt'a neler dahil edilmeli

İlgili olduğunda şu ayrıntıları ekleyin:

1. Zaman aralığı — örneğin “son 7 gün”, “dün” veya “bu ay”

2. Hedef — örneğin bir kanal, kampanya, segment, kullanıcı, akış veya etkinlik

3. Çıktı — örneğin bir özet, sıralama, karşılaştırma, trend veya taslak

4. İşlem sınırı — örneğin “yalnızca hazırla”, “önizlemeyi göster” veya “gönderme”

Örnek prompt 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 fazla geliri hangi kampanyalar sağladı?”

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 talepler

• “Pasif Android kullanıcıları için bir push taslağı oluştur.”

• “Welcome Flow adlı otomasyonu duraklat.”

• “VIP segmentinin sayısını yenile.”

Yazma işlemleri nasıl çalışır

Yazma işlemleri kontrollü kalır.

MCP istemciniz yalnızca token kapsamınızın ve panel izinlerinizin izin verdiği işlemleri hazırlayabilir veya yürütebilir.

Kampanya gönderimi her zaman önce bir önizleme gerektirir.

Eğer kitle 100.000 kullanıcıyıaşarsa, istek engellenir. Netmera bunun yerine bir panel bağlantısı döndürür.

Yerleşik güvenlik önlemleri

• Yazma işlemleri şunu gerektirir: mcp:write.

• Kampanya gönderimleri önizleme ve onay gerektirir.

• Tüm işlemler panel izinlerinize uygun şekilde yürütülür.

• Büyük gönderimler doğrudan MCP üzerinden çalıştırılamaz.

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

Sorun giderme

Bir şey beklendiği gibi çalışmadığında, şu kontrollerle başlayın:

1. Token'ın hâlâ geçerli olduğunu doğrulayın.

2. Token'ın doğru kapsama sahip olduğunu doğrulayın.

3. Doğru Netmera uygulamasına bağlandığınızı doğrulayın.

4. İzinlerinizin işleme izin verdiğini doğrulayın.

Token süresi doldu

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 şu kapsamla oluşturulduğu anlamına gelir: mcp:read. Yazma işlemlerine ihtiyaç duyduğunuzda şu kapsamla yeni bir token oluşturun: scope: "mcp:write" when you need write actions.

Başka bir uygulamaya erişilemiyor

Her token 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 karşılanmadığı anlamına gelir:

• Kitle şu sayının altında: 100.000 kullanıcıyı.

• Önizleme tamamlandı.

• Gerektiğinde onay tamamlandı.

• Panel izinleriniz işleme izin veriyor.

Kullanıcı alanları maskelenmiş

Düzenlemeye tabi kişisel veriler için maskeleme beklenen bir durumdur. PII açığa çıkarmadan sorunu incelemek için profil, etkinlik ve mesaj geçmişini kullanın.