Alamat baru: CoworkerAI.io!

Panduan Instalasi Plugin MCP

Pelajari cara menginstal dan mengonfigurasi server MCP (Model Context Protocol) untuk memperluas kemampuan Claude dengan alat eksternal, sumber data, dan integrasi.

Model Context Protocol (MCP) adalah standar terbuka yang dibuat oleh Anthropic untuk menyeragamkan cara model AI terhubung ke sumber data dan alat eksternal. Sering disebut sebagai "USB-C untuk AI", MCP menyediakan antarmuka universal agar Claude dapat berinteraksi dengan file lokal, database, API, dan alat pengembangan Anda.

Per tahun 2026, MCP didukung oleh Anthropic, OpenAI, Google, dan Microsoft — menjadikannya standar integrasi de facto untuk agen AI. Saat ini tersedia 593+ server MCP dalam ekosistem, mulai dari paket resmi Anthropic hingga integrasi buatan komunitas.

Prasyarat

terminal

Node.js (LTS)

Diperlukan untuk menjalankan sebagian besar server MCP melalui npx. Unduh dari nodejs.org.

code

Python / uv (Opsional)

Beberapa server MCP berbasis Python dan menggunakan uvx sebagai pengganti npx.

desktop_mac

Claude Desktop

Aplikasi Claude Desktop harus sudah terinstal. Tersedia untuk macOS dan Windows.

info

Tidak Perlu Langganan

Server MCP berfungsi di semua paket Claude, termasuk paket gratis.

Lokasi File Konfigurasi

Server MCP dikonfigurasi di file claude_desktop_config.json. Lokasi file ini tergantung pada sistem operasi Anda:

desktop_mac macOS
~/Library/Application Support/Claude/claude_desktop_config.json
desktop_windows Windows
%APPDATA%\Claude\claude_desktop_config.json
lightbulb

Tips

Anda tidak perlu membuat file ini secara manual. Claude Desktop dapat membuatnya untuk Anda — lihat langkah instalasi di bawah.

Langkah-Langkah Instalasi

1

Buka Claude Desktop

Buka aplikasi Claude Desktop di komputer Anda.

2

Buka Pengaturan

Klik menu hamburger → File → Settings (atau gunakan pintasan keyboard).

3

Buka Tab Developer

Di panel Settings, klik tab "Developer" di sidebar kiri.

4

Klik "Edit Config"

Ini akan membuka (atau membuat) file claude_desktop_config.json di editor teks bawaan Anda.

5

Tambahkan Konfigurasi Server MCP

Tambahkan server MCP yang diinginkan di bawah key mcpServers (lihat format konfigurasi di bawah).

6

Simpan dan Mulai Ulang

Simpan file konfigurasi dan mulai ulang Claude Desktop sepenuhnya agar perubahan diterapkan.

7

Verifikasi Instalasi

Cari ikon palu 🔨 di antarmuka Claude Desktop. Klik ikon tersebut untuk melihat semua alat MCP yang tersedia.

Format Konfigurasi

File konfigurasi menggunakan struktur JSON sederhana. Setiap server MCP didefinisikan di bawah key mcpServers:

data_object Struktur Dasar
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@package/server-name"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}
folder Contoh Server Filesystem
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}
stacks Contoh Beberapa Server
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

Protokol Transport

MCP mendukung berbagai mekanisme transport untuk komunikasi antara Claude dan server MCP:

terminal

stdio (Standard I/O)

Transport bawaan untuk Claude Desktop. Klien menjalankan server MCP sebagai proses lokal dan berkomunikasi melalui stdin/stdout. Inilah yang didefinisikan oleh field command dan args dalam konfigurasi.

check Direkomendasikan untuk penggunaan lokal
cloud

StreamableHTTP

Protokol yang direkomendasikan untuk akses web dan remote. Mendukung beberapa klien secara bersamaan dan merupakan penerus transport SSE yang sudah tidak digunakan lagi.

language Untuk server remote/web
do_not_disturb

SSE (Server-Sent Events)

Sudah tidak digunakan lagi, digantikan oleh StreamableHTTP. Hindari penggunaan untuk integrasi baru.

Pertimbangan Keamanan

warning

Penting

Server MCP berjalan secara lokal dengan akses ke sistem Anda. Pada Januari 2026, ditemukan kerentanan kritis di server Git MCP resmi Anthropic. Selalu ikuti praktik keamanan terbaik.

check_circle

Instal hanya dari sumber terpercaya — Gunakan paket resmi Anthropic atau server komunitas terkenal yang aktif dikelola.

check_circle

Perbarui server secara rutin — Jalankan npx @package/server-name secara berkala untuk mendapatkan patch keamanan terbaru.

check_circle

Gunakan environment variable untuk rahasia — Jangan pernah menulis API key langsung di file konfigurasi. Gunakan field env atau environment variable sistem.

check_circle

Batasi cakupan filesystem — Saat menggunakan server filesystem, berikan akses hanya ke direktori tertentu yang Anda butuhkan.

check_circle

Hapus server yang tidak digunakan — Setiap server MCP menambah permukaan serangan. Hapus server yang tidak aktif Anda gunakan.

Pemecahan Masalah

Ikon palu tidak muncul setelah restart expand_more

Ini biasanya berarti file konfigurasi memiliki kesalahan sintaks JSON. Masalah umum:

  • Koma hilang atau berlebih di antara entri server
  • Kurung atau kurung kurawal tidak cocok
  • Menggunakan tanda kutip tunggal alih-alih tanda kutip ganda

Validasi JSON Anda di jsonlint.com atau gunakan node -e "JSON.parse(require('fs').readFileSync('path/to/config.json'))"

Server MCP gagal dimulai expand_more

Periksa hal-hal berikut:

  • Pastikan Node.js sudah terinstal dan npx tersedia di PATH Anda
  • Coba jalankan perintah npx secara manual di terminal untuk melihat output error
  • Periksa apakah nama paket sudah benar (typo sering terjadi)
  • Untuk server yang memerlukan API key, pastikan key valid dan diatur dengan benar di field env
Error akses ditolak (permission denied) expand_more

Server MCP mewarisi izin dari proses Claude Desktop:

  • Di macOS, periksa System Settings → Privacy & Security untuk izin yang relevan
  • Pastikan direktori yang ditentukan dalam konfigurasi dapat diakses oleh akun pengguna Anda
  • Untuk server filesystem, pastikan path di args ada dan dapat dibaca
extension

Jelajahi Ekosistem MCP

Dengan 593+ server MCP yang tersedia, kemungkinan besar ada server untuk kebutuhan Anda. Telusuri direktori server MCP resmi di modelcontextprotocol.io atau lihat daftar kurasi komunitas di GitHub untuk penambahan terbaru.