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 Pengaturan > Ekstensi di Claude Desktop.
Klik "Jelajahi ekstensi" untuk melihat direktori kami dan klik pada alat apa pun yang telah ditinjau Anthropic yang ingin Anda gunakan. Klik "Pasang" pada ekstensi yang Anda inginkan.
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 Pengaturan > Ekstensi di Claude Desktop.
Klik "Pengaturan lanjutan" dan temukan bagian Pengembang Ekstensi.
Klik "Pasang Ekstensi…"
Pilih file .mcpb dan ikuti petunjuk untuk memasang.
Kontrol Admin untuk Ekstensi Desktop
Pemilik dan Pemilik Utama paket Tim dan Enterprise dapat mengelola akses tim ke ekstensi desktop menggunakan dua kontrol:
Aktifkan atau nonaktifkan ekstensi desktop publik sesuai dengan 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 lain.
Mengaktifkan/menonaktifkan ekstensi tertentu pada paket Tim dan Enterprise
Pemilik dan Pemilik Utama organisasi Tim 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 petunjuk spesifik.
Buat dan unggah ekstensi khusus untuk organisasi Anda
Unggahan ekstensi desktop khusus memungkinkan paket Tim 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 Pengaturan > Ekstensi dalam Claude Desktop dan klik "Pengaturan lanjutan" untuk mengakses bagian Pengembang Ekstensi:
Klik "Pasang Ekstensi…" 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 di tingkat mesin pengguna 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 dipasang 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 Pengaturan > Ekstensi 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 Preferensi Sistem > Keamanan & Privasi jika Anda menerima peringatan keamanan.
Di Windows dan Linux, 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, lalu pilih "Konektor." Ini akan menunjukkan server MCP yang terhubung dan alatnya. Alternatifnya, Anda dapat mengunjungi pengaturan Pengembang (di bawah Aplikasi desktop) untuk melihat status koneksi dan melihat log untuk server MCP apa pun.
Bagaimana cara 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 petunjuk terperinci.
Bahasa pemrograman apa yang didukung untuk ekstensi desktop?
Ekstensi desktop mendukung server MCP Node.js, Python, dan biner. Claude Desktop menyertakan lingkungan Node.js bawaan, jadi instalasi Node.js tidak diperlukan.
Bagaimana cara 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, dan pengelola keychain distro Anda di Linux).
Bisakah saya mendistribusikan ekstensi desktop khusus saya secara pribadi?
Ya, Anda dapat berbagi file .mcpb secara langsung dengan pengguna atau tim tertentu. Untuk distribusi yang lebih luas, Anda dapat mengirimkan ekstensi ke direktori resmi.
Bagaimana cara men-debug masalah dengan ekstensi desktop saya?
Aktifkan pencatatan debug dalam pengaturan Claude Desktop, periksa log ekstensi di panel pengaturan Ekstensi, 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.
Github Model Context Protocol - Berisi dokumentasi teknis lengkap, contoh kode, dan panduan implementasi.
Panduan debugging 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.