Ortto MCP Server

Apa itu MCP?

Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan agen AI (seperti Claude atau ChatGPT) untuk berinteraksi secara aman dengan alat eksternal dan sumber data.

Anda menghubungkan agen AI Anda (klien MCP) secara langsung ke server MCP Ortto. Ini memungkinkan agen Anda untuk memahami dan bertindak berdasarkan data Ortto Anda.

Agen Anda kemudian dapat membantu berbagai tugas menggunakan perintah bahasa alami. Contohnya:

• "Tunjukkan performa kampanye email saya dari 30 hari terakhir."
• "Journey mana yang berkinerja terbaik dalam hal konversi?"
• "Beri saya daftar kontak paling terlibat saya bulan ini."

---

Mengonfigurasi sumber data MCP

Untuk memulai dengan fitur MCP kami, Anda perlu membuat MCP sebagai sumber data di akun Ortto Anda. Ikuti langkah-langkah berikut untuk mengaturnya:

1. Di akun Ortto Anda, navigasikan ke CDP > Data sources.
2. Klik New data source dan cari MCP.
3. Masukkan nama untuk sumber data MCP Anda dan klik Connect.

4. Setelah sumber data dibuat, Anda akan memiliki akses ke Scoped key. Anda perlu menggunakan kunci ini untuk menghubungkan Ortto ke agen AI pilihan Anda (Claude, ChatGPT, dll.).

Anda sekarang siap untuk menghubungkan Ortto ke agen AI Anda. Tergantung pada agen AI yang Anda gunakan, periksa artikel yang sesuai di bawah ini:

• Menggunakan Ortto MCP dengan Claude
• Menggunakan Ortto MCP dengan ChatGPT

TIP: Anda dapat menghubungkan Ortto MCP dengan aplikasi apa pun yang mendukung konektor kustom. Jika aplikasi yang Anda gunakan tidak tercantum di atas, cukup gunakan URL server MCP jarak jauh yang sesuai berdasarkan lokasi hosting akun Ortto Anda.

• Amerika Serikat: https://mcp-api-us.ortto.app/mcp?jwt=your-scoped-key
• Eropa: https://mcp-api-eu.ortto.app/mcp?jwt=your-scoped-key
• Australia: https://mcp-api-au.ortto.app/mcp?jwt=your-scoped-key

Jika Anda tidak yakin di mana akun Anda di-hosting, Anda dapat menemukannya di aplikasi dengan menavigasi ke Settings > Privacy, Security and GDPR > Data Hosting.

---

Alat/aksi yang didukung

Server MCP Ortto memungkinkan agen AI untuk berinteraksi dengan data Ortto Anda melalui alat/aksi tertentu. Tabel berikut diorganisir berdasarkan kategori data dan merinci alat/aksi yang didukung beserta definisinya.

TIP: Alat/aksi yang diuraikan dalam tabel di bawah hanyalah konvensi penamaan yang digunakan oleh fitur MCP kami. Anda tidak perlu secara eksplisit menggunakan nama-nama ini di alat agen AI Anda. Agen Anda akan secara otomatis memilih dan menggunakan alat/aksi yang sesuai berdasarkan permintaan Anda dalam bahasa alami.

Manajemen kampanye

Alat/Aksi	Deskripsi
get_campaigns	Ambil daftar kampanye Anda dengan opsi pemfilteran dan paginasi. Mendukung pemfilteran berdasarkan jenis kampanye, status, dan kueri pencarian.

Contoh:

• "Tunjukkan semua kampanye email saya dari bulan lalu"
• "Dapatkan kampanye yang sedang berjalan"
• "Temukan kampanye dengan nama 'summer'"

Kontak dan Audiens

Alat/Aksi	Deskripsi
get_contacts	Ambil kontak dengan opsi pemfilteran komprehensif termasuk ID audiens, pemilihan bidang, dan kemampuan pencarian.
get_audiences	Daftar semua audiens di akun Anda dengan dukungan pencarian dan paginasi.

Contoh:

• "Ambil kontak apa pun dengan nama 'smith'"
• "Temukan audiens yang memiliki kurang dari 1.000 anggota"
• "Tunjukkan alamat email dan nama untuk 10 kontak terakhir yang mendaftar"

Laporan kampanye

Alat/Aksi	Deskripsi
get_email_report	Hasilkan laporan performa kampanye email terperinci termasuk tingkat buka, tingkat klik, dan metrik keterlibatan.
get_journey_report	Dapatkan analitik performa journey komprehensif dengan kerangka waktu yang dapat disesuaikan.
get_journey_shape_report	Analisis bentuk journey tertentu dan metriknya.
get_sms_report	Ambil data performa kampanye SMS dan statistik keterlibatan.
get_push_report	Akses analitik kampanye notifikasi push dan metrik pengiriman.

Contoh:

• "Hasilkan laporan email untuk kampanye 'Holiday Sale'"
• "Bagaimana performa keseluruhan journey 'Abandoned Cart'?"

Laporan kustom

Alat/Aksi	Deskripsi
list_reports	Akses laporan yang dibuat pengguna dari akun Ortto Anda dengan pemfilteran berdasarkan jenis bagan dan kemampuan pencarian.
get_report	Ambil data laporan tertentu dengan kerangka waktu yang dapat disesuaikan dan opsi penyegaran.

Contoh:

• "Daftar semua laporan bagan pai di akun saya"
• "Ambil data untuk laporan 'Q3 Revenue'"

Akun dan konfigurasi

Alat/Aksi	Deskripsi
get_schema	Ambil skema data lengkap untuk instance Ortto Anda, termasuk bidang kustom dan struktur data.
get_brand_book	Akses pengaturan brand book Anda termasuk warna, font, dan elemen branding.

Contoh:

• "Apa warna merek primer dan sekunder yang ditentukan dalam brand book kami?"
• "Ambil semua bidang kustom di akun saya yang memiliki 'example' di namanya"

Manajemen aset

Alat/Aksi	Deskripsi
create_asset	Buat aset baru, terutama email HTML, dengan konten dan metadata yang dapat disesuaikan.
get_asset_html	Ambil konten HTML dari aset yang ada untuk ditinjau atau dimodifikasi.
update_asset_meta	Perbarui metadata aset termasuk nama, baris subjek, dan informasi pengirim.

Contoh:

• "Buat aset email promosi baru berjudul 'Can't Miss Savings' dengan konten yang menjelaskan mengapa pengguna tidak boleh melewatkan penjualan mendatang"
• "Ambil konten HTML dari aset bernama 'Welcome Email v2'"

Basis pengetahuan

Alat/Aksi	Deskripsi
get_index	Ambil struktur basis pengetahuan termasuk kategori dan hierarki artikel.
create_category	Buat kategori basis pengetahuan baru dengan hubungan induk-anak opsional.
create_article_from_html	Buat artikel basis pengetahuan dari konten HTML dengan kategorisasi.
move_article	Pindahkan artikel antar kategori di basis pengetahuan Anda.
modify_index	Perbarui struktur indeks basis pengetahuan dan organisasinya.

Contoh:

• "Hasilkan artikel basis pengetahuan dari HTML ini dan beri judul 'MCP Overview'"
• "Buat kategori baru bernama 'Troubleshooting'"
• "Tunjukkan struktur basis pengetahuan saat ini"

---

Batas permintaan

Saat Anda menggunakan agen AI melalui fitur MCP Ortto, Anda akan menghadapi dua set batasan yang berbeda. Meskipun agen AI (seperti Claude atau ChatGPT) memberlakukan batasan mereka sendiri terkait panjang permintaan dan ukuran respons, semua panggilan API yang dirutekan melalui server MCP Ortto tunduk pada batas tingkat API Ortto standar kami. Batas tingkat ini berlaku berdasarkan paket langganan Anda dan diterapkan untuk memastikan stabilitas sistem dan penggunaan yang adil.

Pelajari lebih lanjut tentang batas tingkat API.