FreeAILab free-ai-lab

Panduan pengaturan MCP

Tutorial

Pengaturan Claude Desktop / Cursor / VS Code + solusi error yang sering terjadi.

Yang dibutuhkan

  • Setidaknya salah satu dari Claude Desktop / Cursor / VS Code sudah terpasang
  • Runtime yang dibutuhkan server MCP yang akan dipasang (sebagian besar Node.js atau Python, sebagian perlu dependensi tambahan)
  • Kredensial API yang disiapkan (misalnya token GitHub) — diperlukan saat mengatur

Claude Desktop

Operasi lewat layar grafis:

  1. Buka Claude Desktop → Settings (Pengaturan)
  2. Masuk ke Developer → klik Edit Config
  3. Tambahkan server pada entri mcpServers di claude_desktop_config.json:
{ "mcpServers": { "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "masukkan-token-anda-di-sini" } } } }

Simpan berkas dan mulai ulang Claude Desktop. Alat baru akan muncul di daftar alat pada bilah sisi kiri. Selalu ikuti README server untuk perintah dan argumennya.

Cursor

  1. Buka command palette (Ctrl+Shift+P / Cmd+Shift+P)
  2. Cari dan pilih Cursor Settings > MCP
  3. Klik Add New MCP Server, pilih metode transmisi (stdio atau SSE), lalu isi perintah/argumennya

VS Code

  1. Pasang ekstensi MCP Client (atau gunakan Copilot / ekstensi dengan dukungan MCP bawaan)
  2. Di pengaturan ekstensi, konfigurasikan mcpServers dengan format JSON yang sama seperti Claude Desktop
  3. Muat ulang jendela VS Code agar perubahan diterapkan

Tampilan bisa berbeda tergantung versi klien — selalu periksa dokumentasi resmi untuk langkah yang tepat, dan selalu ikuti README server untuk perintah/struktur JSON-nya.

Solusi error yang sering terjadi

Error Penyebab Solusi
command not foundRuntime Node/Python tidak ada atau tidak ada di PATHPasang runtime lalu mulai ulang klien
401 / 403Kredensial API salah atau sudah kedaluwarsaTerbitkan ulang token dan periksa kembali pengaturan env
Connection refusedAlamat server SSE salah atau layanan tidak sedang berjalanPeriksa URL + port dan pastikan server sedang online
Tool not foundKlien tidak dimulai ulang sehingga perubahan pengaturan belum dimuatSetelah menyimpan pengaturan, mulai ulang aplikasi klien sepenuhnya

Catatan keamanan

  • Token hanya tersimpan di berkas pengaturan lokal — jangan pernah mengunggahnya ke Git (jangan lupa .gitignore)
  • Hanya pasang server dari proyek yang tepercaya dan bereputasi baik — server yang belum terverifikasi bisa mencuri data Anda
  • Izinkan server berhak istimewa tinggi hanya saat benar-benar diperlukan