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:
Repositori MCPB - Panduan memulai lengkap, penggunaan CLI, dan spesifikasi
Contoh MCPB - Implementasi referensi yang berfungsi termasuk "Hello World"
SDK MCP - Implementasi protokol inti
Untuk panduan komprehensif tentang pengembangan, pengujian, dan praktik terbaik, lihat bagian "Untuk Pengembang Bundle" README MCPB.
Penting: Sebelum mendistribusikan MCPB Anda, tinjau panduan pengujian dan praktik terbaik di README MCPB untuk memastikan kualitas.
3. Konfigurasi
Apa itu manifest.json?
File manifest.json adalah metadata yang diperlukan yang mendeskripsikan MCPB Anda - apa yang dilakukannya, cara menjalankannya, alat apa yang disediakannya, dan konfigurasi apa yang diperlukannya.
Untuk informasi paling terkini, lihat Spesifikasi MCPB resmi.
Spesifikasi Manifest MCPB - Skema lengkap dengan semua bidang
Manifest Contoh - Implementasi dunia nyata
Dokumentasi CLI - Referensi perintah
Bagaimana cara menambahkan ikon?
Ikon bersifat opsional tetapi direkomendasikan untuk tampilan profesional.
Pendekatan dasar: Sertakan file icon.png di direktori root bundle Anda dan referensikan di manifest.json.
Persyaratan:
Nama file: icon.png (atau jalur khusus)
Ukuran: 512×512px direkomendasikan (minimum 256×256px)
Format: PNG dengan dukungan transparansi
Lokasi: Root bundle atau jalur yang ditentukan
Opsi lanjutan: Varian ikon berganda untuk ukuran berbeda dan tema (dukungan mode terang/gelap).
Detail implementasi: Lihat Spesifikasi Manifest MCPB - Ikon untuk:
Konfigurasi bidang ikon
Sintaks varian ikon berganda
Spesifikasi ukuran dan tema
Praktik terbaik dan persyaratan
Bagaimana pengguna mengonfigurasi MCPB saya?
Tentukan bagian user_config di manifest.json. Claude Desktop secara otomatis membuat UI pengaturan di mana pengguna dapat mengonfigurasi ekstensi Anda.
Lihat Spesifikasi Manifest MCPB - Konfigurasi Pengguna untuk implementasi lengkap:
Skema lengkap dan contoh
Semua jenis dan properti konfigurasi
Batasan validasi
Penanganan data sensitif
Pola multi-pilih
Bagaimana pengguna menginstal MCPB saya?
Ada tiga metode instalasi yang berbeda:
Klik ganda - Unduh file .mcpb dan klik dua kali untuk membuka
Seret dan lepas - Seret file .mcpb ke jendela Claude Desktop
Menu File - Developer → Extensions → Install Extension → pilih file .mcpb
Semua metode membuka UI instalasi di mana pengguna dapat:
Meninjau detail ekstensi dan izin
Mengonfigurasi pengaturan yang diperlukan
Memberikan izin yang diperlukan
Menyelesaikan instalasi
Cakupan instalasi: Instalasi per pengguna - setiap pengguna harus menginstal secara terpisah di sistem mereka sendiri.
Pengalaman pengguna dan kontrol admin: Untuk informasi terperinci tentang pengalaman instalasi pengguna akhir dan kontrol admin perusahaan (termasuk manajemen organisasi Tim/Perusahaan dan konfigurasi kebijakan), lihat:
Memulai dengan Server MCP Lokal di Claude Desktop - Panduan pengguna lengkap yang mencakup penjelajahan direktori, UI instalasi, pemecahan masalah, dan kontrol admin.
4. Sumber Daya
Dokumentasi Resmi
Kerangka MCPB:
Repositori MCPB - Spesifikasi lengkap dan alat
Spesifikasi Manifest MCPB - Skema manifest lengkap
Dokumentasi CLI MCPB - Referensi alat baris perintah
Contoh MCPB - Implementasi referensi
Protokol MCP:
Spesifikasi MCP - Dokumentasi protokol
Panduan Cepat MCP - Panduan memulai
SDK TypeScript - Implementasi Node.js
SDK Python - Implementasi Python
Claude Desktop:
Catatan Rilis - Pembaruan versi
Blog Ekstensi Desktop - Gambaran umum arsitektur
Mendapatkan Bantuan
Saluran dukungan:
Masalah GitHub MCPB - Laporan bug dan permintaan fitur
Spesifikasi MCP - Pertanyaan protokol
Dukungan Claude - Dukungan Claude Desktop umum
Sumber daya komunitas:
Periksa diskusi repositori untuk Q&A komunitas
Ikuti catatan rilis untuk pembaruan terbaru
Tinjau contoh untuk pola implementasi
Siap untuk Distribusi Publik?
Jika Anda telah membangun MCPB yang berfungsi dan ingin mengirimkannya ke Direktori Anthropic untuk distribusi dan penemuan yang lebih luas, lihat panduan pendamping kami: Pengajuan ke Direktori Anthropic.
Panduan direktori mencakup persyaratan tambahan termasuk:
Anotasi alat wajib untuk semua alat
Persyaratan kebijakan privasi
Minimum tiga contoh yang berfungsi
Kredensial pengujian (jika berlaku)
Proses pengajuan lengkap dan garis waktu tinjauan