Pilih transportasi dengan sengaja
Server stdio lokal dan layanan HTTP jarak jauh memiliki kebutuhan penerapan yang berbeda. Gunakan transport jarak jauh yang didukung, TLS, dan rute yang terautentikasi. Periksa versi klien dan server alih-alih menganggap setiap implementasi mendukung kemampuan yang sama.
Perlakukan setiap alat sebagai API
Validasi argumen, tegakkan otorisasi khusus pengguna dan batasi sumber daya. Jangan mengekspos eksekusi shell arbitrer sebagai alat kenyamanan. Batasi tujuan keluar di mana alat mengambil URL dan jauhkan rahasia dari deskripsi dan respons.
Jaga pengumpulan identitas secara proporsional
Host tanpa-KYC dapat meminimalkan data pendaftaran penyedia, tetapi layanan MCP mungkin tetap memerlukan pengguna, keamanan sesi, dan kontrol penyalahgunaan sendiri. Jelaskan apa yang dicatat dan hindari menyimpan input alat tanpa tujuan yang jelas.
Terapkan untuk kejelasan operasional
Jalankan di bawah pengguna khusus, gunakan pemeriksaan kesehatan, batasi waktu permintaan, dan jaga buffering serta timeout reverse proxy tetap kompatibel dengan protokol. Uji autentikasi, pencabutan, pemutusan, dan percobaan ulang sebelum memberikan hak istimewa tulis.
Selaraskan autentikasi dengan protokol yang didukung
Untuk penerapan MCP berbasis HTTP, tinjau persyaratan otorisasi protokol saat ini dan versi klien yang didukung. Akses sumber daya berbasis OAuth melibatkan audiens token, penemuan, dan cakupan, bukan sekadar kata sandi di halaman utama. Gunakan HTTPS, validasi token untuk sumber daya yang dimaksud, dan jangan simpan kredensial bearer di string kueri. Server stdio menggunakan batas kredensial lokal yang berbeda.
- Uji permintaan tanpa autentikasi
- Uji permintaan terautentikasi di luar cakupannya
- Cabut kredensial dan verifikasi bahwa kredensial itu berhenti berfungsi
Dokumentasi resmi: Spesifikasi otorisasi MCP
Terbitkan rangkaian alat pertama yang terbatas
Mulailah dengan alat hanya-baca yang mengembalikan jumlah data terbatas. Tambahkan penulisan file, operasi siklus hidup server, atau pesan eksternal hanya setelah izin dan perilaku duplikatnya dipahami. Perlakukan halaman web dan dokumen yang dikembalikan sebagai input tidak tepercaya; keduanya tidak boleh secara diam-diam memperluas otoritas server alat.
Tetapkan perilaku protokol sebelum menulis aturan proxy
Catat rilis SDK server dan revisi MCP yang akan digunakan klien. Dalam revisi 2026-07-28 Streamable HTTP, permintaan menggunakan endpoint POST; contoh lama yang mengandalkan sesi protokol atau aliran GET mandiri merupakan revisi yang berbeda. Jangan menghapus persyaratan kompatibilitas yang tampak sampai Anda mengetahui klien mana yang Anda dukung. Reverse proxy harus mempertahankan header yang diperlukan, status HTTP, dan perilaku streaming respons untuk versi tersebut.
- Mulai dengan alat hanya-baca pada listener loopback, lalu tempatkan batas HTTPS/autentikasi yang dimaksud di depannya.
- Uji hasil normal, hasil streaming, timeout, dan klien terputus melalui proxy publik.
- Validasi nilai Origin yang diizinkan sesuai kebutuhan transport; pemeriksaan Origin bukan pengganti autentikasi pemanggil.
- Jika peristiwa hanya tiba di akhir, periksa buffering proxy dan perilaku timeout sebelum mengubah kode alat.
Dokumentasi resmi: MCP 2026-07-28: HTTP yang dapat dialirkan
Uji kegagalan otorisasi seketat menguji keberhasilan
Untuk akses HTTP yang dilindungi OAuth, server MCP adalah sumber daya yang dilindungi. Uji penemuan metadata, issuer yang diharapkan dan audiens token, serta scope yang diperlukan untuk operasi tertentu. Jauhkan token otorisasi dari string kueri URL dan jangan pernah meneruskannya tanpa perubahan ke layanan hilir yang tidak terkait. Kegagalan autentikasi yang dihadapi klien harus mempertahankan tantangan HTTP yang sesuai agar klien dapat pulih melalui alur yang didukungnya.
- Tanpa token atau token kedaluwarsa: endpoint yang dilindungi menolak akses alih-alih mengembalikan data alat privat.
- Token valid dengan izin tidak memadai: sumber daya yang diminta tetap tidak dapat diakses.
- Token untuk audiens lain: tolak meskipun tanda tangannya valid.
- URL eksternal atau jalur file yang tidak terduga: validasi terhadap otoritas alat sebelum mengambil atau menulis.
- Log dan jejak kesalahan: pertahankan pengenal operasi dan hasilnya sambil menghapus token dan input alat privat.
Dokumentasi resmi: MCP 2026-07-28: otorisasi HTTP · MCP: praktik terbaik keamanan