Learning / AI Tools & Agent

MCP (Model Context Protocol): Menyambungkan Agent ke Tool & Data

Diagram MCP resmi

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

SkillMCP server
IsinyaInstruksi/pengetahuan (Markdown)Program yang memberi kemampuan baru
Contoh"Cara review artikel""Bisa membaca file di folder X", "bisa membuat issue"
Jalan di manaDibaca agent sebagai teksProses terpisah (lokal) atau layanan (remote)
RisikoInstruksi berbahayaAkses 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_file atau create_issue.
  • Resources: data yang bisa dibaca, misalnya isi file atau catatan.
  • Prompts: template prompt siap pakai dari server.

Transport untuk pemula

Diagram stdio vs remote

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=nilai atau variabel lingkungan. Jangan tulis key di .mcp.json yang di-commit.

Izin & keamanan

  • Prinsip least privilege: izinkan satu folder saja, aktifkan --read-only jika 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

MasalahSolusi
Server tidak muncul / gagalclaude mcp get <nama>, cek status; pastikan Node/npx terpasang
Flag -y dianggap milik ClaudeLetakkan seluruh perintah server setelah --
Tidak bisa baca filePath tidak termasuk folder yang diizinkan
Server .mcp.json tidak aktifSetujui dulu prompt persetujuan server proyek

Latihan

  1. Buat folder latihan-mcp berisi dua file teks.
  2. Tambahkan server filesystem --read-only, lalu minta Claude meringkas kedua file.
  3. Minta Claude mengedit file. Yang diharapkan: gagal, karena tool tulis tidak tersedia dalam mode read-only.
  4. 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.

Video baru dimuat setelah diklik (youtube-nocookie.com).
What is MCP and how does it work with AI?
Channel: GitHub · Bahasa: Inggris · Video resmi GitHubTonton di YouTube ↗
Video baru dimuat setelah diklik (youtube-nocookie.com).
Why we built—and donated—the Model Context Protocol (MCP)
Channel: Anthropic · Bahasa: Inggris · Video resmi Anthropic (latar belakang)Tonton di YouTube ↗
Gabung grup