Langsung ke konten utama
Claude Code dapat terhubung ke ratusan alat eksternal dan sumber data melalui Model Context Protocol (MCP), standar sumber terbuka untuk integrasi AI-alat. Server MCP memberikan Claude Code akses ke alat, basis data, dan API Anda.

​
Apa yang dapat Anda lakukan dengan MCP

Dengan server MCP yang terhubung, Anda dapat meminta Claude Code untuk:
  • Menerapkan 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 basis data: “Temukan email 10 pengguna acak yang menggunakan fitur ENG-4521, berdasarkan basis data Postgres kami.”
  • Mengintegrasikan desain: “Perbarui template email standar kami berdasarkan desain Figma baru yang diposting di Slack”
  • Mengotomatisasi alur kerja: “Buat draf Gmail 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:
Gunakan server MCP pihak ketiga dengan risiko Anda sendiri - Anthropic belum memverifikasi kebenaran atau keamanan semua server ini. Pastikan Anda mempercayai server MCP yang Anda instal. Berhati-hatilah terutama saat menggunakan server MCP yang dapat mengambil konten yang tidak dipercaya, karena ini dapat mengekspos Anda ke risiko injeksi prompt.
Membutuhkan integrasi spesifik? Temukan ratusan server MCP lainnya di GitHub, atau buat server Anda sendiri menggunakan MCP SDK.

​
Menginstal server MCP

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

​
Opsi 1: Tambahkan server HTTP jarak jauh

Server HTTP adalah opsi yang direkomendasikan untuk terhubung ke server MCP jarak jauh. Ini adalah transport yang paling banyak didukung untuk layanan berbasis cloud. 
# 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"

​
Opsi 2: Tambahkan server SSE jarak jauh

Transport SSE (Server-Sent Events) sudah usang. Gunakan server HTTP sebagai gantinya, jika tersedia.
# Sintaks dasar
claude mcp add --transport sse <name> <url>

# Contoh nyata: Hubungkan ke Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

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

​
Opsi 3: 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 --transport stdio <name> <command> [args...]

# Contoh nyata: Tambahkan server Airtable
claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server
Memahami parameter ”—”: -- (garis miring ganda) memisahkan flag CLI Claude sendiri dari perintah dan argumen yang diteruskan ke server MCP. Semuanya sebelum -- adalah opsi untuk Claude (seperti --env, --scope), dan semuanya setelah -- adalah perintah sebenarnya untuk menjalankan server MCP.Sebagai contoh:
  • claude mcp add --transport stdio myserver -- npx server → menjalankan npx server
  • claude mcp add --transport stdio myserver --env KEY=value -- python server.py --port 8080 → menjalankan python server.py --port 8080 dengan KEY=value di lingkungan
Ini mencegah konflik antara flag Claude dan flag server.

​
Mengelola server Anda

Setelah dikonfigurasi, Anda dapat mengelola server MCP Anda dengan perintah berikut: 
# 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
Tips:
  • Gunakan flag --scope untuk menentukan di mana konfigurasi disimpan:
    • local (default): Tersedia hanya untuk Anda di proyek saat ini (disebut project di versi yang lebih lama)
    • project: Dibagikan dengan semua orang di proyek melalui file .mcp.json
    • user: Tersedia untuk Anda di semua proyek (disebut global di versi yang lebih lama)
  • Atur variabel lingkungan dengan flag --env (misalnya, --env KEY=value)
  • Konfigurasikan waktu tunggu startup server MCP menggunakan variabel lingkungan MCP_TIMEOUT (misalnya, MCP_TIMEOUT=10000 claude menetapkan waktu tunggu 10 detik)
  • Claude Code akan menampilkan peringatan ketika output alat MCP melebihi 10.000 token. Untuk meningkatkan batas ini, atur variabel lingkungan MAX_MCP_OUTPUT_TOKENS (misalnya, MAX_MCP_OUTPUT_TOKENS=50000)
  • Gunakan /mcp untuk autentikasi dengan server jarak jauh yang memerlukan autentikasi OAuth 2.0
Pengguna Windows: Pada Windows asli (bukan WSL), server MCP lokal yang menggunakan npx memerlukan pembungkus cmd /c untuk memastikan eksekusi yang tepat.
# Ini membuat command="cmd" yang dapat dieksekusi Windows
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package
Tanpa pembungkus cmd /c, Anda akan mengalami kesalahan “Connection closed” karena Windows tidak dapat langsung mengeksekusi npx. (Lihat catatan di atas untuk penjelasan parameter --.)

​
Server MCP yang disediakan plugin

Plugin dapat menggabungkan server MCP, secara otomatis menyediakan alat dan integrasi ketika plugin diaktifkan. Server MCP plugin bekerja identik dengan server yang dikonfigurasi pengguna. Cara kerja server MCP plugin:
  • Plugin menentukan server MCP di .mcp.json di akar plugin atau inline di plugin.json
  • Ketika plugin diaktifkan, server MCP-nya dimulai secara otomatis
  • Alat MCP plugin muncul bersama alat MCP yang dikonfigurasi secara manual
  • Server plugin dikelola melalui instalasi plugin (bukan perintah /mcp)
Contoh konfigurasi MCP plugin: Di .mcp.json di akar plugin: 
{
  "database-tools": {
    "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
    "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
    "env": {
      "DB_URL": "${DB_URL}"
    }
  }
}
Atau inline di plugin.json: 
{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
      "args": ["--port", "8080"]
    }
  }
}
Fitur MCP plugin:
  • Siklus hidup otomatis: Server dimulai ketika plugin diaktifkan, tetapi Anda harus memulai ulang Claude Code untuk menerapkan perubahan server MCP (mengaktifkan atau menonaktifkan)
  • Variabel lingkungan: Gunakan ${CLAUDE_PLUGIN_ROOT} untuk jalur relatif plugin
  • Akses lingkungan pengguna: Akses ke variabel lingkungan yang sama dengan server yang dikonfigurasi secara manual
  • Beberapa jenis transport: Dukungan transport stdio, SSE, dan HTTP (dukungan transport mungkin berbeda menurut server)
Melihat server MCP plugin: 
# Dalam Claude Code, lihat semua server MCP termasuk yang dari plugin
/mcp
Server plugin muncul dalam daftar dengan indikator yang menunjukkan mereka berasal dari plugin. Manfaat server MCP plugin:
  • Distribusi bundel: Alat dan server dikemas bersama
  • Pengaturan otomatis: Tidak perlu konfigurasi MCP manual
  • Konsistensi tim: Semua orang mendapatkan alat yang sama ketika plugin diinstal
Lihat referensi komponen plugin untuk detail tentang penggabungan server MCP dengan plugin.

​
Cakupan instalasi MCP

Server MCP dapat dikonfigurasi pada tiga tingkat cakupan berbeda, masing-masing melayani tujuan yang berbeda untuk mengelola aksesibilitas dan berbagi server. Memahami cakupan ini membantu Anda menentukan cara terbaik untuk mengonfigurasi server sesuai 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 --transport http stripe https://mcp.stripe.com

# Tentukan cakupan lokal secara eksplisit
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

​
Cakupan proyek

Server dengan cakupan proyek memungkinkan kolaborasi tim dengan menyimpan konfigurasi dalam file .mcp.json di direktori akar proyek Anda. File ini dirancang untuk diperiksa 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 --transport http paypal --scope project https://mcp.paypal.com/mcp
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 mengatur ulang pilihan persetujuan ini, gunakan perintah claude mcp reset-project-choices.

​
Cakupan pengguna

Server dengan cakupan pengguna menyediakan aksesibilitas lintas proyek, menjadikannya 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 --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

​
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 berbagai 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 berbagai 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 jika diperlukan.

​
Ekspansi variabel lingkungan di .mcp.json

Claude Code mendukung ekspansi variabel lingkungan dalam file .mcp.json, memungkinkan tim untuk berbagi konfigurasi sambil mempertahankan fleksibilitas untuk jalur spesifik mesin dan nilai sensitif seperti kunci API. Sintaks yang didukung:
  • ${VAR} - Berkembang ke nilai variabel lingkungan VAR
  • ${VAR:-default} - Berkembang ke VAR jika diatur, jika tidak gunakan default
Lokasi ekspansi: Variabel lingkungan dapat berkembang di:
  • command - Jalur executable server
  • args - Argumen baris perintah
  • env - Variabel lingkungan yang diteruskan ke server
  • url - Untuk jenis server HTTP
  • headers - Untuk autentikasi server HTTP
Contoh dengan ekspansi variabel: 
{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "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: Pantau kesalahan dengan Sentry

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

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

# 3. Debug masalah produksi
> "What are the most common errors in the last 24 hours?"
> "Show me the stack trace for error ID abc123"
> "Which deployment introduced these new errors?"

​
Contoh: Hubungkan ke GitHub untuk tinjauan kode

# 1. Tambahkan server MCP GitHub
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# 2. Di Claude Code, autentikasi jika diperlukan
> /mcp
# Pilih "Authenticate" untuk GitHub

# 3. Sekarang Anda dapat meminta Claude untuk bekerja dengan GitHub
> "Review PR #456 and suggest improvements"
> "Create a new issue for the bug we just found"
> "Show me all open PRs assigned to me"

​
Contoh: Tanyakan basis data PostgreSQL Anda

# 1. Tambahkan server basis data dengan string koneksi Anda
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:[email protected]:5432/analytics"

# 2. Tanyakan basis data Anda secara alami
> "What's our total revenue this month?"
> "Show me the schema for the orders table"
> "Find customers who haven't made a purchase in 90 days"

​
Autentikasi dengan server MCP jarak jauh

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

Tambahkan server yang memerlukan autentikasi

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

Gunakan perintah /mcp dalam Claude Code

Di Claude Code, gunakan perintah:
> /mcp
Kemudian ikuti langkah-langkah di browser Anda untuk login.
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 server HTTP

​
Tambahkan server MCP dari konfigurasi JSON

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

Tambahkan server MCP dari JSON

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

# Contoh: Menambahkan server HTTP dengan konfigurasi JSON
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# Contoh: Menambahkan server stdio dengan konfigurasi JSON
claude mcp add-json local-weather '{"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 diloloskan dengan benar di shell Anda
  • JSON harus sesuai dengan skema konfigurasi server MCP
  • Anda dapat menggunakan --scope user untuk menambahkan server ke konfigurasi pengguna Anda alih-alih yang khusus proyek

​
Impor server MCP dari Claude Desktop

Jika Anda telah mengonfigurasi server MCP di Claude Desktop, Anda dapat mengimpornya:
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 --scope user untuk menambahkan server ke konfigurasi pengguna Anda
  • Server yang diimpor akan memiliki nama yang sama seperti di Claude Desktop
  • Jika server dengan nama yang sama sudah ada, mereka akan mendapatkan akhiran numerik (misalnya, server_1)

​
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": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}
Mengonfigurasi jalur executable: Bidang command harus mereferensikan executable Claude Code. Jika perintah claude tidak ada di PATH sistem Anda, Anda perlu menentukan jalur lengkap ke executable.Untuk menemukan jalur lengkap:
which claude
Kemudian gunakan jalur lengkap dalam konfigurasi Anda:
{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "/full/path/to/claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}
Tanpa jalur executable yang benar, Anda akan mengalami kesalahan seperti spawn claude ENOENT.
Tips:
  • Server menyediakan akses ke alat Claude seperti View, Edit, LS, dll.
  • Di Claude Desktop, coba minta Claude untuk membaca file di 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.

​
Batas output MCP dan peringatan

Ketika alat MCP menghasilkan output besar, Claude Code membantu mengelola penggunaan token untuk mencegah membanjiri konteks percakapan Anda:
  • Ambang peringatan output: Claude Code menampilkan peringatan ketika output alat MCP apa pun melebihi 10.000 token
  • Batas yang dapat dikonfigurasi: Anda dapat menyesuaikan token output MCP maksimum yang diizinkan menggunakan variabel lingkungan MAX_MCP_OUTPUT_TOKENS
  • Batas default: Maksimum default adalah 25.000 token
Untuk meningkatkan batas untuk alat yang menghasilkan output besar: 
# Atur batas yang lebih tinggi untuk output alat MCP
export MAX_MCP_OUTPUT_TOKENS=50000
claude
Ini sangat berguna saat bekerja dengan server MCP yang:
  • Menanyakan dataset atau basis data besar
  • Menghasilkan laporan atau dokumentasi terperinci
  • Memproses file log atau informasi debugging yang luas
Jika Anda sering mengalami peringatan output dengan server MCP tertentu, pertimbangkan untuk meningkatkan batas atau mengonfigurasi server untuk membuat halaman atau memfilter responsnya.

​
Gunakan sumber daya MCP

Server MCP dapat mengekspos sumber daya yang dapat Anda referensikan menggunakan penyebutan @, 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 pelengkapan otomatis.
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 ketika direferensikan
  • Jalur sumber daya dapat dicari fuzzy dalam pelengkapan otomatis penyebutan @
  • Claude Code secara otomatis menyediakan alat untuk membuat daftar 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 garis miring

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

​
Jalankan 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

Jalankan prompt tanpa argumen

> /mcp__github__list_prs
3

Jalankan prompt dengan argumen

Banyak prompt menerima argumen. Teruskan mereka terpisah 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 diurai berdasarkan parameter yang ditentukan prompt
  • Hasil prompt disuntikkan langsung ke dalam percakapan
  • Nama server dan prompt dinormalisasi (spasi menjadi garis bawah)

​
Konfigurasi MCP perusahaan

Untuk organisasi yang memerlukan kontrol terpusat atas server MCP, Claude Code mendukung konfigurasi MCP yang dikelola perusahaan. Ini memungkinkan administrator IT untuk:
  • Mengontrol server MCP mana yang dapat diakses karyawan: Terapkan set server MCP yang disetujui standar di seluruh organisasi
  • Mencegah server MCP yang tidak sah: Secara opsional batasi pengguna dari menambahkan server MCP mereka sendiri
  • Nonaktifkan MCP sepenuhnya: Hapus fungsionalitas MCP sepenuhnya jika diperlukan

​
Menyiapkan konfigurasi MCP perusahaan

Administrator sistem dapat menerapkan file konfigurasi MCP perusahaan bersama file pengaturan yang dikelola:
  • macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
  • Windows: C:\ProgramData\ClaudeCode\managed-mcp.json
  • Linux: /etc/claude-code/managed-mcp.json
File managed-mcp.json menggunakan format yang sama dengan file .mcp.json standar: 
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    },
    "company-internal": {
      "type": "stdio",
      "command": "/usr/local/bin/company-mcp-server",
      "args": ["--config", "/etc/company/mcp-config.json"],
      "env": {
        "COMPANY_API_URL": "https://internal.company.com"
      }
    }
  }
}

​
Membatasi server MCP dengan daftar putih dan daftar hitam

Selain menyediakan server yang dikelola perusahaan, administrator dapat mengontrol server MCP mana yang diizinkan pengguna untuk dikonfigurasi menggunakan allowedMcpServers dan deniedMcpServers dalam file managed-settings.json:
  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Windows: C:\ProgramData\ClaudeCode\managed-settings.json
  • Linux: /etc/claude-code/managed-settings.json
{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverName": "sentry" },
    { "serverName": "company-internal" }
  ],
  "deniedMcpServers": [
    { "serverName": "filesystem" }
  ]
}
Perilaku daftar putih (allowedMcpServers):
  • undefined (default): Tidak ada pembatasan - pengguna dapat mengonfigurasi server MCP apa pun
  • Array kosong []: Penguncian lengkap - pengguna tidak dapat mengonfigurasi server MCP apa pun
  • Daftar nama server: Pengguna hanya dapat mengonfigurasi server yang ditentukan
Perilaku daftar hitam (deniedMcpServers):
  • undefined (default): Tidak ada server yang diblokir
  • Array kosong []: Tidak ada server yang diblokir
  • Daftar nama server: Server yang ditentukan secara eksplisit diblokir di semua cakupan
Catatan penting:
  • Pembatasan ini berlaku untuk semua cakupan: pengguna, proyek, lokal, dan bahkan server perusahaan dari managed-mcp.json
  • Daftar hitam memiliki prioritas mutlak: Jika server muncul di kedua daftar, itu akan diblokir
Prioritas konfigurasi perusahaan: Konfigurasi MCP perusahaan memiliki prioritas tertinggi dan tidak dapat ditimpa oleh konfigurasi pengguna, lokal, atau proyek.