Netmera MCP sunucusunu kurun

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.

Şununla başlayın mcp:read.

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

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

Kapsam	Ne sağlar	En uygun kullanım
mcp:read	Raporlama, inceleme, analitik 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 onayıyla operasyonel işler

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

Token ömrü

Token türü	Ömür
JWT	30 gündür
OAuth erişim tokenı	8 saat

Bağlantıyı kurun

Hedefiniz 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şeceğine 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ı girişi destekliyorsa, giriş akışını 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 veya mcp:write kampanyalar 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ç 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):

{
  "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

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

5

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.

6

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.

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.

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

Kitle şu değeri aşarsa 100,000 usersistek engellenir. Netmera bunun yerine bir panel bağlantısı döndürür.

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 MCP sunucusunun neler yapabildiğini görmek için.