Lewati ke konten utama

Memulai dengan Server MCP Lokal di Claude Desktop

Diperbarui lebih dari satu minggu yang lalu

MCP di Claude Desktop saat ini merupakan fitur beta.

Model Context Protocol (MCP) adalah protokol terbuka yang memungkinkan integrasi yang mulus antara aplikasi LLM dan sumber data serta alat eksternal. Dengan diperkenalkannya ekstensi desktop (DXT), menginstal dan mengelola server MCP lokal menjadi jauh lebih mudah.

Ekstensi Desktop

Ekstensi desktop menyediakan cara yang efisien untuk menginstal dan mengelola server MCP lokal melalui paket yang dapat diinstal dengan sekali klik. Alih-alih mengonfigurasi file JSON secara manual dan mengelola dependensi, Anda sekarang dapat menginstal server MCP lokal di komputer Anda semudah ekstensi browser.

Catatan: Kami sedang membangun direktori ekstensi desktop – jika Anda seorang pengembang yang berharap menambahkan ekstensi yang Anda buat ke direktori, lengkapi formulir minat ekstensi desktop kami untuk berbagi informasi lebih lanjut dengan kami.

Menginstal Ekstensi Desktop

  1. Navigasi ke Settings > Extensions di Claude Desktop.

  2. Jelajahi direktori ekstensi atau instal dari file .dxt.

  3. Klik "Install" pada ekstensi yang Anda inginkan.

  4. Konfigurasikan pengaturan yang diperlukan (seperti kunci API) melalui antarmuka yang ramah pengguna.

  5. Ekstensi akan otomatis tersedia dalam percakapan Anda.

Mengaktifkan/menonaktifkan ekstensi tertentu pada paket Team dan Enterprise

Pemilik dan Pemilik Utama organisasi Team dan Enterprise dapat mengelola DXT mana yang diaktifkan untuk organisasi Anda dan dapat diakses oleh anggota lain melalui Claude Desktop.

  1. Buka Claude Desktop.

  2. Klik inisial atau nama Anda di sudut kiri bawah, lalu "Settings."

  3. Klik "Extensions" di bawah Desktop app.

  4. Pilih tab "Organization extensions" di kanan atas.

  5. Dari halaman ini, klik "..." > "Disable" di sebelah ekstensi apa pun yang ingin Anda cegah agar tidak dapat diakses oleh anggota organisasi Anda.

  6. Anda juga dapat menggunakan filter di bagian atas daftar untuk melihat hanya ekstensi yang diaktifkan atau dinonaktifkan.

Catatan: Setelah Pemilik mengaktifkan atau menonaktifkan ekstensi, dapat memakan waktu hingga dua jam bagi anggota untuk melihat perubahan tercermin dalam akun mereka.

Mengatasi masalah instalasi ekstensi desktop

Ekstensi tidak dapat diinstal

  • 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 instalasi.

Ekstensi tampak terinstal tetapi alat tidak tersedia

  • Restart Claude Desktop untuk menyegarkan registri ekstensi.

  • Periksa pengaturan konfigurasi ekstensi untuk field yang diperlukan yang hilang.

  • Verifikasi bahwa kunci API atau kredensial autentikasi dimasukkan dengan benar.

Masalah konfigurasi ekstensi

  • Navigasi ke Settings > Extensions dan klik pada ekstensi untuk meninjau pengaturannya.

  • Pastikan semua field konfigurasi yang diperlukan telah dilengkapi.

  • 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 mengonversi server MCP yang ada menjadi ekstensi DXT?

  1. Tambahkan file manifest.json ke direktori server MCP Anda dengan metadata yang diperlukan.

  2. Kemas menggunakan perintah dxt pack.

  3. Lihat dokumentasi DXT untuk instruksi terperinci.

Bahasa pemrograman apa yang didukung untuk ekstensi DXT?

Ekstensi DXT mendukung Node.js, Python, dan server MCP biner. Claude Desktop menyertakan lingkungan Node.js bawaan, sehingga instalasi Node.js tidak diperlukan.

Bagaimana cara menangani konfigurasi sensitif seperti kunci API?

Tandai field 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 DXT saya secara pribadi?

Ya, Anda dapat membagikan file .dxt langsung dengan pengguna atau tim tertentu. Untuk distribusi yang lebih luas, Anda dapat mengirimkan ekstensi ke direktori resmi.

Bagaimana cara men-debug masalah dengan

Apakah pertanyaan Anda terjawab?