MCP di Claude
Sambungkan Claude ke alat di luar chat.
[[MCP]] (Model Context Protocol) adalah cara standar supaya Claude bisa memakai alat dan data di luar obrolan: folder di laptop, spreadsheet, ticket, API. Halaman ini menjelaskan dari nol: apa itu MCP, cara memasang server siap pakai, cara memakainya dengan persetujuanmu, dan cara membuat MCP sendiri yang rapi. Perintah ditampilkan untuk Mac, Linux, dan Windows.
Ditulis oleh Aurelius Ivan Wijaya. Terakhir diperbarui 19 Juli 2026.
Tekan tombol Mode presentasi di pojok untuk menjadikannya slide.
Outline
Isi modul ini
Ringkasan urutan topik sebelum masuk ke detail.
Claude · Modul MCP
Apa itu MCP?
Colokan standar antara Claude dan alatmu.
Bayangkan Claude punya colokan universal. adalah colokan itu: satu cara standar supaya Claude bisa memanggil alat di luar chat, dengan izinmu tiap kali ada aksi penting.
Analogi singkat
MCP itu seperti adaptor listrik. Alatnya bisa beda-beda, tapi colokannya sama, jadi Claude tahu cara menyambung.
Yang kamu pasang disebut : program kecil yang menawarkan tool (baca file, kirim request, query database). Claude jadi yang memanggil tool itu.
Kenapa penting
Kenapa MCP berguna?
Tiga alasan yang langsung terasa di kerja sehari-hari.
Akses langsung
Claude bisa baca folder, ticket, atau API tanpa kamu bolak-balik copy-paste.
Satu cara sambung
Banyak alat ikut protokol yang sama, jadi pola pasangnya mirip dari satu server ke server lain.
Kamu yang setuju
Sebelum aksi penting, Claude meminta persetujuan. Kamu bisa tolak kapan saja.
Alur
Bagaimana MCP bekerja
Claude minta, server jalan, hasil kembali.
- 1
Kamu minta sesuatu yang butuh alat luar, misalnya daftar file di Desktop.
- 2
Claude memilih tool dari MCP server yang sudah terpasang.
- 3
Kalau aksi menyentuh sistemmu, Claude meminta persetujuan dulu.
- 4
Server menjalankan tool, lalu hasilnya masuk kembali ke obrolan.
Dua tempat pakai yang umum
memakai file konfigurasi JSON. bisa menambah server lewat perintah claude mcp add. Di Linux, jalur paling mulus biasanya Claude Code.
Sebelum pasang
Persiapan di laptopmu
Cek Node.js, lalu pilih jalur Claude-mu.
Banyak MCP server lokal jalan lewat Node.js (perintah npx). Cek dulu instalasinya. Kalau belum ada, unduh LTS dari nodejs.org.
Cek Node.js terpasang
Pilih tab OS-mu. Hasil yang diharapkan mirip v20.x atau v22.x.
1node --version2npx --versionClaude Desktop
Aplikasi desktop resmi (macOS dan Windows). MCP diatur lewat claude_desktop_config.json.
Claude Code
CLI agent di terminal (Mac, Linux, Windows). MCP diatur lewat claude mcp add atau file .mcp.json.
Catatan Linux
Claude Desktop resmi fokus ke macOS dan Windows. Di Linux, ikuti jalur Claude Code di slide berikutnya.
Praktik 1
Pasang MCP siap pakai
Contoh: Filesystem Server ke folder yang kamu izinkan.
Kita pakai server resmi @modelcontextprotocol/server-filesystem. Ganti username dan path folder dengan milikmu. Hanya izinkan folder yang kamu nyaman Claude baca dan ubah.
Claude Desktop: lokasi file config
Di Claude Desktop: Settings → Developer → Edit Config. File yang terbuka biasanya di path berikut.
1~/Library/Application Support/Claude/claude_desktop_config.jsonClaude Desktop: isi claude_desktop_config.json
Ganti username. Simpan file, lalu quit Claude Desktop sepenuhnya dan buka lagi.
1{2 "mcpServers": {3 "filesystem": {4 "command": "npx",5 "args": [6 "-y",7 "@modelcontextprotocol/server-filesystem",8 "/Users/username/Desktop",9 "/Users/username/Downloads"10 ]11 }12 }13}Claude Code: perintah yang sama di ketiga OS
Jalankan di folder proyekmu. Scope default = local (hanya proyek ini, untukmu).
1claude mcp add --transport stdio filesystem -- \2 npx -y @modelcontextprotocol/server-filesystem \3 "$HOME/Desktop" "$HOME/Downloads"4 5claude mcp listUji manual di terminal
Kalau server tidak muncul, jalankan perintah npx server-filesystem dengan path yang sama di terminal. Error di situ biasanya lebih jelas daripada di UI.
Setelah race: debug bareng
Ivan ambil satu error dari ruangan (path salah, JSON rusak, atau server diam), buka log sesuai OS, perbaiki di layar. Semua yang berhasil ikut spot-check tetangga.
Praktik 2
Cara memakai MCP
Minta tugas nyata, lalu approve dengan sadar.
Setelah filesystem terhubung, coba permintaan sederhana. Di Claude Desktop, cek konektor lewat tombol lampiran / connectors. Di Claude Code, ketik /mcp untuk status server.
1Lihat isi folder kerja yang sudah aku izinkan di MCP filesystem,2lalu buat file catatan-kerja.txt berisi 3 bullet ringkas3tentang tugas yang paling sering aku copy-paste ke chat.Cek status di Claude Code
1/mcp2claude mcp list- 1
Pastikan server filesystem terlihat connected.
- 2
Tulis permintaan yang jelas menyebut folder yang sudah kamu izinkan.
- 3
Saat Claude meminta izin, baca tool name dan path-nya sebelum approve.
- 4
Kalau ragu, Deny dulu. Minta Claude jelaskan rencananya, baru ulangi.
Praktik 3
Bikin MCP yang proper
Satu server, satu tujuan, tool yang jelas.
MCP yang rapi punya batas yang jelas: satu domain masalah, nama tool yang bisa ditebak, deskripsi kapan dipakai, dan tidak menyimpan rahasia di kode. Di bawah ini kerangka TypeScript minimal dengan SDK resmi.
1my-mcp-server/2├── package.json3├── tsconfig.json4└── src/5 └── index.tsScaffold proyek
Jalankan di folder kosong. Lalu isi src/index.ts dengan kerangka di blok berikutnya.
1mkdir my-mcp-server && cd my-mcp-server2npm init -y3npm install @modelcontextprotocol/sdk zod4npm install -D typescript @types/node tsx5npx tsc --init --rootDir src --outDir dist \6 --module nodenext --moduleResolution nodenext \7 --target es2022 --esModuleInterop1import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";2import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";3import { z } from "zod";4 5const server = new McpServer({6 name: "halo-waktu",7 version: "1.0.0",8});9 10server.tool(11 "waktu_sekarang",12 "Mengembalikan tanggal dan jam lokal mesin ini.",13 {},14 async () => ({15 content: [{ type: "text", text: new Date().toString() }],16 }),17);18 19const transport = new StdioServerTransport();20await server.connect(transport);Sambungkan server buatanmu ke Claude Code
Ganti path absolut ke folder proyekmu. Di Desktop, masukkan command/args yang sama ke mcpServers.
1claude mcp add --transport stdio halo-waktu -- \2 npx tsx /Users/username/my-mcp-server/src/index.ts3 4claude mcp get halo-waktuNama tool jelas
Pakai kata kerja + objek, misalnya waktu_sekarang atau list_invoice_open.
Deskripsi jujur
Tulis kapan tool ini dipakai, supaya Claude tidak menebak-nebak.
Rahasia di env
API key masuk lewat environment variable, jangan di-hardcode di index.ts.
Supaya aman
Tips dan kesalahan umum
Tiga kebiasaan yang menjaga MCP tetap sehat.
Izinkan folder seminimal mungkin
Jangan langsung kasih akses ke seluruh home directory. Mulai dari satu folder kerja.
Pasang hanya dari sumber yang kamu percaya
MCP server bisa menjalankan perintah di mesinmu. Baca dulu apa yang dia tawarkan sebelum menyambung.
JSON salah = server diam
Di Desktop, koma atau path relatif yang salah sering membuat server tidak muncul. Cek log Claude, atau jalankan perintah server manual di terminal.
Lihat log Claude Desktop (kalau server gagal connect)
1tail -n 20 -f ~/Library/Logs/Claude/mcp*.logPertanyaan umum
FAQ
Satu kartu, satu pertanyaan. Ketuk untuk membuka jawaban, geser untuk lanjut ke kartu berikutnya.
1 / 6
Apa itu MCP di Claude?
MCP (Model Context Protocol) adalah cara standar supaya Claude bisa memakai alat dan data di luar chat, misalnya file di laptop atau layanan online, lewat program kecil yang disebut MCP server.
Kapan aku pakai Skills, kapan MCP?
Pakai Skills waktu kamu mau menyimpan cara kerja yang dipanggil berulang dengan nama. Pakai MCP waktu Claude perlu menyentuh alat atau data di luar chat, misalnya file di laptop atau layanan online.
Apakah aku perlu bisa coding untuk memakai MCP?
Untuk memasang server siap pakai, biasanya cukup mengedit file config atau menjalankan perintah claude mcp add. Untuk membuat server sendiri, kamu perlu dasar Node.js atau mengikuti scaffold resmi.
Di mana file config Claude Desktop disimpan?
Di macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. Di Windows: %APPDATA%\Claude\claude_desktop_config.json. Di Linux, jalur utama biasanya Claude Code dengan claude mcp add atau file .mcp.json.
Bagaimana cara cek MCP sudah tersambung?
Di Claude Desktop, buka connectors / manage connectors dan pastikan servermu muncul. Di Claude Code, ketik /mcp atau jalankan claude mcp list di terminal.
Apakah MCP aman?
Aman kalau kamu membatasi folder atau API yang diizinkan, hanya memasang server dari sumber terpercaya, dan membaca dialog approve sebelum mengizinkan aksi. Server berjalan dengan izin akunmu.
Bacaan lanjutan
Ingin tim kamu dilatih langsung?
AI Training Indonesia membawakan pelatihan AI praktis untuk tim perusahaan, termasuk membangun dan memakai Skills di Claude.