Lewati ke konten utama

Memulai dengan Model Context Protocol (MCP) di Claude untuk Desktop

Diperbarui lebih dari 2 minggu yang lalu

MCP di Claude untuk 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 dalam 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

Pemecahan 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

Error 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 dibutuhkan

  • Untuk lingkungan enterprise, verifikasi bahwa ekstensi desktop diaktifkan melalui kebijakan organisasi Anda

FAQ Pengembang

Bagaimana cara mengonversi server MCP yang sudah ada menjadi ekstensi DXT?

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

  2. Paket menggunakan perintah dxt pack

  3. Lihat dokumentasi DXT untuk instruksi detail

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 ekstensi DXT saya?

Aktifkan debug logging di pengaturan Claude Desktop, periksa log ekstensi di panel pengaturan Extensions, dan rujuk ke 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 menginstal file .dxt yang diperbarui secara manual.

Kontrol Kebijakan Enterprise

Administrator enterprise dapat mengontrol ekstensi desktop melalui kebijakan sistem:

Konfigurasi Enterprise macOS

Konfigurasikan ekstensi desktop melalui file property list di

~/Library/Preferences/com.anthropic.Claude.plist:

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict>    <key>isDxtEnabled</key>    <true/>    <key>isDxtDirectoryEnabled</key>    <false/>    <key>isDxtSignatureRequired</key>    <true/>    <key>dxtRegistry</key>    <string>https://registry.example.com</string></dict></plist>

Konfigurasi Enterprise Windows

Apakah pertanyaan Anda terjawab?