Agent host mungkin membutuhkan koneksi yang dapat dikonfigurasi. Developer aplikasi mungkin membutuhkan library untuk diimpor ke dalam kode. Kebutuhan tersebut menghasilkan permukaan integrasi yang berbeda.
Apa yang disediakan masing-masing untuk pemanggilnya?
Server MCP menyediakan antarmuka protokol; SDK menyediakan fungsi dan tipe untuk bahasa pemrograman.
Panduan arsitektur MCP menjelaskan server yang mengekspos kapabilitas ke klien yang terhubung. Server dapat berjalan sebagai proses lokal atau menyediakan endpoint jarak jauh.
| Antarmuka | Pemanggil | Yang digunakan pemanggil | Tanggung jawab runtime |
|---|---|---|---|
| Server MCP | Klien MCP di agent host atau aplikasi | Permintaan protokol dan kapabilitas yang ditemukan | Seseorang menjalankan proses server atau layanan jarak jauh |
| API SDK | Kode aplikasi | Metode library yang memanggil API | Aplikasi menjalankan library dan mengelola integrasinya |
| MCP SDK | Kode yang mengimplementasi klien atau server MCP | Tipe protokol dan helper implementasi | Aplikasi tetap menjalankan klien atau server yang dihasilkan |
Paket SDK tidak otomatis menjadi server yang berjalan hanya karena Anda menginstalnya.
Bisakah server menggunakan SDK?
Ya. Developer dapat menggunakan SDK protokol untuk mengimplementasi server MCP, lalu menggunakan library klien lain di dalam handler-nya.
Dokumentasi MCP SDK menjelaskan library untuk membangun klien dan server. Di sini, SDK mengidentifikasi kode yang digunakan untuk mengimplementasi protokol.
API SDK memiliki target berbeda: ia memanggil API sebuah layanan. Server order hipotetis dapat mengekspos tool order-status yang handler-nya menggunakan API SDK untuk mengambil order tersebut.
Antarmuka MCP di luar dan panggilan API di dalam memiliki kontrak terpisah. Mendukung operasi API tidak secara otomatis mengeksposnya sebagai tool MCP.
Tanggung jawab apa yang tetap ada di aplikasi saya?
Aplikasi Anda tetap memutuskan operasi mana yang akan diminta. Aplikasi juga memutuskan cara menangani hasilnya.
Dengan API SDK, kode Anda memilih metode dan menyediakan argumennya. Dengan MCP, host merutekan permintaan melalui klien ke kapabilitas yang diekspos server.
Arsitektur MCP menempatkan penggunaan konteks model oleh host di luar cakupan protokol. Koneksi tool tidak menentukan aturan bisnis, kebijakan otorisasi, atau kriteria penyelesaian Anda.
Untuk pencarian order, menerima status yang diminta mungkin menyelesaikan tugas. Untuk pengiriman pesan, pengajuan dan pengiriman selanjutnya adalah hasil yang terpisah.
Bagaimana cara memilih integrasi Bird?
Anda dapat menghubungkan agent host yang kompatibel ke server MCP Bird, atau mengintegrasikan kode aplikasi melalui klien API.
Untuk jalur library, keputusan Bird SDK membahas pilihan antara SDK dan HTTP langsung. Untuk jalur tool, inventaris Bird klien Anda menyediakan nama tool dan skema input yang tersedia.
Bandingkan operasi yang Anda butuhkan pada antarmuka yang akan Anda gunakan. Keberadaan operasi di satu antarmuka tidak menjamin keberadaannya di antarmuka lain.
- Gunakan koneksi MCP ketika host Anda perlu menemukan dan menjalankan tool Bird.
- Gunakan klien API ketika kode aplikasi Anda memilih dan menjalankan operasi layanan.
- Gunakan MCP SDK ketika Anda mengimplementasi klien atau server protokol itu sendiri.