Model Context Protocol (MCP) adalah protokol terbuka yang memungkinkan integrasi mulus antara aplikasi LLM dan sumber data serta alat eksternal. Dengan diperkenalkannya ekstensi desktop, memasang dan mengelola server MCP lokal menjadi jauh lebih mudah.
Ekstensi Desktop
Ekstensi desktop menyediakan cara yang efisien untuk memasang dan mengelola server MCP lokal melalui paket yang dapat dipasang dengan satu klik. Alih-alih mengonfigurasi file JSON secara manual dan mengelola dependensi, Anda sekarang dapat memasang server MCP lokal di komputer Anda semudah memasang ekstensi browser.
Catatan: Kami sedang membangun direktori ekstensi desktop – jika Anda adalah pengembang yang ingin menambahkan ekstensi yang Anda buat ke direktori, lengkapi formulir minat ekstensi desktop kami untuk berbagi informasi lebih lanjut dengan kami.
Memasang ekstensi desktop dari direktori
Navigasikan ke Settings > Extensions di Claude Desktop.
Klik "Browse extensions" untuk melihat direktori kami dan klik pada alat apa pun yang telah ditinjau Anthropic yang ingin Anda gunakan. Klik "Install" pada ekstensi pilihan Anda.
Konfigurasikan pengaturan yang diperlukan (seperti kunci API) melalui antarmuka yang ramah pengguna.
Ekstensi akan secara otomatis tersedia dalam percakapan Anda.
Memasang ekstensi desktop khusus
Navigasikan ke Settings > Extensions di Claude Desktop.
Klik "Advanced settings" dan temukan bagian Extension Developer.
Klik "Install Extension…"
Pilih file .mcpb dan ikuti petunjuk untuk memasang.
Kontrol Admin untuk Ekstensi Desktop
Pemilik dan Pemilik Utama dari paket Team dan Enterprise dapat mengelola akses tim ke ekstensi desktop menggunakan dua kontrol:
Aktifkan atau nonaktifkan ekstensi desktop publik tergantung pada standar keamanan organisasi Anda.
Unggah ekstensi desktop khusus dan buat tersedia untuk tim Anda untuk pemasangan satu klik.
Kontrol ini memungkinkan organisasi untuk sepenuhnya menyesuaikan registri mereka dengan menambahkan hanya ekstensi yang perlu diakses tim, dan menghapus yang lainnya.
Mengaktifkan/menonaktifkan ekstensi tertentu pada paket Team dan Enterprise
Pemilik dan Pemilik Utama organisasi Team dan Enterprise dapat mengelola ekstensi desktop mana yang diaktifkan untuk organisasi Anda dan dapat diakses oleh anggota lain melalui Claude Desktop. Lihat Mengaktifkan dan menggunakan daftar izin ekstensi desktop
untuk instruksi spesifik.
Buat dan unggah ekstensi khusus untuk organisasi Anda
Unggahan ekstensi desktop khusus memungkinkan paket Team dan Enterprise untuk memanfaatkan alur kerja khusus organisasi yang tidak tersedia di direktori publik. Setelah membuat ekstensi desktop khusus, Pemilik dan Pemilik Utama dapat menavigasi ke Settings > Extensions dalam Claude Desktop dan klik "Advanced settings" untuk mengakses bagian Extension Developer:
Klik "Install Extension…" dan pilih file .mcpb. Ikuti petunjuk untuk memasang dan mengonfigurasi ekstensi desktop khusus Anda. Untuk informasi yang lebih mendalam, silakan lihat dokumentasi pengembang ekstensi desktop kami.
Kontrol Kebijakan Enterprise
Catatan: Kontrol kebijakan Enterprise pada tingkat pengguna-mesin akan menggantikan kontrol dalam aplikasi apa pun (daftar blokir dan daftar izin). Jika Anda ingin menggunakan kontrol dalam aplikasi, pastikan isDesktopExtensionEnabled dan isDesktopExtensionDirectoryEnabled tidak diatur ke "false" sehingga daftar izin dapat mengisi registri yang tersedia.
Untuk mengontrol ekstensi desktop melalui kebijakan sistem, silakan lihat dokumentasi konfigurasi enterprise desktop kami.
Pemecahan masalah masalah pemasangan ekstensi desktop
Ekstensi tidak akan dipasang
Pastikan Anda menjalankan versi terbaru Claude Desktop.
Periksa bahwa file ekstensi tidak rusak dengan mengunduhnya kembali.
Verifikasi bahwa Anda memiliki ruang disk yang cukup untuk pemasangan.
Ekstensi muncul terpasang tetapi alat tidak tersedia
Mulai ulang Claude Desktop untuk menyegarkan registri ekstensi.
Periksa pengaturan konfigurasi ekstensi untuk bidang yang diperlukan yang hilang.
Verifikasi bahwa kunci API atau kredensial autentikasi apa pun dimasukkan dengan benar.
Masalah konfigurasi ekstensi
Navigasikan ke Settings > Extensions dan klik pada ekstensi untuk meninjau pengaturannya.
Pastikan semua bidang konfigurasi yang diperlukan telah diselesaikan.
Periksa bahwa jalur file (jika berlaku) menunjuk ke direktori yang ada dan dapat Anda akses.
Kesalahan izin atau keamanan
Di macOS, periksa System Preferences > Security & Privacy jika Anda menerima peringatan keamanan.
Di Windows, pastikan Claude Desktop memiliki izin yang diperlukan untuk mengakses direktori yang diperlukan.
Untuk lingkungan enterprise, verifikasi bahwa ekstensi desktop diaktifkan melalui kebijakan organisasi Anda.
FAQ Pengembang
Bagaimana cara saya memeriksa apakah server MCP saya terhubung dengan benar di Claude Desktop?
Klik tombol "+" di bagian bawah kotak obrolan dalam Claude Desktop, kemudian pilih "Connectors." Ini akan menunjukkan server MCP yang terhubung dan alatnya. Alternatifnya, Anda dapat mengunjungi Developer settings (di bawah Desktop app) untuk melihat status koneksi dan melihat log untuk server MCP apa pun.
Bagaimana cara saya mengonversi server MCP yang ada ke ekstensi desktop?
Tambahkan file manifest.json ke direktori server MCP Anda dengan metadata yang diperlukan.
Paketnya menggunakan perintah
mcpb pack.Lihat dokumentasi MCPB untuk instruksi terperinci.
Bahasa pemrograman apa yang didukung untuk ekstensi desktop?
Ekstensi desktop mendukung server Node.js, Python, dan binary MCP. Claude Desktop menyertakan lingkungan Node.js bawaan, jadi instalasi Node.js tidak diperlukan.
Bagaimana cara saya menangani konfigurasi sensitif seperti kunci API?
Tandai bidang konfigurasi sebagai "sensitive": true dalam manifest.json Anda. Claude Desktop akan secara otomatis mengenkripsi nilai-nilai ini menggunakan penyimpanan aman sistem operasi (Keychain di macOS, Credential Manager di Windows).
Bisakah saya mendistribusikan ekstensi desktop khusus saya secara pribadi?
Ya, Anda dapat berbagi file .mcpb langsung dengan pengguna atau tim tertentu. Untuk distribusi yang lebih luas, Anda dapat mengirimkan ekstensi ke direktori resmi.
Bagaimana cara saya men-debug masalah dengan ekstensi desktop saya?
Aktifkan pencatatan debug dalam pengaturan Claude Desktop, periksa log ekstensi di panel pengaturan Extensions, dan lihat panduan debugging MCP untuk pemecahan masalah khusus protokol.
Apa yang terjadi ketika ekstensi saya memerlukan pembaruan?
Ekstensi dari direktori resmi diperbarui secara otomatis secara default. Untuk ekstensi yang didistribusikan secara pribadi, pengguna perlu memasang file .mcpb yang diperbarui secara manual.
Tertarik untuk mempelajari lebih lanjut tentang MCP?
Untuk informasi yang lebih mendalam tentang membangun klien dan server MCP Anda sendiri, kami merekomendasikan untuk meninjau sumber daya berikut:
Panduan Mulai Cepat MCP - Tutorial langkah demi langkah yang sempurna untuk memulai dengan integrasi MCP dasar.
Model Context Protocol Github - Berisi dokumentasi teknis lengkap, contoh kode, dan panduan implementasi.
Panduan untuk men-debug integrasi MCP - Tips pemecahan masalah dan solusi untuk tantangan implementasi umum.
Jika Anda memerlukan panduan lebih lanjut, kunjungi panduan kami tentang Cara Mendapatkan Dukungan untuk opsi dukungan tambahan.