ClaudeLevel dasarBaca sekitar 14 menit

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.

Claude · Modul MCP

Apa itu MCP?

Colokan standar antara Claude dan alatmu.

Alur langkah edukasiClaude terhubung ke MCP server lalu membuka alat seperti file dan API.123Claude terhubung ke MCP server lalu membuka alat seperti file dan API.
Ivan demo MCP 60 detik dulu. Lalu 30 detik: tulis satu alat di luar chat yang barusan terasa relevan. Angkat tangan kalau siap cerita.

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.

Alur langkah edukasiTiga manfaat MCP: akses langsung, satu format, dan kontrol persetujuan.123Tiga manfaat MCP: akses langsung, satu format, dan kontrol persetujuan.
Ringkas: pilih 1, 2, atau 3 untuk use case slide 1. Satu orang per angka, satu kalimat. Ivan 20 detik: satu error MCP yang pernah dia alami. Total 2 menit, lalu lanjut pasang.

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.

Alur langkah edukasiPermintaan dari Claude masuk ke MCP server, tool dijalankan, hasil dikembalikan.1234Permintaan dari Claude masuk ke MCP server, tool dijalankan, hasil dikembalikan.
Kalau demo Ivan sudah jalan, skip chant. Kalau belum: empat ketukan bareng minta → server → tool → hasil. Volunter: tool paling berbahaya kalau salah approve.
  1. 1

    Kamu minta sesuatu yang butuh alat luar, misalnya daftar file di Desktop.

  2. 2

    Claude memilih tool dari MCP server yang sudah terpasang.

  3. 3

    Kalau aksi menyentuh sistemmu, Claude meminta persetujuan dulu.

  4. 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.

Alur langkah edukasiCek Node.js, buka Claude, lalu siap memasang MCP.123Cek Node.js, buka Claude, lalu siap memasang MCP.
Sekarang: buka terminal, jalankan node --version. Angkat tangan kalau versinya muncul. Kalau error, duduk berdua dengan tetangga yang sukses.

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.

Terminal di Mac
1node --version2npx --version

Claude 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.

Alur langkah edukasiEdit config, restart Claude, lalu MCP filesystem muncul sebagai konektor.123Edit config, restart Claude, lalu MCP filesystem muncul sebagai konektor.
Pilih jalur Desktop atau Claude Code. Ivan hitung 90 detik. Yang dulu lihat filesystem connected: berdiri. Yang error: tetap berdiri, kita debug bareng 2 menit.

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.

macOS
1~/Library/Application Support/Claude/claude_desktop_config.json

Claude 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 list

Uji 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.

Alur langkah edukasiMinta tugas, Claude mengajukan tool, kamu approve, hasil muncul.1234Minta tugas, Claude mengajukan tool, kamu approve, hasil muncul.
Ketik permintaan ke Claude memakai alat atau folder yang kamu tulis di slide pertama. Saat approve: baca path keras-keras sebelum Allow.

Setelah filesystem terhubung, coba permintaan sederhana. Di Claude Desktop, cek konektor lewat tombol lampiran / connectors. Di Claude Code, ketik /mcp untuk status server.

Contoh permintaan (ganti path/folder dengan milikmu)
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. 1

    Pastikan server filesystem terlihat connected.

  2. 2

    Tulis permintaan yang jelas menyebut folder yang sudah kamu izinkan.

  3. 3

    Saat Claude meminta izin, baca tool name dan path-nya sebelum approve.

  4. 4

    Kalau ragu, Deny dulu. Minta Claude jelaskan rencananya, baru ulangi.

Praktik 3

Bikin MCP yang proper

Satu server, satu tujuan, tool yang jelas.

Alur langkah edukasiBuat folder proyek, tulis server, daftarkan tool, lalu sambungkan ke Claude.1234Buat folder proyek, tulis server, daftarkan tool, lalu sambungkan ke Claude.
45 detik: /nama-server → tool_apa untuk use case-mu tadi. Tempeld di chat kelas. Lanjut scaffold (Ivan keliling cek). Ganti waktu_sekarang kalau sempat.

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.

Struktur folder yang rapi
1my-mcp-server/2├── package.json3├── tsconfig.json4└── src/5    └── index.ts

Scaffold 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 --esModuleInterop
src/index.ts: kerangka tool satu fungsi
1import { 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-waktu

Nama 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.

Alur langkah edukasiTiga tip: folder sempit, sumber terpercaya, dan uji di terminal dulu.123Tiga tip: folder sempit, sumber terpercaya, dan uji di terminal dulu.
Berdiri. Pilih tip yang paling sering kamu langgar. 40 detik ke sebelah. Duduk: screenshot /mcp atau konektor plus satu permintaan kerja asli yang sudah berhasil.

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*.log

Pertanyaan 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.

Ingin tim kamu dilatih langsung?

AI Training Indonesia membawakan pelatihan AI praktis untuk tim perusahaan, termasuk membangun dan memakai Skills di Claude.