Hubungkan Server MCP ke Bot Anda #

Server MCP memungkinkan bot AI Anda menggunakan alat dari sistem lain selama percakapan langsung — tanpa Anda harus membuat setiap alat secara manual. Anda cukup mengarahkan bot ke server MCP satu kali, dan setiap alat yang ditawarkan server tersebut akan tersedia bagi bot secara otomatis.

Jika Anda pernah menggunakan Fungsi Kustom, konsepnya sama, namun selangkah lebih maju: fungsi kustom adalah satu alat yang Anda hubungkan sendiri, sedangkan server MCP adalah paket alat siap pakai yang dapat ditemukan dan dipanggil sendiri oleh bot.

Apa Itu Server MCP? #

MCP (Model Context Protocol) adalah standar terbuka untuk memberikan asisten AI akses ke alat eksternal. Banyak aplikasi dan layanan modern kini menerbitkan “server MCP” — satu alamat web yang mengekspos sekumpulan alat yang dapat dipanggil oleh AI: mencari sesuatu, mengambil catatan, menjalankan kueri, membuat item.

Alih-alih mendeskripsikan setiap alat ke bot, Anda memberikan Your AI Connector alamat server dan kunci akses. Your AI Connector bertanya kepada server “apa yang bisa Anda lakukan?”, mendapatkan kembali daftar alat, dan menyediakannya untuk bot Anda. Saat server menambahkan alat baru, bot Anda dapat menggunakannya tanpa pengaturan tambahan di sisi Anda.

Fungsi Kustom vs Server MCP — mana yang harus digunakan:

Anda dapat menggunakan keduanya secara bersamaan pada Agen yang sama.

Cara Kerjanya (Versi Sederhana) #

1. Anda mendaftarkan server MCP di halaman MCP Servers — alamat web dan header otorisasi (biasanya kunci API).
2. Your AI Connector terhubung dan menemukan alat server tersebut, lalu mengingat daftarnya.
3. Anda mengaktifkan server pada Agen.
4. Selama percakapan, ketika pelanggan meminta sesuatu yang dapat dijawab oleh alat, bot memanggil alat tersebut, membaca hasilnya, dan membalas secara alami.

Pelanggan tidak akan pernah melihat proses di baliknya — mereka hanya mendapatkan jawaban yang didukung oleh informasi nyata dan terkini.

Berapa biaya panggilan alat MCP #

Panggilan alat dari server MCP ditagihkan persis seperti panggilan fungsi kustom, sesuai dengan tingkat Kualitas AI Agen Anda:

Menambahkan Server MCP (Langkah demi Langkah) #

Di bilah sisi utama, di bawah AI Studio, klik Server MCP. Kemudian klik + Tambah Server.

Isi formulir berikut:

Memilih Cara Masuk: Kunci API atau OAuth #

Your AI Connector mendukung dua cara untuk melakukan autentikasi dengan server. Pilih mana pun yang diperintahkan oleh dokumentasi server, menggunakan opsi Autentikasi di bagian atas formulir:

• Kunci API / header: metode asli yang dijelaskan di atas. Anda menempelkan kredensial tetap (kunci API atau token) ke dalam kolom Nilai Header Autentikasi, dan Your AI Connector mengirimkannya pada setiap permintaan. Paling cocok untuk server yang memberi Anda kunci yang tahan lama.
• OAuth (masuk): untuk server yang meminta Anda masuk alih-alih menempelkan kunci. Dengan OAuth, tidak ada kunci untuk disalin — Anda menyetujui akses dengan masuk, sama seperti cara kerja “Masuk dengan Google” di situs lain.

Untuk terhubung dengan OAuth:

1. Pilih OAuth sebagai metode autentikasi. Bidang Auth Header akan hilang, digantikan oleh kartu Connect — Anda tidak memerlukan kunci.

2. Isi Name dan Server URL, lalu klik Save. Server ditambahkan ke daftar Anda, tetapi untuk saat ini ditampilkan sebagai not connected.
3. Klik Connect pada server. Jendela masuk aman akan terbuka di mana Anda menyetujui akses.
4. Setujui, dan jendela akan tertutup dengan sendirinya. Server sekarang ditampilkan sebagai terhubung, dan Your AI Connector memuat alat-alatnya.

Selesai. Your AI Connector menjaga koneksi tetap segar secara otomatis di latar belakang, jadi biasanya Anda tidak perlu menyentuhnya lagi. Jika server sewaktu-waktu memutuskan koneksi (misalnya, masa berlaku masuk kedaluwarsa atau seseorang mencabutnya di sisi server), server akan ditampilkan sebagai terputus — cukup klik Hubungkan Kembali dan masuk lagi.

Jika server tidak dapat diatur secara otomatis saat Anda mengeklik Hubungkan, Anda akan diminta untuk menempelkan beberapa detail (alamat masuk dan ID klien) yang disediakan oleh dokumentasi server tersebut, kemudian proses Hubungkan akan menyelesaikan masuk.

Uji Koneksi #

Sebelum menyimpan, klik Uji Koneksi. Your AI Connector menghubungi server dan menunjukkan daftar alat yang ditawarkannya. Ini adalah cara tercepat untuk memastikan URL dan kunci Anda sudah benar — jika koneksi gagal, Anda akan melihat pesan kesalahan di sana alih-alih mengetahuinya di tengah percakapan.

Jika pengujian berhasil, klik Simpan. Server Anda akan muncul dalam daftar dengan titik status berwarna hijau dan jumlah alat yang ditawarkannya.

Membaca Daftar Server #

Setiap server dalam daftar menampilkan:

• Titik status — hijau jika koneksi terakhir berhasil, merah jika percobaan terakhir gagal (arahkan kursor untuk melihat kesalahan), abu-abu sebelum koneksi pertama yang berhasil.
• Alamat server dan berapa banyak alat yang ditawarkannya saat ini.
• Tombol aktif/nonaktif untuk mengaktifkan atau menonaktifkan seluruh server dengan cepat tanpa menghapusnya.

Your AI Connector menyegarkan daftar alat setiap server di latar belakang sekitar sekali sehari, sehingga alat baru akan muncul dengan sendirinya. Server yang lambat atau tidak dapat dijangkau sementara tidak akan pernah menghambat percakapan — bot cukup menggunakan daftar alat terakhir yang diketahui, dan beralih dengan lancar jika panggilan tidak dapat tersambung.

Memilih Alat yang Dapat Digunakan Bot #

Sebuah server sering kali menawarkan lebih banyak alat daripada yang Anda inginkan untuk diakses oleh bot. Anda dapat mengaktifkan atau menonaktifkan alat tertentu tanpa memutuskan sambungan seluruh server.

1. Klik ikon pensil (edit) pada server di dalam daftar.
2. Gulir ke bagian Alat — setiap alat yang ditawarkan server akan tercantum, masing-masing dengan tombol aktif/nonaktifnya sendiri.
3. Matikan alat apa pun yang tidak ingin Anda panggil oleh bot, atau gunakan Aktifkan semua / Nonaktifkan semua untuk mengaturnya sekaligus.
4. Klik Simpan perubahan.

Hanya alat yang tetap aktif yang akan ditawarkan kepada bot. Alat yang dimatikan akan sepenuhnya tidak terlihat oleh bot — bot tidak dapat memanggilnya, dan alat tersebut tidak akan dihitung dalam batas 40 alat.

Dua hal yang perlu diketahui:

• Alat baru tetap nonaktif sampai Anda menyalakannya. Setelah Anda mengurasi alat server, alat apa pun yang ditambahkan server nantinya akan muncul dalam keadaan nonaktif, sehingga tidak ada hal baru yang tersedia bagi bot sampai Anda memutuskan untuk mengaktifkannya. (Server yang belum pernah Anda kurasi akan tetap mengaktifkan semua alatnya, persis seperti sebelumnya.)
• Ini terpisah dari pilihan Agen di bawah. Di sini Anda memutuskan alat server mana yang ada secara keseluruhan akun; pada Agen, Anda memutuskan server mana yang dapat dijangkau oleh Agen tersebut — dan, jika diinginkan, mempersempit alatnya lebih lanjut khusus untuk Agen tersebut.

Mengatur Batas Eksekusi per Alat #

Di samping tombol on/off setiap alat, Anda akan menemukan kontrol Batas. Kontrol ini membuka pengaturan batas eksekusi yang sama seperti yang dapat Anda tetapkan pada fungsi kustom, yang diterapkan hanya pada alat tersebut — berguna saat alat server memanggil layanan pihak ketiga berbayar, atau saat alat hanya boleh dijalankan sekali per percakapan. Semua yang ada di sini bersifat opsional; biarkan kosong dan alat akan berperilaku persis seperti sebelumnya.

• Baca-saja. Beberapa server menyatakan untuk setiap alat apakah alat tersebut hanya membaca data. Otomatis (pengaturan server) memercayai pernyataan tersebut; Anda dapat menggantinya ke kedua arah — tandai alat sebagai Baca-saja jika Anda tahu alat tersebut tidak pernah membuat atau mengubah apa pun (ini memungkinkan AI untuk mencoba kembali balasan yang terputus dengan aman alih-alih membiarkan pelanggan tanpa jawaban), atau Bukan baca-saja jika Anda tidak memercayai klaim server tersebut.
• Sajikan hasil cache pada panggilan berulang. Saat AI memanggil alat lagi dengan input yang sama, hasil sebelumnya akan digunakan kembali (hingga 24 jam) alih-alih memanggil server lagi.
• Maksimal berjalan per percakapan dan maksimal berjalan per jendela waktu berfungsi persis seperti pada fungsi kustom: hanya untuk eksekusi yang berhasil, dan ketika batas tercapai, AI akan diberi tahu alasannya dan menjawab dengan informasi yang sudah dimilikinya — pelanggan tidak akan pernah dibiarkan menunggu tanpa kepastian. Percakapan uji coba dikecualikan.

Satu catatan jujur tentang kepercayaan: batas mengontrol apakah dan seberapa sering kami memanggil server — batas tersebut tidak dapat mengubah apa yang dilakukan server secara internal setelah dipanggil. Dan mengganti alat pihak ketiga menjadi Baca-saja adalah klaim yang lebih kuat daripada pada fungsi kustom Anda sendiri, karena itu adalah kode milik orang lain; lakukan hanya untuk alat yang Anda pahami.

Mengaktifkan Server pada Agen #

Mendaftarkan server membuatnya tersedia; Anda tetap memilih Agen mana yang dapat menggunakannya.

1. Buka Agent dan buka tab AI Abilities-nya. (Untuk kampanye yang masih menyimpan pengaturan AI-nya sendiri secara langsung alih-alih melalui Agen terpisah, daftar yang sama akan muncul di langkah AI Abilities kampanye tersebut.)
2. Temukan bagian MCP servers.
3. Aktifkan setiap server yang ingin Anda gunakan oleh bot Agen ini.
4. Klik Save changes — pilihan hanya akan berlaku setelah disimpan.

Anda dapat mengaktifkan hingga 5 server per Agen. Hanya server yang Anda aktifkan yang tersedia untuk bot Agen tersebut, yang menjaga bot tetap fokus pada alat yang relevan.

Memilih Alat Mana yang Dapat Digunakan Agen #

Setelah server diaktifkan pada Agen, Anda juga dapat mempersempit alat mana saja yang boleh dipanggil oleh Agen tersebut — berguna ketika satu Agen hanya boleh membaca data sementara Agen lain juga boleh membuat catatan.

1. Pada tab Kemampuan AI, di bawah server yang diaktifkan, klik baris “… alat diaktifkan untuk agen ini” untuk memperluas daftar alat.
2. Matikan alat apa pun yang tidak boleh digunakan oleh Agen ini, lalu klik Simpan perubahan.

Dua aturan menjaga hal ini tetap dapat diprediksi:

• Agen hanya dapat mempersempit, tidak pernah memperluas. Alat yang Anda matikan di tingkat akun (pada halaman Server MCP) tidak muncul di sini dan tidak dapat diaktifkan kembali untuk satu Agen saja.
• Agen mewarisi secara default. Agen yang daftar alatnya belum Anda sentuh akan mengikuti pilihan tingkat akun — termasuk alat yang Anda aktifkan di sana nantinya. Setelah Anda mempersempit daftar Agen, alat baru akan tetap nonaktif untuk Agen tersebut sampai Anda mengaktifkannya.

Contoh Siap Pakai: Menghubungkan Toko Shopify #

Setiap toko Shopify dilengkapi dengan server MCP bawaan — tidak perlu menginstal aplikasi, tidak perlu membuat kunci. Shopify menghostingnya di alamat web toko itu sendiri dengan menambahkan /api/mcp di bagian akhir.

Apa yang didapatkan bot darinya:

• Pencarian produk — temukan produk dengan mendeskripsikan apa yang diinginkan pelanggan (“jaket lari hangat di bawah $100”), lengkap dengan harga langsung, varian, dan stok.
• Detail produk — informasi lengkap mengenai produk tertentu, termasuk opsi dan ketersediaan.
• Kebijakan toko dan FAQ — pertanyaan seputar pengiriman, pengembalian, pengembalian dana, dan privasi, yang dijawab langsung dari halaman toko tersebut.
• Keranjang — buat keranjang untuk pelanggan dan berikan tautan pembayaran kepada mereka.

Untuk menghubungkannya, tambahkan server dengan:

Simpan, klik Test Connection, dan aktifkan server pada agen Anda — itulah seluruh pengaturannya.

Dua hal yang perlu diketahui:

• Pesanan tidak ada di server ini. Shopify sengaja menjauhkan data pesanan dari titik akhir publik ini. Untuk pertanyaan “di mana pesanan saya?”, pasangkan server ini dengan satu fungsi kustom — lihat contoh status pesanan Shopify.
• Ini berfungsi untuk toko Shopify mana pun — termasuk toko klien jika Anda mengelola akun untuk orang lain. Yang Anda butuhkan hanyalah alamat web toko tersebut.

Keamanan — Hanya Hubungkan Server yang Anda Percayai #

Server MCP yang Anda hubungkan dapat dipanggil oleh bot Anda dan dapat mengembalikan teks yang dibaca dan ditindaklanjuti oleh bot. Perlakukan ini seperti integrasi lain yang memegang kunci ke sistem Anda:

• Hanya daftarkan server yang Anda kendalikan atau percayai sepenuhnya. Deskripsi alat ditulis oleh siapa pun yang menjalankan server tersebut, dan bot membaca deskripsi itu untuk memutuskan kapan harus menggunakan alat.
• Gunakan kunci API khusus yang terbatas, bukan kredensial admin. Kunci Anda disimpan dengan aman dan tidak pernah ditampilkan dalam ekspor data. Hal yang sama berlaku untuk masuk OAuth — token akses disimpan dengan aman dan disunting dari ekspor apa pun.
• URL harus berupa alamat https:// publik. Alamat internal, localhost, dan jaringan pribadi ditolak demi keamanan.
• Nonaktifkan server segera setelah Anda tidak lagi mempercayainya — matikan atau hapus server tersebut, dan server itu akan segera hilang dari setiap Agen.

Pemecahan Masalah #

• Titik status merah / koneksi gagal: Buka kembali server dan klik Test Connection untuk melihat kesalahan yang tepat. Penyebab paling umum adalah kunci yang salah atau kedaluwarsa, kesalahan pengetikan pada URL, atau server yang memerlukan nama header selain Authorization.
• Server OAuth berhenti berfungsi / meminta Anda untuk menyambungkan kembali: Masuk OAuth dapat dicabut atau kedaluwarsa di sisi server. Buka server dan klik Connect lagi untuk masuk kembali. Perhatikan bahwa masuk OAuth tidak pernah disalin antar akun, jadi server Agen atau kampanye yang disalin harus disambungkan kembali di akun tempat Anda menyalinnya.
• Bot tidak menggunakan alat: Pertama, periksa apakah alat tersebut diaktifkan di bagian Tools server (edit server untuk melihat daftarnya) — alat yang dimatikan tidak terlihat oleh bot. Kemudian pastikan server diaktifkan pada Agen tertentu tersebut, dan permintaan pelanggan dengan jelas cocok dengan fungsi alat tersebut. Seperti halnya fungsi kustom, nama dan deskripsi alat yang jelas di sisi server membantu bot memilih dengan benar.
• Alat yang ditawarkan server tidak muncul untuk bot: Jika Anda telah mengurasi alat server ini, ingatlah bahwa alat apa pun yang ditambahkan setelah Anda mengurasi akan muncul dalam keadaan mati. Edit server, buka bagian Tools, dan aktifkan.
• Apakah konektor menangani sesi HTTP MCP? Ya. Jika server Anda mengeluarkan header mcp-session-id saat koneksi dibuat, kami menyimpannya dan mengirimkannya kembali pada setiap permintaan berikutnya, bersama dengan header MCP-Protocol-Version. Server stateful berfungsi tanpa konfigurasi tambahan di sisi Anda.
• Alat dilewati: Agen dapat menggunakan paling banyak 5 server dan 40 alat MCP sekaligus. Jika server menawarkan sejumlah besar alat, beberapa mungkin tidak dimuat — matikan alat yang tidak Anda perlukan di bagian Tools server, atau buat setiap server tetap fokus pada alat yang benar-benar Anda gunakan.

Persyaratan Paket #

Server MCP adalah bagian dari perangkat pengembang, bersama dengan fungsi kustom. Jika Anda tidak melihat MCP Servers di bagian AI Studio pada bilah sisi, paket Anda saat ini tidak menyertakannya — tingkatkan ke paket dengan perangkat pengembang untuk mengaktifkannya.

Langkah Selanjutnya #

• Fungsi Kustom — hubungkan satu alat secara manual alih-alih menghubungkan seluruh server.
• Agen AI — tempat server MCP diaktifkan untuk bot.
• Agen AI — halaman utama grup AI Studio tempat MCP Servers berada.