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. Pengenalan
Apa itu MCPB?
File MCPB (.mcpb) adalah arsip zip yang berisi server MCP lokal dan manifest.json. Mereka memungkinkan instalasi sekali klik di Claude Desktop, mirip dengan ekstensi browser.
Karakteristik utama:
Berjalan secara lokal di mesin pengguna
Berkomunikasi melalui transportasi stdio
Menggabungkan semua dependensi
Bekerja offline
Tidak memerlukan OAuth
Pelajari lebih lanjut:
Repositori MCPB - Spesifikasi lengkap dan arsitektur
Posting Blog Ekstensi Desktop - Gambaran umum dan kasus penggunaan
Kapan saya harus menggunakan server lokal (MCPB) versus server jarak jauh?
Pilih server lokal (MCPB) untuk:
Sistem Internal dan Keamanan
Akses sistem di balik firewall Anda (JIRA, Confluence, wiki internal, database pribadi)
Autentikasi mulus - Menggunakan sesi SSO dan browser yang ada 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 sistem file langsung untuk pengeditan kode dan operasi Git
Integrasi dengan alat yang diinstal secara lokal (Docker, IDE, database)
Integrasi perangkat keras dan kontrol aplikasi desktop
Operasi sensitif privasi yang tidak boleh meninggalkan mesin pengguna
Penyebaran Perusahaan
Instalasi sekali klik dengan runtime Node.js bawaan (tidak ada dependensi untuk dikelola)
Tidak ada infrastruktur cloud, konfigurasi VPN, atau aturan firewall yang diperlukan
Kontrol tingkat organisasi - Admin dapat mengunggah ekstensi khusus dan mengelola akses melalui daftar izin
Kontrol lengkap 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 di sisi server
Integrasi yang menghadap publik digunakan oleh beberapa organisasi
Perbedaan utama: MCPB berjalan di mesin pengguna melalui transportasi stdio dengan akses ke sumber daya lokal dan internal. Konektor jarak jauh berjalan di server Anda melalui HTTPS dan diakses melalui infrastruktur Anthropic.
Penggunaan 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 Mitra MCP untuk dokumentasi konektor jarak jauh lengkap.
2. Memulai
Bahasa pemrograman apa yang harus saya gunakan?
Node.js sangat direkomendasikan karena:
Dikirim dengan Claude untuk macOS dan Windows (nol gesekan instalasi untuk pengguna)
Pengguna tidak perlu instalasi runtime terpisah
Kompatibilitas dan keandalan terbaik dengan Claude Desktop
Dukungan SDK MCP yang luas
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 bahkan jika 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 SDK MCP)
3. Jalankan mcpb init untuk membuat manifest.json
4. Jalankan mcpb pack untuk menggabungkan
5. Instal dan uji di Claude Desktop
Untuk panduan implementasi terperinci: