Ortto MCP Server
resmiOrtto'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_reportveyaget_journey_reportile 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_contactsveget_audienceskullanarak ç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_assetveupdate_asset_metaile güncelleyin. - Bilgi tabanı organizasyonu — Kategoriler oluşturarak, HTML'den makaleler üreterek ve bunları
create_category,create_article_from_htmlvemove_articleile 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_schemaveget_brand_bookaracı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:
- Ortto hesabınızda CDP > Veri kaynakları bölümüne gidin.
- Yeni veri kaynağı'na tıklayın ve MCP arayın.

- 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ç/Eylem | Açıklama |
|---|---|
| get_campaigns | Kampanyaları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ç/Eylem | Açıklama |
|---|---|
| list_reports | Ortto 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ç/Eylem | Açıklama |
|---|---|
| get_schema | Ortto örneğiniz için özel alanlar ve veri yapısı dahil tam veri şemasını alın. |
| get_brand_book | Renkler, 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ç/Eylem | Açıklama |
|---|---|
| get_index | Kategoriler 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_html | HTML içeriğinden kategorilendirme ile bilgi tabanı makaleleri oluşturun. |
| move_article | Bilgi tabanınızdaki makaleleri kategoriler arasında taşıyın. |
| modify_index | Bilgi 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.