Jika Anda perlu memproses, menganalisis, atau menyajikan berkas lokal melalui server Model Context Protocol (MCP) Anda, Anda berada di tempat yang tepat. Panduan ini akan menunjukkan cara mengakses, membaca, dan memanipulasi berkas lokal dengan aman sambil memanfaatkan kemampuan server MCP Anda—baik Anda sedang membangun alat pemroses dokumen, API berbasis berkas, atau mengintegrasikan data lokal dengan LLM.
Kita akan membahas izin sistem berkas, penanganan berkas yang efisien, dan praktik terbaik keamanan untuk memastikan server MCP Anda berinteraksi dengan penyimpanan lokal secara aman dan efektif. Mari kita mulai!
Apa itu MCP dan Mengapa Menggunakannya?
Model Context Protocol adalah standar terbuka yang memungkinkan asisten AI seperti Claude untuk berinteraksi dengan berbagai sumber data dan alat. Ia menawarkan beberapa manfaat utama:
Akses Universal: Protokol tunggal untuk asisten AI untuk meminta dan mengambil data dari berbagai sumber.
Koneksi Aman dan Terstandarisasi: Menangani autentikasi, kebijakan penggunaan, dan format data terstandarisasi, menggantikan konektor API ad-hoc.
Keberlanjutan: Mendorong ekosistem konektor yang dapat digunakan kembali, memungkinkan pengembang untuk membangun sekali dan menggunakan kembali di beberapa LLM.
Mengapa Menghubungkan Claude ke Berkas Lokal?
Menghubungkan Claude ke sistem berkas Anda membuka manfaat produktivitas transformatif:
1. Pemrosesan Dokumen Cerdas:
- Meringkas laporan (
"Ekstrak wawasan utama dari Q2_Financials.docx") - Menganalisis data terstruktur (
"Konversi CSV ini menjadi ringkasan poin-poin") - Referensi silang informasi (
"Bandingkan perubahan antara draft_v1.txt dan draft_v2.txt")
2. Manajemen Berkas Otomatis:
- Mengatur berkas (
"Pindahkan semua PDF dari Unduhan ke Dokumen/Faktur") - Mengganti nama batch (
"Awali semua tangkapan layar dengan '2024-' dalam urutan kronologis") - Membersihkan penyimpanan (
"Hapus berkas sementara yang lebih lama dari 30 hari")
3. Alur Kerja Pengembangan yang Ditingkatkan:
- Refactoring kode (
"Optimalkan skrip Python ini untuk penggunaan memori yang lebih baik") - Pembuatan dokumentasi (
"Buat README.md untuk folder proyek ini") - Manajemen konfigurasi (
"Perbarui semua berkas .env dengan kunci API baru ini")
Prasyarat
Sebelum Anda memulai dengan Server Filesystem MCP, pastikan Anda memiliki yang berikut:
Aplikasi Desktop Claude: Unduh dan instal Aplikasi Desktop Claude yang kompatibel dengan sistem operasi Anda (tersedia untuk macOS dan Windows).
Node.js: Verifikasi bahwa Node.js terinstal di sistem Anda. Buka baris perintah Anda dan jalankan node --version. Jika Node.js tidak terinstal, unduh dari nodejs.org.
Pengetahuan Pemrograman Dasar: Keakraban dengan operasi baris perintah dasar dan mengedit berkas konfigurasi.
Izin Sistem Berkas: Pastikan bahwa pengguna yang saat ini masuk di mesin lokal Anda memiliki izin Baca/tulis yang benar untuk mengakses berkas dan direktori target yang ingin Anda gunakan.
Langkah 1: Instal dan Konfigurasi Server Filesystem MCP
Kita akan menggunakan Server Filesystem MCP yang sudah dibuat sebelumnya, yang memungkinkan Claude untuk membaca, menulis, memindahkan, dan mencari berkas di komputer Anda.
Temukan berkas claude_desktop_config.json:
1. Buka Aplikasi Desktop Claude dan pergi ke Pengaturan.
2. Di panel Pengaturan, navigasikan ke tab "Pengembang". Anda akan menemukan tombol "Edit Config" di sana.
3. Mengklik "Edit Config" akan membawa Anda ke lokasi berkas claude_desktop_config.json:
>> macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
>> Windows:
%APPDATA%\Claude\claude_desktop_config.jsonModifikasi berkas claude_desktop_config.json:
Buka berkas claude_desktop_config.json di editor teks. Ganti seluruh konten berkas dengan kode berikut, pastikan untuk mengganti "username" dengan nama pengguna komputer Anda yang sebenarnya:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Work", // Direktori hak akses terendah
"/Users/username/Projects" // Daftar izin eksplisit saja
],
"restrictions": {
"maxFileSizeMB": 10,
"allowedExtensions": [".txt", ".md", ".csv"]
}
}
}
}Penting: Jalur yang ditentukan dalam larik "args" menentukan direktori mana yang akan dapat diakses oleh Claude. Pastikan jalur ini valid dan mengarah ke direktori yang Anda inginkan agar Claude dapat mengakses dan memodifikasi. Anda dapat menambahkan lebih banyak jalur sesuai kebutuhan.
Pertimbangan Utama:
- Prinsip Hak Akses Terendah: Hanya sertakan direktori yang diperlukan.
- Daftar Putih Ekstensi: Cegah modifikasi berkas biner yang tidak disengaja.
- Batas Ukuran: Hindari masalah memori dengan berkas besar.
Langkah 2: Memahami Berkas Konfigurasi
Berkas claude_desktop_config.json memberi tahu Claude server MCP mana yang harus dimulai setiap kali aplikasi diluncurkan. Dalam hal ini, kita menambahkan server bernama "filesystem" yang menggunakan perintah Node npx untuk menginstal dan menjalankan @modelcontextprotocol/server-filesystem. Server ini memberi Claude akses ke sistem berkas Anda. Jika Anda sebelumnya telah mengonfigurasi Server MCP lain ke Aplikasi Desktop Claude Anda, maka Anda juga akan menemukan konfigurasinya di berkas ini.
Hak Akses Perintah
Sangat penting untuk memahami bahwa Claude akan menjalankan perintah dalam berkas konfigurasi dengan izin akun pengguna Anda, memberikan akses ke berkas lokal Anda. Hanya tambahkan perintah jika Anda sepenuhnya memahami dan mempercayai sumbernya.
Langkah 3: Mulai Ulang Claude
Setelah memperbarui berkas claude_desktop_config.json, Anda harus memulai ulang Aplikasi Desktop Claude agar perubahan diterapkan.
Langkah 4: Verifikasi Instalasi
Setelah memulai ulang Claude, Anda akan melihat ikon palu di sudut kanan bawah kotak input. Mengklik ikon ini akan menampilkan alat yang disediakan oleh Server Filesystem MCP:
Mengklik Ikon akan meninjau alat yang tersedia dari Server Filesystem MCP.
Jika server tidak dikenali oleh Claude, lanjutkan ke bagian pemecahan masalah.
Pemecahan Masalah
Jika Anda mengalami masalah, coba yang berikut:
Mulai Ulang Claude: Pastikan Anda telah sepenuhnya memulai ulang Aplikasi Desktop Claude.
Periksa sintaks claude_desktop_config.json: Verifikasi bahwa sintaks JSON dalam berkas konfigurasi Anda benar. Gunakan validator JSON untuk memeriksa kesalahan.
Validasi jalur berkas: Pastikan jalur berkas di claude_desktop_config.json valid, absolut, dan bukan relatif.
Periksa log: Periksa log untuk mengidentifikasi penyebab kegagalan koneksi:
macOS: ~/Library/Logs/Claude
Windows: %APPDATA%\Claude\logs
mcp.log berisi pencatatan umum tentang koneksi MCP dan kegagalan koneksi.
Berkas mcp-server-SERVERNAME.log berisi pencatatan kesalahan dari server bernama.
Jalankan server secara manual: Coba jalankan server secara manual di baris perintah Anda untuk melihat apakah Anda mendapatkan kesalahan:
npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop /Users/username/DownloadsMenggunakan Server Filesystem MCP
Sekarang setelah Anda menyiapkan Server Filesystem MCP, Anda dapat mulai berinteraksi dengan berkas lokal Anda melalui Claude.
1. Masukkan Prompt: "Buat desktop/test/hello_world.txt dengan 'Hello, World' sebagai teks"
2. Lihat respons: Lihat bagaimana Claude mencapai tugas yang ada.
3. Verifikasi Hasil: Claude seharusnya berhasil membuat berkas .txt dengan "Hello, World" sebagai teks di dalamnya.
Sekarang setelah Anda dapat mengakses dan membuat berkas langsung di mesin lokal Anda menggunakan aplikasi desktop Claude, coba prompt yang berbeda dan temukan kekuatan server Filesystem MCP! Berikut adalah beberapa contoh untuk membantu Anda memulai:
i. "Berapa banyak berkas yang saya miliki di folder unduhan saya."
ii. "Ringkas isi berkas report.txt di folder Desktop saya."
iii. "Buat berkas baru bernama todo.txt di folder Unduhan saya dan tambahkan tugas berikut: [daftar tugas]."
iv. "Pindahkan berkas image.png dari folder Desktop saya ke folder Unduhan saya."
Ingatlah bahwa Claude akan meminta izin Anda sebelum menjalankan tindakan apa pun pada sistem berkas Anda.
Kesimpulan
Dengan mengintegrasikan server MCP dengan Claude, Anda membuka tingkat interaksi baru dengan berkas lokal Anda, meningkatkan produktivitas Anda dan merampingkan alur kerja Anda. Pengaturan ini memungkinkan Anda untuk memanfaatkan kekuatan AI untuk tugas-tugas mulai dari analisis dokumen hingga pengeditan kode, sambil tetap memegang kendali atas data dan lingkungan Anda. Ini adalah tutorial yang luar biasa untuk memulai dengan Model context protocol dan Claude.
