Hubungkan Claude Code ke alat melalui MCP

Claude Code dapat terhubung ke ratusan alat eksternal dan sumber data melalui Model Context Protocol (MCP), standar open-source untuk integrasi alat AI. Server MCP memberikan Claude Code akses ke alat, database, dan API Anda.

​

Apa yang dapat Anda lakukan dengan MCP

Dengan server MCP yang terhubung, Anda dapat meminta Claude Code untuk:

• Mengimplementasikan fitur dari pelacak masalah: “Tambahkan fitur yang dijelaskan dalam masalah JIRA ENG-4521 dan buat PR di GitHub.”
• Menganalisis data pemantauan: “Periksa Sentry dan Statsig untuk memeriksa penggunaan fitur yang dijelaskan dalam ENG-4521.”
• Menanyakan database: “Temukan email dari 10 pengguna acak yang menggunakan fitur ENG-4521, berdasarkan database Postgres kami.”
• Mengintegrasikan desain: “Perbarui template email standar kami berdasarkan desain Figma baru yang diposting di Slack”
• Mengotomatisasi alur kerja: “Buat draf Gmail yang mengundang 10 pengguna ini ke sesi umpan balik tentang fitur baru.”

​

Server MCP populer

Berikut adalah beberapa server MCP yang umum digunakan yang dapat Anda hubungkan ke Claude Code:

​

Menginstal server MCP

Server MCP dapat dikonfigurasi dengan tiga cara berbeda tergantung pada kebutuhan Anda:

​

Opsi 1: Tambahkan server stdio lokal

Server stdio berjalan sebagai proses lokal di mesin Anda. Mereka ideal untuk alat yang memerlukan akses sistem langsung atau skrip khusus.

# Sintaks dasar
claude mcp add <name> <command> [args...]

# Contoh nyata: Tambahkan server Airtable
claude mcp add airtable --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

​

Opsi 2: Tambahkan server SSE remote

Server SSE (Server-Sent Events) menyediakan koneksi streaming real-time. Banyak layanan cloud menggunakan ini untuk pembaruan langsung.

# Sintaks dasar
claude mcp add --transport sse <name> <url>

# Contoh nyata: Hubungkan ke Linear
claude mcp add --transport sse linear https://mcp.linear.app/sse

# Contoh dengan header otentikasi
claude mcp add --transport sse private-api https://api.company.com/mcp \
  --header "X-API-Key: your-key-here"

​

Opsi 3: Tambahkan server HTTP remote

Server HTTP menggunakan pola permintaan/respons standar. Sebagian besar API REST dan layanan web menggunakan transport ini.

# Sintaks dasar
claude mcp add --transport http <name> <url>

# Contoh nyata: Hubungkan ke Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Contoh dengan token Bearer
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

​

Mengelola server Anda

Setelah dikonfigurasi, Anda dapat mengelola server MCP Anda dengan perintah-perintah ini:

# Daftar semua server yang dikonfigurasi
claude mcp list

# Dapatkan detail untuk server tertentu
claude mcp get github

# Hapus server
claude mcp remove github

# (dalam Claude Code) Periksa status server
/mcp

# Ini membuat command="cmd" yang dapat dieksekusi Windows
claude mcp add my-server -- cmd /c npx -y @some/package

​

Cakupan instalasi MCP

Server MCP dapat dikonfigurasi pada tiga tingkat cakupan yang berbeda, masing-masing melayani tujuan yang berbeda untuk mengelola aksesibilitas dan berbagi server. Memahami cakupan ini membantu Anda menentukan cara terbaik untuk mengkonfigurasi server untuk kebutuhan spesifik Anda.

​

Cakupan lokal

Server dengan cakupan lokal mewakili tingkat konfigurasi default dan disimpan dalam pengaturan pengguna khusus proyek Anda. Server ini tetap pribadi untuk Anda dan hanya dapat diakses saat bekerja dalam direktori proyek saat ini. Cakupan ini ideal untuk server pengembangan pribadi, konfigurasi eksperimental, atau server yang berisi kredensial sensitif yang tidak boleh dibagikan.

# Tambahkan server dengan cakupan lokal (default)
claude mcp add my-private-server /path/to/server

# Secara eksplisit tentukan cakupan lokal
claude mcp add my-private-server --scope local /path/to/server

​

Cakupan proyek

Server dengan cakupan proyek memungkinkan kolaborasi tim dengan menyimpan konfigurasi dalam file .mcp.json di direktori root proyek Anda. File ini dirancang untuk dimasukkan ke dalam kontrol versi, memastikan semua anggota tim memiliki akses ke alat dan layanan MCP yang sama. Ketika Anda menambahkan server dengan cakupan proyek, Claude Code secara otomatis membuat atau memperbarui file ini dengan struktur konfigurasi yang sesuai.

# Tambahkan server dengan cakupan proyek
claude mcp add shared-server --scope project /path/to/server

File .mcp.json yang dihasilkan mengikuti format standar:

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

Untuk alasan keamanan, Claude Code meminta persetujuan sebelum menggunakan server dengan cakupan proyek dari file .mcp.json. Jika Anda perlu mereset pilihan persetujuan ini, gunakan perintah claude mcp reset-project-choices.

​

Cakupan pengguna

Server dengan cakupan pengguna menyediakan aksesibilitas lintas proyek, membuatnya tersedia di semua proyek di mesin Anda sambil tetap pribadi untuk akun pengguna Anda. Cakupan ini bekerja dengan baik untuk server utilitas pribadi, alat pengembangan, atau layanan yang sering Anda gunakan di berbagai proyek.

# Tambahkan server pengguna
claude mcp add my-user-server --scope user /path/to/server

​

Memilih cakupan yang tepat

Pilih cakupan Anda berdasarkan:

• Cakupan lokal: Server pribadi, konfigurasi eksperimental, atau kredensial sensitif khusus untuk satu proyek
• Cakupan proyek: Server yang dibagikan tim, alat khusus proyek, atau layanan yang diperlukan untuk kolaborasi
• Cakupan pengguna: Utilitas pribadi yang diperlukan di beberapa proyek, alat pengembangan, atau layanan yang sering digunakan

​

Hierarki cakupan dan prioritas

Konfigurasi server MCP mengikuti hierarki prioritas yang jelas. Ketika server dengan nama yang sama ada di beberapa cakupan, sistem menyelesaikan konflik dengan memprioritaskan server dengan cakupan lokal terlebih dahulu, diikuti oleh server dengan cakupan proyek, dan akhirnya server dengan cakupan pengguna. Desain ini memastikan bahwa konfigurasi pribadi dapat mengganti yang dibagikan bila diperlukan.

​

Ekspansi variabel lingkungan dalam .mcp.json

Claude Code mendukung ekspansi variabel lingkungan dalam file .mcp.json, memungkinkan tim untuk berbagi konfigurasi sambil mempertahankan fleksibilitas untuk jalur khusus mesin dan nilai sensitif seperti kunci API.

Sintaks yang didukung:

• ${VAR} - Mengembang ke nilai variabel lingkungan VAR
• ${VAR:-default} - Mengembang ke VAR jika diatur, jika tidak menggunakan default

Lokasi ekspansi: Variabel lingkungan dapat dikembangkan di:

• command - Jalur executable server
• args - Argumen baris perintah
• env - Variabel lingkungan yang diteruskan ke server
• url - Untuk tipe server SSE/HTTP
• headers - Untuk otentikasi server SSE/HTTP

Contoh dengan ekspansi variabel:

{
  "mcpServers": {
    "api-server": {
      "type": "sse",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

Jika variabel lingkungan yang diperlukan tidak diatur dan tidak memiliki nilai default, Claude Code akan gagal mengurai konfigurasi.

​

Contoh praktis

​

Contoh: Memantau error dengan Sentry

# 1. Tambahkan server MCP Sentry
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 2. Gunakan /mcp untuk mengotentikasi dengan akun Sentry Anda
> /mcp

# 3. Debug masalah produksi
> "Apa error paling umum dalam 24 jam terakhir?"
> "Tunjukkan stack trace untuk error ID abc123"
> "Deployment mana yang memperkenalkan error baru ini?"

​

Otentikasi dengan server MCP remote

Banyak server MCP berbasis cloud memerlukan otentikasi. Claude Code mendukung OAuth 2.0 untuk koneksi yang aman.

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

> /mcp

​

Tambahkan server MCP dari konfigurasi JSON

Jika Anda memiliki konfigurasi JSON untuk server MCP, Anda dapat menambahkannya langsung:

# Sintaks dasar
claude mcp add-json <name> '<json>'

# Contoh: Menambahkan server stdio dengan konfigurasi JSON
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get weather-api

​

Impor server MCP dari Claude Desktop

Jika Anda sudah mengkonfigurasi server MCP di Claude Desktop, Anda dapat mengimpornya:

# Sintaks dasar 
claude mcp add-from-claude-desktop 

claude mcp list 

​

Gunakan Claude Code sebagai server MCP

Anda dapat menggunakan Claude Code sendiri sebagai server MCP yang dapat dihubungkan oleh aplikasi lain:

# Mulai Claude sebagai server MCP stdio
claude mcp serve

Anda dapat menggunakan ini di Claude Desktop dengan menambahkan konfigurasi ini ke claude_desktop_config.json:

{
  "mcpServers": {
    "claude-code": {
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

​

Gunakan sumber daya MCP

Server MCP dapat mengekspos sumber daya yang dapat Anda referensikan menggunakan @ mentions, mirip dengan cara Anda mereferensikan file.

​

Referensikan sumber daya MCP

> Bisakah Anda menganalisis @github:issue://123 dan menyarankan perbaikan?

> Tolong tinjau dokumentasi API di @docs:file://api/authentication

> Bandingkan @postgres:schema://users dengan @docs:file://database/user-model

​

Gunakan prompt MCP sebagai perintah slash

Server MCP dapat mengekspos prompt yang menjadi tersedia sebagai perintah slash di Claude Code.

​

Eksekusi prompt MCP

> /mcp__github__list_prs

> /mcp__github__pr_review 456

> /mcp__jira__create_issue "Bug in login flow" high