Koneksi MCP untuk Agen Kustom

Koneksi MCP (Model Context Protocol) memungkinkan Agen Kustom Anda terhubung dengan aman ke aplikasi eksternal. Dengan koneksi MCP, agen Anda dapat membaca informasi dan mengambil tindakan menggunakan koneksi yang telah dikonfigurasi sebelumnya dengan aplikasi seperti Linear, Ramp, Figma, dan lainnya—atau terhubung ke aplikasi apa pun dengan menyiapkan koneksi MCP kustom.

Catatan: Koneksi MCP hanya tersedia pada paket Business dan Paket Perusahaan.

Koneksi MCP memungkinkan Agen Kustom berinteraksi dengan alat dan layanan eksternal melalui Model Context Protocol. Alat MCP berfungsi dengan semua jenis pemicu, termasuk proses terjadwal, proses yang dipicu berdasarkan acara Notion atau Slack, dan proses manual dari obrolan atau @sebutan.

Fitur utama:

• Server pra-konfigurasi: Terhubung dengan cepat ke aplikasi populer tanpa konfigurasi tambahan apa pun.

• Server kustom: Terhubung ke alat apa pun yang mendukung server MCP yang dihosting menggunakan URL yang tersedia untuk umum.

• Kustomisasi: Alat untuk setiap koneksi dapat diaktifkan atau dinonaktifkan menggunakan Tombol, dan Anda dapat memilih apakah akan memerlukan konfirmasi sebelum menjalankan, menjalankan secara otomatis, atau mengizinkan semua alat dari server secara permanen.

Setiap koneksi MCP bersifat unik untuk satu Agen Kustom dan menggunakan kredensial orang yang mengautentikasinya. Koneksi tidak dibagikan antar agen, meskipun mereka terhubung ke layanan yang sama.

Ini berarti:

• Jika Anda menyiapkan koneksi Figma untuk Agen Kustom A, Agen Kustom B akan memerlukan koneksi Figma yang terpisah.

• Anda harus masuk ke setiap MCP Server untuk setiap Agen Kustom yang Anda konfigurasikan.

• Mencabut koneksi di satu Agen Kustom tidak memengaruhi Agen Kustom lainnya.

Anda dapat terhubung ke aplikasi berikut tanpa konfigurasi tambahan apa pun:

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• Intercom

• Linear

• Mercury

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. Buka Settings Agen Kustom Anda.

2. Buka Tools & Access.

3. Klik Add connection → Add.

4. Pilih server yang telah dikonfigurasi sebelumnya.

5. Ikuti perintah autentikasi untuk menghubungkan akun Anda.

6. Pilih alat dari server yang ingin digunakan oleh Agen Kustom Anda. Alat ini akan bervariasi tergantung pada server yang Anda pilih.

7. Klik Connect.

Untuk terhubung ke MCP Server yang tidak ada dalam daftar yang telah dikonfigurasi sebelumnya, admin ruang kerja harus mengaktifkan opsi ini terlebih dahulu. Ada dua pengaturan terpisah: satu untuk mengizinkan MCP Server kustom, dan satu lagi untuk menentukan apakah anggota dapat menginstal koneksi apa pun atau hanya koneksi yang Anda setujui.

Untuk mengizinkan MCP Server kustom:

1. Sebagai admin ruang kerja, buka Settings → Koneksi.

2. Di tab Manage, aktifkan Tombol Enable MCP Server kustom.

Untuk memilih apakah anggota dapat menginstal koneksi apa pun atau hanya koneksi yang disetujui admin:

1. Sebagai admin ruang kerja, buka Settings → Koneksi.

2. Di tab Manage, temukan bagian Manage permissions.

3. Di samping Limit which connections members can install, pilih salah satu:

   • Approved & recommended: Menyetujui secara otomatis semua koneksi yang direkomendasikan oleh Notion.

   • Approved only: Memilih secara manual setiap koneksi yang dapat diinstal oleh anggota.

4. Pilih Approved connections untuk meninjau apa yang dapat diinstal oleh anggota.

5. Pilih Add approved connection, lalu pilih apa yang ingin Anda izinkan:

   • Koneksi: Cari koneksi berdasarkan nama atau ID dan tambahkan ke daftar yang disetujui.

   • MCP Server kustom: Tambahkan URL MCP Server kustom tertentu yang ingin Anda izinkan.

6. Klik Save.

Setelah ini diatur, siapa pun di ruang kerja dapat terhubung ke opsi yang disetujui saat mereka menyiapkan Agen Kustom. Mereka akan melakukan autentikasi dengan kredensial mereka sendiri.

Untuk menambahkan MCP kustom ke Agen Kustom:

1. Buka Settings Agen Kustom Anda.

2. Buka Tools & Access.

3. Klik Add koneksi → MCP Server kustom.

4. Anda perlu memasukkan URL MCP Server dari alat atau penyedia yang Anda hubungkan (misalnya: tim alat internal perusahaan Anda).

5. Berikan nama tampilan untuk koneksi tersebut (opsional).

6. Tambahkan detail autentikasi yang diperlukan.

7. Klik Connect.

MCP Server kustom mungkin mendukung satu atau kedua metode masuk berikut:

• OAuth

• Autentikasi berbasis Header

  (contohnya, kunci API atau token bearer)

Beberapa server OAuth tidak mendukung pendaftaran klien dinamis (DCR). Ini berarti Notion harus mendaftarkan aplikasi klien terlebih dahulu dengan layanan pihak ketiga sebelum masuk OAuth dapat berfungsi. Jika MCP Server yang ingin Anda gunakan tidak mendukung DCR, periksa dokumentasinya untuk melihat apakah Anda dapat menggunakan kunci API atau token bearer sebagai gantinya. Jika tidak ada opsi yang tersedia, MCP Server tidak dapat digunakan dengan Agen Kustom.

Anda dapat memutuskan bagaimana Agen Kustom harus menggunakan koneksi MCP di Pengaturan agen Anda di bawah Alat & Akses. Perluas entri koneksi MCP untuk melihat alat yang tersedia dan menentukan cara menjalankannya. Alat dapat diaktifkan atau dinonaktifkan menggunakan Tombol di sebelahnya.

Alat baca dan tulis

• Alat baca (contoh: cari, ambil, daftar, lihat) memungkinkan Agen Kustom untuk mengambil atau melihat informasi tanpa membuat perubahan pada sistem eksternal.

• Alat tulis (contoh: buat, perbarui, Hapus, kirim, posting) membuat perubahan pada data di sistem eksternal. Secara default, alat ini membutuhkan konfirmasisebelum Agen Kustom menjalankan tindakan tersebut.

Jalankan secara otomatis atau selalu tanya

• Jalankan secara otomatis memungkinkan alat untuk dijalankan tanpa memerlukan konfirmasi dari pengguna. Pengaturan ini paling baik untuk alat baca (cari, ambil, daftar, lihat) karena alat tersebut tidak memodifikasi data.

• Selalu tanya mengharuskan pengguna untuk menyetujui atau membatalkan tindakan sebelum dijalankan. Ini adalah pengaturan default untuk alat tulis (buat, perbarui, hapus, kirim) guna mencegah perubahan yang tidak diinginkan.

• Selalu izinkan menyetujui semua alat dari server secara permanen dan menghapus permintaan konfirmasi di masa mendatang.

Untuk menghapus koneksi MCP

1. Buka Pengaturan Agen Kustom Anda.

2. Buka Tools & Access.

3. Temukan koneksi MCP dan klik Putuskan sambungan.

4. Klik Putuskan sambungan untuk mengonfirmasi.

5. Selalu uji Agen Kustom Anda setelah melakukan perubahan. Anda dapat menyambungkan kembali kapan saja dengan melakukan autentikasi lagi.

Catatan: Jika Anda menghapus koneksi, Agen Kustom tidak dapat lagi mengakses layanan tersebut dan jadwal proses yang bergantung pada server tersebut mungkin gagal. Alur kerja Agen Kustom Anda mungkin rusak segera setelah Anda memutuskan sambungan. Anda dapat menyambungkan kembali kapan saja dengan melakukan autentikasi lagi.

Koneksi MCP mematuhi tingkat izin pengguna yang ditetapkan pada Agen Kustom Anda. Berikut adalah apa yang dapat dilakukan setiap tingkat izin dengan alat yang terhubung ke MCP.

Pengguna dengan izin Akses Penuh dan Dapat Mengedit ke Agen Kustom dapat:

• Menambahkan koneksi MCP baru ke Agen Kustom.

• Mengobrol dengan agen dan menggunakan semua alat yang terhubung, meskipun mereka tidak memiliki akses ke alat tersebut di luar agen.

• Melihat log Aktivitas agen dan penggunaan alat MCP.

• Menghapus koneksi MCP yang ada.

• Sambungkan kembali atau perbarui kredensial MCP Server.

Dan untuk koneksi MCP yang mereka siapkan, pengguna dengan izin Akses Penuh dan Dapat Mengedit dapat:

• Mengonfigurasi alat mana yang diaktifkan atau Nonaktifkan dan mengubah pengaturan eksekusi alat (proses otomatis vs. selalu tanya)

Catatan: Setelah koneksi MCP dibuat, hanya orang yang mengautentikasi koneksi MCP tersebut yang dapat mengonfigurasi dan memperbarui pengaturan alat - meskipun orang lain memiliki izin Akses Penuh atau Dapat Mengedit ke Agent Kustom. Agent menggunakan kredensial dan izin orang tersebut saat mengakses layanan eksternal.

Pengguna dengan izin Dapat melihat dan berinteraksi ke Agent Kustom dapat:

• Mengobrol dengan Agent Kustom dan menggunakan semua alat yang terhubung, meskipun mereka tidak memiliki akses ke alat tersebut di luar Agent Kustom.

• Memicu tindakan baca dan tulis melalui agen.

• Menyetujui atau membatalkan tindakan tulis saat konfirmasi diperlukan.

• Melihat server MCP mana yang terhubung (di pengaturan Agent Kustom).

Pengguna dengan izin Dapat melihat dan berinteraksi tidak dapat:

• Menambah atau menghapus koneksi MCP.

• Mengubah alat mana yang diaktifkan.

• Mengubah pengaturan eksekusi alat.

• Melihat log aktivitas lengkap agen.

Catatan: Tindakan tulis (seperti membuat atau memperbarui item) memerlukan konfirmasi secara default untuk mencegah perubahan yang tidak disengaja. Pengguna akan melihat notifikasi yang menunjukkan dengan tepat tindakan apa yang akan dilakukan agen sebelum dijalankan.

Jika alat tidak muncul setelah tersambung:

• Segarkan halaman pengaturan agen.

• Periksa apakah server MCP berhasil diautentikasi (cari tanda centang hijau atau status “Terhubung”).

• Verifikasi bahwa server sedang online dan mengembalikan metadata alat.

• Coba sambungkan kembali server, atau putuskan sambungan dan tambahkan kembali.

Jika Agent Kustom gagal dengan kesalahan MCP:

• Periksa tab Aktivitas untuk pesan kesalahan tertentu.

• Verifikasi bahwa koneksi Anda masih valid (token mungkin telah kedaluwarsa).

• Pastikan koneksi masih diaktifkan di pengaturan agen.

• Coba sambungkan kembali server MCP untuk menyegarkan kredensial.

• Perbarui instruksi Agent Kustom Anda untuk menyebutkan nama server atau alat yang ingin Anda gunakan. Misalnya: “Gunakan Linear MCP untuk mengambil metadata untuk mock ini.”