Panduan ini akan membantu Anda membangun MCP Bundle (.mcpb) untuk membuat ekstensi desktop untuk penggunaan internal, distribusi pribadi, atau sebagai fondasi untuk pengajuan ke Direktori Konektor Anthropic.
1. Pengantar
Apa itu MCPB?
File MCPB (.mcpb) adalah arsip zip yang berisi server MCP lokal dan manifest.json. File ini memungkinkan instalasi sekali klik di Claude Desktop, mirip dengan ekstensi browser.
Karakteristik utama:
Berjalan secara lokal di mesin pengguna
Berkomunikasi melalui transport stdio
Menggabungkan semua dependensi
Bekerja secara offline
Tidak memerlukan OAuth
Pelajari lebih lanjut:
Repositori MCPB - Spesifikasi dan arsitektur lengkap
Postingan Blog Desktop Extensions - Gambaran umum dan kasus penggunaan
Kapan saya harus menggunakan server lokal (MCPB) vs server jarak jauh?
Pilih server lokal (MCPB) untuk:
Sistem Internal dan Keamanan
Mengakses sistem di balik firewall Anda (JIRA, Confluence, wiki internal, database pribadi)
Autentikasi yang mulus - Menggunakan SSO yang ada dan sesi browser secara otomatis, tanpa manajemen token
Kepatuhan zero-trust - Beroperasi dalam batas jaringan perusahaan Anda tanpa mengekspos sumber daya internal secara publik
Sumber Daya Lokal
Akses filesystem langsung untuk pengeditan kode dan operasi Git
Integrasi dengan alat yang terinstal secara lokal (Docker, IDE, database)
Integrasi perangkat keras dan kontrol aplikasi desktop
Operasi sensitif privasi yang tidak boleh meninggalkan mesin pengguna
Deployment Enterprise
Instalasi sekali klik dengan runtime Node.js bawaan (tidak ada dependensi yang perlu dikelola)
Tidak memerlukan infrastruktur cloud, konfigurasi VPN, atau aturan firewall
Kontrol tingkat organisasi - Admin dapat mengunggah ekstensi kustom dan mengelola akses melalui allowlist
Kontrol penuh atas autentikasi, otorisasi, dan log audit
Pilih konektor jarak jauh untuk:
Layanan cloud dan API publik yang memerlukan infrastruktur terpusat
Distribusi di seluruh claude di web, mobile, dan desktop
Layanan yang memerlukan pembaruan terpusat di semua pengguna
Alur OAuth yang memerlukan manajemen token sisi server
Integrasi yang menghadap publik yang digunakan oleh beberapa organisasi
Perbedaan utama: MCPB berjalan di mesin pengguna melalui transport stdio dengan akses ke sumber daya lokal dan internal. Konektor jarak jauh berjalan di server Anda melalui HTTPS dan diakses melalui infrastruktur Anthropic.
Penggunaan di dunia nyata: Organisasi membangun MCPB sebagai proxy aman ke server MCP internal, untuk akses dokumentasi internal, dan untuk menghubungkan alat pengembangan sambil mempertahankan arsitektur keamanan mereka.
Untuk panduan konektor jarak jauh: Lihat FAQ Partner MCP untuk dokumentasi konektor jarak jauh lengkap.
2. Memulai
Bahasa pemrograman mana yang harus saya gunakan?
Node.js sangat direkomendasikan karena:
Dikirim bersama Claude untuk macOS dan Windows (tanpa hambatan instalasi untuk pengguna)
Pengguna tidak perlu instalasi runtime terpisah
Kompatibilitas dan keandalan terbaik dengan Claude Desktop
Dukungan MCP SDK yang ekstensif
Platform apa yang harus saya dukung?
Claude Desktop berjalan di:
macOS (darwin)
Windows (win32)
Tentukan platform yang didukung di bagian kompatibilitas manifest.json Anda.
Praktik terbaik: Uji di kedua platform meskipun Anda terutama mengembangkan di satu platform.
Detail kompatibilitas platform: Lihat Spesifikasi Manifest MCPB - Kompatibilitas untuk spesifikasi platform dan persyaratan runtime.
Bagaimana cara membuat MCPB pertama saya?
Ikuti proses lima langkah ini:
1. Instal MCPB CLI: npm install -g @anthropic-ai/mcpb
2. Buat server MCP Anda (lihat MCP SDK)
3. Jalankan mcpb init untuk membuat manifest.json
4. Jalankan mcpb pack untuk membundle
5. Instal dan uji di Claude Desktop
Untuk panduan implementasi terperinci:
Repositori MCPB - Panduan memulai lengkap, penggunaan CLI, dan spesifikasi