Server MCP yang bagus memberi agen akses yang sama dengan pengguna. Server ini melibatkan manusia hanya jika kesalahan bisa berdampak mahal, dan membiarkan agen menangani sisanya secara mandiri. Berikut yang dibutuhkan.
Tool yang bisa dipilih agen dengan benar
Agen perlu memilih operasi dari permintaan Anda dan menyediakan argumen yang tepat. Periksa apakah deskripsi tool menjelaskan fungsi setiap operasi dan argumen yang diterima.
Coba cari dengan tugas seperti menyiapkan sending domain. Hasilnya harus mencakup tool yang cocok beserta skema inputnya.
Bird menghasilkan tool-nya dari katalog operasi API. Deskripsi agen menjelaskan cara menggunakannya. Endpoint MCP dinamis menyediakan search dan execute. Pencarian mengembalikan tool yang cocok, skemanya, anotasi efek, dan prosedur yang relevan. Agen dapat memeriksa tool sebelum memanggilnya.
Manusia dalam loop jika kesalahan bisa berdampak mahal
Agen memerlukan manusia dalam loop jika kesalahan bisa berdampak mahal. Periksa bahwa layar tinjauan menampilkan apa yang akan terjadi. Periksa apakah agen bisa melanjutkan dari hasil yang tercatat.
Detail yang kurang memerlukan pertanyaan terpisah. MCP menyebut ini elisitasi: server meminta klien untuk mendapatkan informasi dari manusia. Elisitasi URL membuka interaksi eksternal, seperti layar tinjauan di browser.
Bird menggunakan konfirmasi browser untuk operasi yang ditandai, termasuk pemesanan nomor, pemesanan eSIM, operasi registrasi 10DLC, dan panggilan suara keluar. Agen menyiapkan permintaan dan mengembalikan tautan tinjauan. Anda meninjau dan menjalankan permintaan di browser. Menerima elisitasi membuka tinjauan. Hasil operasi yang tercatat memungkinkan agen melanjutkan. Panduan penyiapan MCP menjelaskan cara menghubungkan klien Anda.
Kesalahan yang bisa diperbaiki sendiri oleh agen
Agen perlu mengetahui apa yang gagal, apa yang harus diubah, dan apa yang harus dipanggil selanjutnya. Periksa sebuah field yang ditolak: kesalahan harus mengidentifikasi masalahnya dan tindakan yang menyelesaikannya.
Untuk kegagalan sementara, respons harus menyatakan apakah perlu dicoba lagi dan berapa lama harus menunggu. Setelah respons hilang pada tindakan yang berdampak, agen perlu memastikan apa yang terjadi sebelum mencoba lagi.
Respons kesalahan MCP Bird mencakup kode stabil, detail field, dan koreksi jika tersedia. Field next menjelaskan tindakan selanjutnya. retryable dan retry_after memberi tahu agen apakah dan kapan harus mengulangi panggilan. Identifier konfirmasi memungkinkan agen mengambil status dan hasil yang tersimpan. Panduan kesalahan API menjelaskan field-field kesalahan.
Aman untuk bertindak
Agen perlu membedakan operasi baca, tulis, dan destruktif. Periksa petunjuk efek tool dan aturannya untuk mengulangi permintaan.
Kunci idempotensi mengidentifikasi tindakan yang dimaksud sehingga operasi yang didukung dapat mengembalikan respons tersimpan pada permintaan ulang. Periksa jendela pemutaran ulang dan apa yang harus dilakukan agen setelah jendela tersebut kedaluwarsa.
Tool Bird memiliki petunjuk read-only, destructive, dan idempotent. Pada operasi dengan pemutaran ulang respons yang di-cache, jendela default adalah tiga jam. Gunakan kembali kunci dan permintaan yang sama dalam jendela tersebut. Setelah kedaluwarsa, percobaan ulang dapat menjalankan tindakan itu lagi. Periksa status operasi sebelum percobaan berikutnya. Panduan idempotensi menjelaskan aturan per operasi.
Mengenal produk
Agen membutuhkan instruksi produk saat bekerja. Ajukan pertanyaan tentang pengaturan dan periksa apakah agen dapat menemukan dokumentasi yang relevan serta membaca halaman lengkapnya.
Server juga harus mengekspos prosedur yang dapat digunakan ulang. Skill memberi agen instruksi tugas dan file pendukung yang dapat dimuat saat dibutuhkan.
Bird menyediakan docs_search untuk bagian dokumentasi yang diurutkan berdasarkan relevansi dan docs_read untuk halaman lengkap. Instruksi servernya mencakup prosedur yang ditulis khusus. Skills melalui MCP mengekspos skill bird-cli dan email-audit dengan file yang dapat dibaca serta ringkasan file. Panduan skill agen menjelaskan tugas yang dicakupnya.
Menjaga agen tetap terinformasi
Agen perlu membedakan penerimaan dari penyelesaian. Periksa apakah hasil mencakup identifier dan field terstruktur yang dapat dibaca kembali nanti.
Untuk pekerjaan yang selesai belakangan, klien harus dapat menerima perubahan yang relevan. Notifikasi pengiriman, misalnya, memungkinkan agen melanjutkan setelah respons pengiriman awal.
Bird mengembalikan hasil konfirmasi yang tercatat sebagai JSON terstruktur. Pembacaan email mencakup status pesan, status penerima, dan event. MCP Events yang di-host memungkinkan agen mendaftar event dan berlangganan notifikasi bertanda tangan.
Menampilkan hasil
Manusia perlu memeriksa hasil secara detail dan menindaklanjutinya. Periksa apakah klien Anda merender MCP Apps, ekstensi untuk antarmuka interaktif di dalam percakapan.
Antarmuka yang berguna memungkinkan Anda memeriksa record yang mendasarinya atau memperbarui statusnya. ChatGPT, Claude web dan Desktop, serta VS Code GitHub Copilot mendukung rendering MCP Apps.
Endpoint MCP standar Bird mencakup widget verifikasi DNS dan pengiriman email. Anda dapat memeriksa record DNS dan memeriksa ulang domain pengirim. Tampilan email menunjukkan status pengiriman, penerima, dan linimasa event. Panduan penyiapan klien MCP menjelaskan cara menghubungkan klien Anda.
Terhubung dalam satu klik
Manusia memerlukan cara yang jelas untuk menghubungkan agen. Periksa apakah klien dapat menemukan server dan membuka proses masuk.
Server yang di-host Bird terhubung melalui OAuth browser. Instruksi koneksi klien mencakup penyiapan dan proses masuk.
Bird terdaftar di registry MCP resmi dan direktori konektor Claude. Instruksi direktori Bird menjelaskan cara terhubung dari Claude.
Cara memeriksa server MCP
Jalankan satu tugas nyata dari awal hingga selesai, lalu tanyakan:
- Apakah agen mendapat akses yang sama dengan pengguna, tanpa pengaturan tambahan?
- Apakah agen memilih tool dan argumen yang tepat dari permintaan biasa?
- Sebelum tindakan yang mahal terjadi, apakah manusia diminta menyetujuinya?
- Ketika panggilan gagal, apakah error-nya menjelaskan apa yang harus diperbaiki, apa yang harus dipanggil berikutnya, dan apakah perlu dicoba lagi?
- Bisakah agen mencoba lagi tanpa melakukan hal yang sama dua kali?
- Bisakah agen mencari dokumentasi dan panduan produk secara mandiri?
- Bisakah agen memeriksa apa yang terjadi setelahnya, dan menerima informasi tentang perubahan?
- Bisakah Anda melihat hasilnya di klien Anda, bukan hanya membacanya?