Learning / AI Tools & Agent
MCP (Model Context Protocol): Menyambungkan Agent ke Tool & Data

Gambar: modelcontextprotocol.io, lisensi CC-BY-4.0.
Apa itu MCP?
MCP adalah standar terbuka untuk menghubungkan aplikasi AI ke sistem luar: file, database, kalender, GitHub, dan lainnya. Dokumentasinya memakai analogi "port USB-C untuk aplikasi AI": sekali sebuah server dibuat, server itu bisa dipakai di banyak aplikasi seperti Claude, ChatGPT, VS Code, dan Cursor.
Skill vs MCP
| Skill | MCP server | |
|---|---|---|
| Isinya | Instruksi/pengetahuan (Markdown) | Program yang memberi kemampuan baru |
| Contoh | "Cara review artikel" | "Bisa membaca file di folder X", "bisa membuat issue" |
| Jalan di mana | Dibaca agent sebagai teks | Proses terpisah (lokal) atau layanan (remote) |
| Risiko | Instruksi berbahaya | Akses nyata ke data/akun |
Keduanya sering dipakai bersama: MCP memberi tangan, skill memberi cara kerja.
Tiga hal yang bisa diberikan server
- Tools: aksi yang bisa dipanggil model, misalnya
read_fileataucreate_issue. - Resources: data yang bisa dibaca, misalnya isi file atau catatan.
- Prompts: template prompt siap pakai dari server.
Transport untuk pemula
Diagram buatan sendiri.
- stdio (lokal): aplikasi AI menjalankan server sebagai program di komputermu, misalnya lewat
npx …. Cocok untuk file lokal. - HTTP / remote: server ada di internet dan diakses lewat URL
https://…. Biasanya butuh login (OAuth) atau token header.
Contoh: server filesystem lokal di Claude Code
Server resmi @modelcontextprotocol/server-filesystem hanya boleh menyentuh folder yang kamu izinkan, dan punya mode --read-only.
# Mac (ganti path dengan folder latihanmu)
claude mcp add --transport stdio file-latihan -- npx -y @modelcontextprotocol/server-filesystem --read-only /Users/NAMAKAMU/latihan-mcp
# Windows
claude mcp add --transport stdio file-latihan -- npx -y @modelcontextprotocol/server-filesystem --read-only C:\Users\NAMAKAMU\latihan-mcp
Tanda -- memisahkan opsi Claude Code dari perintah yang menjalankan server.
Cek dan kelola:
claude mcp list
claude mcp get file-latihan
claude mcp remove file-latihan
Di dalam sesi Claude Code, perintah /mcp menampilkan status server.
Scope: default local (hanya kamu, proyek ini). --scope project menulis ke .mcp.json yang ikut di-commit (Claude Code meminta persetujuan sebelum memakainya). --scope user berlaku untuk semua proyekmu.
Remote (contoh format dari docs):
claude mcp add --transport http nama-server https://mcp.example.com/mcp
Client lain (OpenCode, Codex, Cursor, VS Code, Hermes) juga mendukung MCP dengan format konfigurasi masing-masing. Ikuti dokumen client tersebut; jangan menyalin format antar-aplikasi begitu saja.
Auth & secret
- Untuk remote, utamakan login OAuth yang disediakan client.
- Kalau server butuh API key, berikan lewat
--env NAMA=nilaiatau variabel lingkungan. Jangan tulis key di.mcp.jsonyang di-commit.
Izin & keamanan
- Prinsip least privilege: izinkan satu folder saja, aktifkan
--read-onlyjika cukup. - Anggap output tool sebagai data tak tepercaya. Isi file atau halaman web bisa berisi prompt injection.
- Setujui tiap aksi yang menulis atau menghapus; jangan "auto-approve semua".
- Pasang server hanya dari sumber resmi/tepercaya, dan baca README-nya.
Troubleshooting
| Masalah | Solusi |
|---|---|
| Server tidak muncul / gagal | claude mcp get <nama>, cek status; pastikan Node/npx terpasang |
Flag -y dianggap milik Claude | Letakkan seluruh perintah server setelah -- |
| Tidak bisa baca file | Path tidak termasuk folder yang diizinkan |
Server .mcp.json tidak aktif | Setujui dulu prompt persetujuan server proyek |
Latihan
- Buat folder
latihan-mcpberisi dua file teks. - Tambahkan server filesystem
--read-only, lalu minta Claude meringkas kedua file. - Minta Claude mengedit file. Yang diharapkan: gagal, karena tool tulis tidak tersedia dalam mode read-only.
- Hapus server dengan
claude mcp remove.
Glosarium
- Client/host: aplikasi AI yang memakai server (Claude Code, VS Code, dll.).
- Server: program yang menyediakan tools, resources, dan prompts.
- stdio: komunikasi lewat input/output program lokal.
- Scope: siapa yang bisa memakai konfigurasi server.
Video tutorial
Video milik kreatornya masing-masing, disematkan dari YouTube (tidak diunggah ulang). Jika isi video berbeda dengan materi, ikuti materi & dokumen resmi.
Channel: GitHub · Bahasa: Inggris · Video resmi GitHubTonton di YouTube ↗
Channel: Anthropic · Bahasa: Inggris · Video resmi Anthropic (latar belakang)Tonton di YouTube ↗