Model Context Protocol (MCP) adalah protokol terbuka yang memungkinkan LLM mengakses alat eksternal dan sumber data. Untuk detail lebih lanjut tentang MCP, lihat dokumentasi MCP.

Gunakan server MCP pihak ketiga dengan risiko Anda sendiri. Pastikan Anda mempercayai server MCP tersebut, dan berhati-hatilah terutama saat menggunakan server MCP yang berkomunikasi dengan internet, karena ini dapat membuat Anda terpapar risiko injeksi prompt.

​
Konfigurasi server MCP

1

Tambahkan Server MCP stdio

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

# Contoh: Menambahkan server lokal
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2
2

Tambahkan Server MCP SSE

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

# Contoh: Menambahkan server SSE
claude mcp add --transport sse sse-server https://example.com/sse-endpoint

# Contoh: Menambahkan server SSE dengan header kustom
claude mcp add --transport sse api-server https://api.example.com/mcp -e X-API-Key=your-key
3

Tambahkan Server MCP HTTP

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

# Contoh: Menambahkan server HTTP yang dapat di-stream
claude mcp add --transport http http-server https://example.com/mcp

# Contoh: Menambahkan server HTTP dengan header autentikasi
claude mcp add --transport http secure-server https://api.example.com/mcp -e Authorization="Bearer your-token"
4

Kelola server MCP Anda

# Daftar semua server yang dikonfigurasi
claude mcp list

# Dapatkan detail untuk server tertentu
claude mcp get my-server

# Hapus server
claude mcp remove my-server

Tips:

  • Gunakan flag -s atau --scope untuk menentukan di mana konfigurasi disimpan:
    • local (default): Hanya tersedia untuk Anda di proyek saat ini (disebut project di versi lama)
    • project: Dibagikan dengan semua orang di proyek melalui file .mcp.json
    • user: Tersedia untuk Anda di semua proyek (disebut global di versi lama)
  • Atur variabel lingkungan dengan flag -e atau --env (misalnya, -e KEY=value)
  • Konfigurasi timeout startup server MCP menggunakan variabel lingkungan MCP_TIMEOUT (misalnya, MCP_TIMEOUT=10000 claude mengatur timeout 10 detik)
  • Periksa status server MCP kapan saja menggunakan perintah /mcp dalam Claude Code
  • MCP mengikuti arsitektur klien-server di mana Claude Code (klien) dapat terhubung ke beberapa server khusus
  • Claude Code mendukung SSE (Server-Sent Events) dan server HTTP yang dapat di-stream untuk komunikasi real-time
  • Gunakan /mcp untuk mengautentikasi dengan server jarak jauh yang memerlukan autentikasi OAuth 2.0

​
Memahami cakupan server 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 sesuai kebutuhan spesifik Anda.

​
Hierarki dan prioritas cakupan

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

​
Cakupan lokal

Server berlingkup 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 berlingkup lokal (default)
claude mcp add my-private-server /path/to/server

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

​
Cakupan proyek

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

# Tambahkan server berlingkup proyek
claude mcp add shared-server -s 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 berlingkup proyek dari file .mcp.json. Jika Anda perlu mereset pilihan persetujuan ini, gunakan perintah claude mcp reset-project-choices.

​
Cakupan pengguna

Server berlingkup 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 -s 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

​
Autentikasi dengan server MCP jarak jauh

Banyak server MCP jarak jauh memerlukan autentikasi. Claude Code mendukung alur autentikasi OAuth 2.0 untuk koneksi aman ke server ini.

1

Tambahkan server jarak jauh yang memerlukan autentikasi

# Tambahkan server SSE atau HTTP yang memerlukan OAuth
claude mcp add --transport sse github-server https://api.github.com/mcp
2

Autentikasi menggunakan perintah /mcp

Dalam Claude Code, gunakan perintah /mcp untuk mengelola autentikasi:

> /mcp

Ini membuka menu interaktif di mana Anda dapat:

  • Melihat status koneksi untuk semua server
  • Mengautentikasi dengan server yang memerlukan OAuth
  • Menghapus autentikasi yang ada
  • Melihat kemampuan server
3

Selesaikan alur OAuth

Ketika Anda memilih “Authenticate” untuk server:

  1. Browser Anda terbuka secara otomatis ke penyedia OAuth
  2. Selesaikan autentikasi di browser Anda
  3. Claude Code menerima dan menyimpan token akses dengan aman
  4. Koneksi server menjadi aktif

Tips:

  • Token autentikasi disimpan dengan aman dan disegarkan secara otomatis
  • Gunakan “Clear authentication” di menu /mcp untuk mencabut akses
  • Jika browser Anda tidak terbuka secara otomatis, salin URL yang disediakan
  • Autentikasi OAuth bekerja dengan transport SSE dan HTTP

​
Terhubung ke server MCP Postgres

Misalkan Anda ingin memberikan Claude akses baca-saja ke database PostgreSQL untuk query dan inspeksi skema.

1

Tambahkan server MCP Postgres

claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"
2

Query database Anda dengan Claude

> describe the schema of our users table

> what are the most recent orders in the system?

> show me the relationship between customers and invoices

Tips:

  • Server MCP Postgres menyediakan akses baca-saja untuk keamanan
  • Claude dapat membantu Anda menjelajahi struktur database dan menjalankan query analitis
  • Anda dapat menggunakan ini untuk dengan cepat memahami skema database dalam proyek yang tidak familiar
  • Pastikan string koneksi Anda menggunakan kredensial yang sesuai dengan izin minimum yang diperlukan

​
Tambahkan server MCP dari konfigurasi JSON

Misalkan Anda memiliki konfigurasi JSON untuk server MCP tunggal yang ingin Anda tambahkan ke Claude Code.

1

Tambahkan server MCP dari JSON

# 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"}}'
2

Verifikasi server telah ditambahkan

claude mcp get weather-api

Tips:

  • Pastikan JSON di-escape dengan benar di shell Anda
  • JSON harus sesuai dengan skema konfigurasi server MCP
  • Anda dapat menggunakan -s global untuk menambahkan server ke konfigurasi global Anda alih-alih yang khusus proyek

​
Impor server MCP dari Claude Desktop

Misalkan Anda telah mengkonfigurasi server MCP di Claude Desktop dan ingin menggunakan server yang sama di Claude Code tanpa mengkonfigurasi ulang secara manual.

1

Impor server dari Claude Desktop

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

Pilih server mana yang akan diimpor

Setelah menjalankan perintah, Anda akan melihat dialog interaktif yang memungkinkan Anda memilih server mana yang ingin diimpor.

3

Verifikasi server telah diimpor

claude mcp list

Tips:

  • Fitur ini hanya bekerja di macOS dan Windows Subsystem for Linux (WSL)
  • Ini membaca file konfigurasi Claude Desktop dari lokasi standarnya di platform tersebut
  • Gunakan flag -s global untuk menambahkan server ke konfigurasi global Anda
  • Server yang diimpor akan memiliki nama yang sama seperti di Claude Desktop
  • Jika server dengan nama yang sama sudah ada, mereka akan mendapat akhiran numerik (misalnya, server_1)

​
Gunakan Claude Code sebagai server MCP

Misalkan Anda ingin menggunakan Claude Code itu sendiri sebagai server MCP yang dapat dihubungkan oleh aplikasi lain, memberikan mereka alat dan kemampuan Claude.

1

Mulai Claude sebagai server MCP

# Sintaks dasar
claude mcp serve
2

Terhubung dari aplikasi lain

Anda dapat terhubung ke server MCP Claude Code dari klien MCP mana pun, seperti Claude Desktop. Jika Anda menggunakan Claude Desktop, Anda dapat menambahkan server MCP Claude Code menggunakan konfigurasi ini:

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

Tips:

  • Server menyediakan akses ke alat Claude seperti View, Edit, LS, dll.
  • Di Claude Desktop, coba minta Claude untuk membaca file dalam direktori, membuat edit, dan lainnya.
  • Perhatikan bahwa server MCP ini hanya mengekspos alat Claude Code ke klien MCP Anda, jadi klien Anda sendiri bertanggung jawab untuk mengimplementasikan konfirmasi pengguna untuk panggilan alat individual.

​
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

1

Daftar sumber daya yang tersedia

Ketik @ dalam prompt Anda untuk melihat sumber daya yang tersedia dari semua server MCP yang terhubung. Sumber daya muncul bersama file dalam menu autocomplete.

2

Referensikan sumber daya tertentu

Gunakan format @server:protocol://resource/path untuk mereferensikan sumber daya:

> Can you analyze @github:issue://123 and suggest a fix?

> Please review the API documentation at @docs:file://api/authentication
3

Referensi sumber daya ganda

Anda dapat mereferensikan beberapa sumber daya dalam satu prompt:

> Compare @postgres:schema://users with @docs:file://database/user-model

Tips:

  • Sumber daya secara otomatis diambil dan disertakan sebagai lampiran saat direferensikan
  • Path sumber daya dapat dicari secara fuzzy dalam autocomplete @ mention
  • Claude Code secara otomatis menyediakan alat untuk mendaftar dan membaca sumber daya MCP ketika server mendukungnya
  • Sumber daya dapat berisi jenis konten apa pun yang disediakan server MCP (teks, JSON, data terstruktur, dll.)

​
Gunakan prompt MCP sebagai perintah slash

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

​
Eksekusi prompt MCP

1

Temukan prompt yang tersedia

Ketik / untuk melihat semua perintah yang tersedia, termasuk yang dari server MCP. Prompt MCP muncul dengan format /mcp__servername__promptname.

2

Eksekusi prompt tanpa argumen

> /mcp__github__list_prs
3

Eksekusi prompt dengan argumen

Banyak prompt menerima argumen. Berikan mereka dipisahkan spasi setelah perintah:

> /mcp__github__pr_review 456

> /mcp__jira__create_issue "Bug in login flow" high

Tips:

  • Prompt MCP ditemukan secara dinamis dari server yang terhubung
  • Argumen diparse berdasarkan parameter yang didefinisikan prompt
  • Hasil prompt disuntikkan langsung ke dalam percakapan
  • Nama server dan prompt dinormalisasi (spasi menjadi garis bawah)