Ortto MCP Server

resmi

Ortto'nun yeni MCP Sunucusu, favori yapay zeka asistanınızı Ortto'ya bağlamanızı sağlar. Bağlandıktan sonra asistanınız, Ortto'nun CDP ve pazarlama otomasyon platformundan müşteri verilerine, kitlelere ve kampanya içgörülerine güvenli bir şekilde erişebilir.

Ortto MCP ile neler yapabilirsiniz?

  • Kampanya performans kontrolleri — E-posta, SMS, push veya yolculuk performans metriklerini (açılma oranları ve dönüşümler gibi) get_email_report, get_sms_report, get_push_report veya get_journey_report ile isteyin.
  • Kişi ve hedef kitle keşfi — Kişileri isme veya hedef kitle boyutuna göre bulun ve belirli alanlarla son kayıtları get_contacts ve get_audiences kullanarak çekin.
  • Kampanya ve varlık yönetimi — Kampanyaları listeleyin veya arayın, HTML e-posta varlıkları oluşturun ve bunların meta verilerini get_campaigns, create_asset ve update_asset_meta ile güncelleyin.
  • Bilgi tabanı organizasyonu — Kategoriler oluşturarak, HTML'den makaleler üreterek ve bunları create_category, create_article_from_html ve move_article ile taşıyarak yardım içeriğini oluşturun veya yeniden yapılandırın.
  • Hesap şeması ve marka içgörüleri — Veri şemanızı, özel alanlarınızı ve marka kitabı renklerini/yazı tiplerini get_schema ve get_brand_book aracılığıyla alın.

Dokümantasyon

MCP nedir?

Model Context Protocol (MCP), yapay zeka ajanlarının (Claude veya ChatGPT gibi) harici araçlar ve veri kaynaklarıyla güvenli bir şekilde etkileşim kurmasını sağlayan açık bir standarttır.

AI ajanınızı (MCP istemcisi) doğrudan Ortto'nun MCP sunucusuna bağlarsınız. Bu, ajanınızın Ortto verilerinizi anlamasını ve bu verilere göre hareket etmesini sağlar.

Ajanınız daha sonra doğal dil komutlarını kullanarak çeşitli görevlerde size yardımcı olabilir. Örneğin:

  • "Son 30 günün e-posta kampanyalarımın performansını göster."
  • "Dönüşümler açısından en iyi performans gösteren yolculuklar hangileri?"
  • "Bu ay en çok etkileşim alan kişilerimin listesini al."

MCP veri kaynağını yapılandırma

MCP özelliğimizi kullanmaya başlamak için Ortto hesabınızda MCP'yi bir veri kaynağı olarak oluşturmanız gerekir. Kurulum için şu adımları izleyin:

  1. Ortto hesabınızda CDP > Veri kaynakları bölümüne gidin.
  2. Yeni veri kaynağı'na tıklayın ve MCP arayın.
  3. MCP veri kaynağınız için bir ad girin ve Bağlan'a tıklayın.

4. Veri kaynağı oluşturulduktan sonra bir Kapsamlı anahtara erişebilirsiniz. Ortto'yu seçtiğiniz AI ajanına (Claude, ChatGPT vb.) bağlamak için bu anahtarı kullanmanız gerekir.

Artık Ortto'yu AI ajanınıza bağlamaya hazırsınız. Kullandığınız AI ajanına göre aşağıdaki uygun makaleyi inceleyin:

İPUCU: Ortto MCP'yi özel bağlayıcıları destekleyen herhangi bir uygulamaya bağlayabilirsiniz. Kullandığınız uygulama yukarıda listelenmemişse, Ortto hesabınızın barındırıldığı yere göre uygun uzak MCP sunucu URL'sini kullanmanız yeterlidir.

  • Amerika Birleşik Devletleri: https://mcp-api-us.ortto.app/mcp?jwt=your-scoped-key
  • Avrupa: https://mcp-api-eu.ortto.app/mcp?jwt=your-scoped-key
  • Avustralya: https://mcp-api-au.ortto.app/mcp?jwt=your-scoped-key

Hesabınızın nerede barındırıldığından emin değilseniz, uygulama içinde Ayarlar > Gizlilik, Güvenlik ve GDPR > Veri Barındırma bölümüne giderek bunu bulabilirsiniz.


Desteklenen araçlar/eylemler

Ortto MCP sunucusu, AI ajanlarının belirli araçlar/eylemler aracılığıyla Ortto verilerinizle etkileşim kurmasına olanak tanır. Aşağıdaki tablolar veri kategorisine göre düzenlenmiştir ve desteklenen araçları/eylemleri tanımlarıyla birlikte ayrıntılı olarak açıklar.

İPUCU: Aşağıdaki tablolarda özetlenen araçlar/eylemler, MCP özelliğimizin kullandığı adlandırma kuralıdır. Bu adları AI ajanı aracınızda açıkça kullanmanız gerekmez. Ajanınız, doğal dildeki isteğinize göre uygun aracı/eylemi otomatik olarak seçip kullanacaktır.

Kampanya yönetimi

Araç/EylemAçıklama
get_campaignsKampanyalarınızın listesini filtreleme ve sayfalama seçenekleriyle alın. Kampanya türüne, duruma ve arama sorgularına göre filtrelemeyi destekler.

Örnekler:

  • "Son ayki tüm e-posta kampanyalarımı göster"
  • "Şu anda çalışan kampanyaları al"
  • "Adında 'yaz' geçen kampanyaları bul"

Kişiler ve Hedef Kitleler

Araç/Eylem

Açıklama

get_contacts

Hedef kitle kimliği, alan seçimi ve arama yetenekleri dahil kapsamlı filtreleme seçenekleriyle kişileri alın.

get_audiences

Hesabınızdaki tüm hedef kitleleri arama ve sayfalama desteğiyle listeleyin.

Örnekler:

  • "Adında 'smith' geçen kişileri al"
  • "1.000'den az üyesi olan hedef kitleleri bul"
  • "Kaydolan son 10 kişinin e-posta adreslerini ve adlarını göster"

Kampanya raporları

Araç/Eylem

Açıklama

get_email_report

Açılma oranları, tıklama oranları ve etkileşim metrikleri dahil ayrıntılı e-posta kampanyası performans raporları oluşturun.

get_journey_report

Özelleştirilebilir zaman dilimleriyle kapsamlı yolculuk performans analizleri alın.

get_journey_shape_report

Belirli yolculuk şekillerini ve metriklerini analiz edin.

get_sms_report

SMS kampanyası performans verilerini ve etkileşim istatistiklerini alın.

get_push_report

Push bildirimi kampanyası analizlerine ve teslimat metriklerine erişin.

Örnekler:

  • "'Holiday Sale' kampanyası için bir e-posta raporu oluştur"
  • "'Abandoned Cart' yolculuğunun genel performansı nedir?"

Özel raporlar

Araç/EylemAçıklama
list_reportsOrtto hesabınızdan kullanıcı tarafından oluşturulan raporlara grafik türüne göre filtreleme ve arama yetenekleriyle erişin.
get_reportÖzelleştirilebilir zaman dilimleri ve yenileme seçenekleriyle belirli rapor verilerini alın.

Örnekler:

  • "Hesabımdaki tüm pasta grafik raporlarını listele"
  • "'Q3 Revenue' raporunun verilerini al"

Hesap ve yapılandırma

Araç/EylemAçıklama
get_schemaOrtto örneğiniz için özel alanlar ve veri yapısı dahil tam veri şemasını alın.
get_brand_bookRenkler, yazı tipleri ve marka öğeleri dahil marka kitabı ayarlarınıza erişin.

Örnekler:

  • "Marka kitabımızda tanımlanan birincil ve ikincil marka renkleri nelerdir?"
  • "Hesabımdaki adında 'example' geçen tüm özel alanları al"

Varlık yönetimi

Araç/Eylem

Açıklama

create_asset

Özelleştirilebilir içerik ve meta verilerle yeni varlıklar, öncelikle HTML e-postaları oluşturun.

get_asset_html

İnceleme veya değişiklik için mevcut varlıkların HTML içeriğini alın.

update_asset_meta

Adlar, konu satırları ve gönderici bilgileri dahil varlık meta verilerini güncelleyin.

Örnekler:

  • "'Can't Miss Savings' başlıklı, kullanıcıların yaklaşan satışı kaçırmaması gerektiğini açıklayan içerikle yeni bir promosyon e-postası varlığı oluşturun"
  • "'Welcome Email v2' adlı varlığın HTML içeriğini alın"

Bilgi tabanı

Araç/EylemAçıklama
get_indexKategoriler ve makale hiyerarşisi dahil bilgi tabanı yapısını alın.
create_categoryİsteğe bağlı üst-alt ilişkileriyle yeni bilgi tabanı kategorileri oluşturun.
create_article_from_htmlHTML içeriğinden kategorilendirme ile bilgi tabanı makaleleri oluşturun.
move_articleBilgi tabanınızdaki makaleleri kategoriler arasında taşıyın.
modify_indexBilgi tabanı dizin yapısını ve organizasyonunu güncelleyin.

Örnekler:

  • "Bu HTML'den bir bilgi tabanı makalesi oluşturun ve başlığını 'MCP Overview' yapın"
  • "'Troubleshooting' adında yeni bir kategori oluşturun"
  • "Mevcut bilgi tabanı yapısını göster"

İstek limitleri

Ortto MCP özelliği aracılığıyla bir AI ajanı kullandığınızda iki farklı limit setiyle karşılaşırsınız. AI ajanları (Claude veya ChatGPT gibi) istek uzunluğu ve yanıt boyutu konusunda kendi limitlerini uygularken, Ortto MCP sunucusu üzerinden yönlendirilen tüm API çağrıları standart Ortto API hız limitlerimize tabidir. Bu hız limitleri abonelik planınıza göre uygulanır ve sistem kararlılığını ve adil kullanımı sağlamak için uygulanır.

API hız limitleri hakkında daha fazla bilgi edinin.