MCP Python SDK 2.3.0 perlu diuji sebelum masuk produksi, terutama jika server Anda memakai x-mcp-header, koneksi protokol lama, OAuth interaktif, atau hasil tool berukuran besar. Rilis 2 Oktober 2026 ini memperbaiki kegagalan yang sebelumnya muncul terlambat, tetapi juga membuat konfigurasi yang tidak valid gagal saat registrasi.
MCPMCPAturan standar yang memungkinkan program AI memakai alat dan data Anda dengan izin yang jelas.Buka glosarium Python SDK adalah pustaka Python resmi untuk membangun klien dan server Model Context Protocol (MCP). MCP sendiri menstandarkan cara aplikasi AI menemukan dan memanggil tool, resource, serta prompt dari sistem lain.
Sumber utama artikel ini adalah catatan rilis resmi MCP Python SDK v2.3.0, diterbitkan 2 Oktober 2026. Untuk konteks operasi agentAgent AIProgram AI yang mengerjakan langkah pekerjaan sendiri, misalnya membaca pesan, menyiapkan balasan, lalu mencatat hasilnya.Buka glosarium, lihat juga panduan Rama Digital tentang upgrade Hermes Agent secara aman dan kasus regresi OpenClaw yang membutuhkan rollback.
Apa yang berubah pada MCP Python SDK 2.3.0?
Perubahan paling material adalah validasi x-mcp-header saat tool didaftarkan. Sebelum versi 2.3.0, server dapat tetap hidup walau anotasinya tidak valid, lalu klien spesifikasi 2026-07-28 diam-diam menghapus tool itu dari daftar. Sejak 2.3.0, registrasi langsung melempar InvalidSignature dan menyebut nama tool serta masalahnya.
| Area | Sebelum 2.3.0 | Pada 2.3.0 | Dampak operasi |
|---|---|---|---|
| Header tool | Anotasi tidak valid dapat lolos saat startup | Registrasi gagal dengan InvalidSignature | Deploy dapat berhenti lebih awal, tetapi error lebih mudah dilacak |
| Payload legacy | _meta: {} dan params kosong dapat terkirim | Field kosong tidak lagi dikirim | Server lama yang menolak field kosong menjadi kompatibel |
| OAuth interaktif | Waktu login dihitung dalam request timeout | Timeout berhenti selama handler login menunggu | Login di atas 10 detik tidak memaksa fallback protokol |
| SSE | Batas tidak dapat dikonfigurasi dari opsi baru | Default 1 MiB per event, dapat diubah | Hasil tool besar bisa ditolak bila melewati batas |
Apa yang bisa rusak setelah upgrade?
Tool dengan parameter header selain str, int, atau bool biasa akan ditolak. Catatan rilis resmi menyebut str | None, float, list, enum, nama header yang bukan token valid, dan dua nama yang hanya berbeda kapitalisasi sebagai kasus yang ditolak. Header opsional harus memakai schemaSchemaKeterangan tambahan dalam kode halaman yang memberi tahu mesin pencari jenis isi halaman, misalnya artikel, layanan, atau tanya jawab.Buka glosarium eksplisit sesuai contoh dokumentasi resmi.
Dependensi minimum httpx2 juga naik dari 2.5.0 menjadi 2.10.0 karena opsi max_sse_event_size. Instalasi yang mengunci versi di bawah 2.10.0 perlu memperbarui lockfile. Selain itu, kode legacy yang membaca ctx.meta sebagai dictionary harus menerima None; middleware juga dapat melihat ctx.params sebagai None saat request tidak mempunyai parameter.
Rilis ini juga mengubah validasi Mcp-Param-*. Server sekarang mencari schema tool berdasarkan nama dan tidak lagi menjalankan tools/list untuk setiap tools/call. Middleware yang sebelumnya menyaring atau menulis ulang hasil tools/list tidak lagi memengaruhi validasi tersebut.
Apakah perlu upgrade sekarang?
Upgrade layak diprioritaskan jika Anda mengalami tool yang hilang dari daftar, kegagalan server legacy akibat payload kosong, atau OAuth interaktif yang melewati timeout 10 detik. Jika sistem stabil dan memakai banyak anotasi header kustom, lakukan canary lebih dulu karena startup yang sebelumnya lolos dapat berubah menjadi gagal.
- Buat branch upgrade dan naikkan paket
mcpke 2.3.0 tanpa mengubah aplikasi lain. - Perbarui lockfile dan pastikan
httpx2>=2.10.0terpasang. - Jalankan registrasi seluruh tool di CI. Perlakukan setiap
InvalidSignaturesebagai konfigurasi yang harus diperbaiki, bukan error yang dilewati. - Uji klien pada protokol 2026-07-28 dan setidaknya satu koneksi 2025-11-25 bila masih didukung.
- Uji OAuth dengan login lebih dari 10 detik dan tambahkan batas sendiri di callback bila alur tidak boleh menunggu tanpa batas.
- Uji hasil tool mendekati dan melewati 1 MiB. Naikkan
max_sse_event_sizehanya jika payload besar memang dibutuhkan dan batas memori sudah dihitung. - Canary pada sebagian trafik, pantau error registrasi,
HeaderMismatch, timeout, dan ukuran event, lalu siapkan rollback ke lockfile sebelumnya.
Ringkasan keputusan operasional
| Kondisi | Keputusan |
|---|---|
| Tool hilang tanpa error jelas | Upgrade dan perbaiki anotasi saat registrasi |
Server legacy menolak _meta kosong | Upgrade diprioritaskan |
| Banyak header kustom tanpa test startup | Tambah CI lalu canary |
| Hasil tool di atas 1 MiB | Uji batas SSE sebelum produksi |
Kesimpulannya, MCP Python SDK 2.3.0 bukan upgrade yang sebaiknya dipasang buta. Rilis ini memberi kegagalan yang lebih cepat dan perilaku legacy yang lebih bersih, tetapi tim perlu memeriksa schema header, nilai None, dependensi, dan batas SSE sebelum rollout penuh.
Tanya jawab
Apakah MCP Python SDK 2.3.0 merupakan security patch?
Catatan rilis 2 Oktober 2026 menyebutnya sebagai rilis yang mayoritas berisi perbaikan dan tiga opsi baru, bukan advisory keamanan khusus.
Mengapa tool bisa gagal saat startup?
Versi 2.3.0 menolak anotasi x-mcp-header yang tidak valid saat registrasi. Perilaku ini menggantikan kondisi ketika server hidup tetapi klien membuang tool dari daftar.
Berapa batas default event SSE?
Nilai default max_sse_event_size adalah 1 MiB per event menurut catatan rilis resmi 2 Oktober 2026.
Apakah OAuth kini dapat menunggu selamanya?
Request timeout berhenti saat provider menunggu redirect dan callback. Tambahkan batas di callback_handler bila kebijakan operasi Anda membutuhkan batas total login.
Apa tindakan pertama sebelum upgrade?
Jalankan registrasi semua tool dan test koneksi legacy di CI. Dua pemeriksaan ini menangkap perubahan perilaku yang paling mungkin menghentikan deploy.
