Apa itu server MCP, dan bagaimana agen menggunakannya untuk mengirim pesan?

Asisten yang menyusun notifikasi pengiriman memerlukan akses ke pengirim, penerima, dan konten pesan. Tool yang terhubung memungkinkannya mengirimkan field-field tersebut tanpa memasukkan kredensial Anda ke dalam percakapan.

MCP adalah protokol yang menghubungkan aplikasi ke tool-tool tersebut.

Apa yang disediakan server MCP?

Server memberikan klien AI Anda nama tool, skema input, dan operasi yang dapat dipanggil.

Dalam model tool MCP, klien menemukan tool yang tersedia. Klien mengirimkan argumen terstruktur saat agen memilih salah satunya.

Tool Bird mencakup pengiriman email, pesan SMS, dan WhatsApp. Tool setup mengelola domain pengiriman, nomor, dan persyaratan pengirim. Tool verifikasi memulai verifikasi dan juga memeriksa kode. Tool terpisah melanjutkan ke channel lain.

Daftar tool yang tersedia di klien Anda mengidentifikasi setiap operasi dan input yang diperlukan. Periksa daftar tersebut jika operasi yang diharapkan tidak ada.

Bagaimana cara menghubungkan ke server hosted?

Tambahkan https://mcp.bird.com sebagai server MCP jarak jauh. Masuk melalui browser.

Anda tidak perlu menginstal CLI atau menyediakan kunci API. Proses masuk melalui browser memungkinkan klien menyimpan token dengan sebagian izin Anda. Bird memeriksa setiap permintaan terhadap izin dalam token tersebut.

Beberapa klien menampilkan server sebagai memerlukan autentikasi hingga Anda memulai proses masuk. Klien yang hanya memiliki URL dapat menampilkan daftar tool. Tanpa autentikasi, pemanggilan tool dapat mengembalikan 401.

Selesaikan autentikasi sebelum menguji pemanggilan tool. Panduan koneksi menyediakan langkah-langkah setup untuk klien yang didukung.

Bagaimana agen mengirim dan memeriksa pesan?

Pastikan penerima telah menyetujui pesan dan kontennya memenuhi kebijakan yang berlaku. Panggil tool kirim channel tersebut. Baca event pengiriman dari pesan yang dihasilkan.

Untuk email, urutannya adalah:

1. Konfirmasi workspace, identitas pengirim, penerima, dan konten.
2. Panggil email_send dengan field yang diperlukan dari skema input-nya.
3. Simpan ID pesan yang dikembalikan.
4. Gunakan email_get untuk memeriksa status pengiriman, hasil penerima, dan linimasa event.

Pengiriman yang diterima tidak membuktikan pesan sudah sampai. Bounce atau penolakan berikutnya perlu ditangani oleh agen atau aplikasi Anda.

Pengirim atau izin yang tidak tersedia dapat mencegah pengiriman. Tool setup dan diagnostik memungkinkan agen memeriksa persyaratan tersebut sebelum mencoba lagi.

Bisakah saya menjalankan server secara lokal?

Ya. Instal Bird CLI. Masuk dengan bird auth login. Konfigurasikan klien Anda untuk menjalankan bird mcp.

Klien memulai proses tersebut. Komunikasi dilakukan melalui stream input dan output proses. Klien memerlukan bird sebagai perintah dan mcp sebagai argumen.

Server lokal dan hosted menyediakan toolset yang sama. Menjalankan proses secara lokal tetap memerlukan akses jaringan untuk operasi Bird API.

Gunakan proses lokal jika Anda ingin mengelolanya sendiri. Klien Anda harus dapat menjalankan perintah. Gunakan URL hosted jika klien tidak dapat menjalankan binary lokal.

Apa yang mengontrol tindakan yang dapat dilakukan agen?

Kredensial yang terhubung membatasi akses. Host AI Anda mengontrol kapan eksekusi tool memerlukan konfirmasi.

Bird menganotasi tool destruktif agar host dapat mengenalinya. Misalnya, menghapus supresi email ditandai sebagai destruktif karena dapat melanjutkan pengiriman yang tidak diinginkan.

Anotasi sendiri tidak memaksa munculnya permintaan persetujuan. Konfigurasikan kebijakan host Anda sebelum mengizinkan perubahan pada sumber daya produksi.

Agen yang dapat membuat draf dan mengirimkan template email juga dapat mempublikasikannya. Langkah draf saja tidak mencegah agen memanggil tool pengiriman.

Pengiriman template WhatsApp mengirimkan template ke Meta untuk ditinjau. Ini tidak menyediakan langkah persetujuan manusia untuk setiap tindakan lain yang dapat dilakukan agen.

Tool voice memeriksa panggilan dan juga menerbitkan kredensial klien. Tidak ada tool MCP yang melakukan panggilan suara. CLI menyediakan operasi panggilan uji.

Untuk agen yang mendukung shell, CLI menyediakan output JSON dan kode keluar. Pilih antarmuka yang dapat dijalankan host Anda. Atur kebijakan konfirmasinya untuk tindakan yang dimaksud.