Kontrol akses server MCP untuk organisasi Anda

• Pilih pola yang sesuai dengan seberapa banyak kontrol yang Anda butuhkan
• Terapkan set server tetap dengan managed-mcp.json, termasuk cara menonaktifkan MCP sepenuhnya
• Sediakan server melalui pengaturan yang dikelola sementara pengguna menyimpan milik mereka sendiri
• Kontrol server dengan daftar izin dan daftar penolakan
• Beri tahu pengguna apa yang diharapkan ketika pembatasan memblokir server
• Pantau server mana yang benar-benar digunakan organisasi Anda

​

Pilih pola

​

Kontrol eksklusif dengan managed-mcp.json

• Server yang didefinisikan file
• Server yang Anda sediakan melalui managedMcpServers
• Server dalam proses yang aplikasi yang memulai sesi mendaftarkan, seperti server Claude Code sendiri dari ekstensi VS Code atau konektor yang dikirimkan aplikasi desktop
• Server Claude in Chrome bawaan, jika Anda mengizinkannya bersama set yang dikelola

​

Terapkan managed-mcp.json

{
  "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.example.com"
      }
    }
  }
}

​

Autentikasi dengan kredensial per pengguna

• Ekspansi ${VAR} untuk membaca rahasia dari lingkungan setiap pengguna.
• OAuth atau header per pengguna sehingga setiap pengguna mengautentikasi sebagai diri mereka sendiri.
• headersHelper untuk menghasilkan kredensial pada waktu koneksi.

​

Server yang diteruskan dengan --mcp-config atau --strict-mcp-config

• Di workstation, Claude Code keluar saat startup dengan You cannot dynamically configure MCP servers when an enterprise MCP config is present.
• Dalam sesi cloud di host tempat file diterapkan, seperti runner yang di-host sendiri, Claude Code dimulai dengan server yang dikelola saja dan melewati konektor claude.ai dan server lainnya yang host cloud kirimkan melalui --mcp-config. Tidak ada dalam sesi yang memberi tahu pengguna server mana yang ditinggalkan. Claude Code menamakannya dalam peringatan di stderr-nya, yang runner yang di-host sendiri catat pada tingkat log debug.

​

Bagaimana allowlist dan denylist berlaku untuk set yang dikelola

• deniedMcpServers berlaku untuk server yang dikelola juga, jadi server yang dikelola yang cocok dengan entri tidak akan dimuat.
• deniedMcpServers pengguna sendiri bergabung dari pengaturan mereka, jadi pengguna dapat memblokir server yang dikelola untuk diri mereka sendiri.

​

Validasi konfigurasi

1. claude mcp list menampilkan hanya server di managed-mcp.json, ditambah yang Anda sediakan melalui managedMcpServers. Dua hasil lainnya berarti ada yang salah:
   • Jika server pengguna sendiri masih muncul, Claude Code tidak membaca file, jadi periksa jalurnya dan izin pada direktori induknya.
   • Jika server file tidak muncul dan bagian MCP config diagnostics menandai konfigurasi perusahaan sebagai gagal diurai, Claude Code tidak dapat membaca atau mengurai file. Perbaiki kesalahan yang bagian itu namai, kemudian minta pengguna untuk memulai ulang Claude Code.
2. claude mcp add --transport http test https://example.com/mcp gagal dengan Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers. URL tidak perlu menjadi server nyata, karena pemeriksaan kebijakan menolak perintah sebelum apa pun dihubungi.

​

Nonaktifkan MCP sepenuhnya

{
  "mcpServers": {}
}

​

Izinkan konektor claude.ai bersama set yang dikelola

​

Izinkan Claude in Chrome bersama set yang dikelola

​

Sediakan server melalui pengaturan terkelola

{
  "managedMcpServers": {
    "search": {
      "type": "http",
      "url": "https://search.example.com/mcp"
    },
    "records": {
      "type": "http",
      "url": "https://records.example.com/mcp",
      "headers": {
        "X-Records-Key": "key-issued-for-all-claude-code-users"
      }
    }
  }
}

​

Apa yang dapat dimuat entri

• type adalah http atau sse. Seperti dalam .mcp.json, streamable-http diterima sebagai alias untuk http.
• url adalah URL https://. Claude Code menolak URL http:// biasa, termasuk yang menunjuk ke localhost.
• Entri tidak memiliki anggota command, args, env, atau headersHelper, jadi dokumen pengaturan terkelola tidak pernah menyebutkan program untuk dijalankan di mesin pengguna.
• Tidak ada nilai yang berisi referensi ${VAR}. Claude Code tidak memperluas variabel lingkungan dalam entri ini, jadi tulis nilai literal.
• Nama server hanya berisi huruf, angka, tanda hubung, dan garis bawah, dan tidak ada kunci atau nilai yang berisi karakter kontrol atau pemformatan yang tidak terlihat.

​

Bagaimana server yang disediakan dimuat

• Server yang disediakan memiliki prioritas atas server dengan nama yang sama dalam cakupan lokal, proyek, atau pengguna, dan atas server plugin atau konektor claude.ai yang menunjuk ke URL yang sama.
• Jika Anda juga menerapkan managed-mcp.json, Claude Code memuat server dan server yang disediakan bersama-sama, dan entri file memiliki prioritas ketika keduanya mendefinisikan nama.
• Server yang disediakan terus dimuat ketika strictPluginOnlyCustomization mengunci permukaan mcp.
• deniedMcpServers berlaku untuk server yang disediakan, termasuk entri dari pengaturan pengguna mereka sendiri, jadi pengguna dapat memblokir satu untuk diri mereka sendiri. Server yang disediakan tidak memerlukan entri allowedMcpServers.

• Server yang diteruskan pengguna dengan --mcp-config dengan nama yang sama menggantikan yang disediakan untuk run itu dan diperiksa terhadap allowedMcpServers.
• --strict-mcp-config meninggalkan server yang disediakan bersama dengan setiap server yang dikonfigurasi lainnya.

​

Apa yang dapat dilihat dan diubah pengguna

• claude mcp remove melaporkan bahwa server disediakan oleh organisasi.
• Ketika Anda belum menerapkan managed-mcp.json, entri yang ditambahkan pengguna dengan nama yang sama disimpan tetapi tidak digunakan saat server Anda ada.
• Pengguna masih dapat mematikan server yang disediakan untuk diri mereka sendiri di /mcp, yang mencantumkan server yang disediakan di bawah Managed MCPs.

​

Di mana managedMcpServers berlaku

​

Ketika server yang disediakan terhubung

• Pada mesin dengan pengaturan cache, Claude Code menahan salinan cache kunci ini sampai server mengonfirmasi pengaturan untuk sesi, dan menunggu konfirmasi itu sebelum memuat server MCP. Jika konfirmasi gagal, sesi berlanjut tanpa server yang disediakan dan /status mengatakan mereka ditahan.
• Pada peluncuran pertama mesin, tanpa apa pun yang di-cache, sesi interaktif yang dimulai sebelum pengaturan tiba menghubungkan server yang disediakan segera setelah mereka tiba, dan run claude -p yang sudah dimulai dapat selesai tanpanya.

• Tambahkan server: Claude Code menghubungkannya ketika pengaturan yang diperbarui tiba, tanpa restart.
• Ubah entri server: sesi tersebut terhubung kembali dengannya dengan definisi baru.
• Hapus server: sesi interaktif yang sedang berjalan memutusnya setelah membaca pengaturan yang berubah. Run non-interaktif (-p) menyimpannya sampai berakhir.

​

Kontrol berbasis kebijakan dengan allowlist dan denylist

​

Cocokkan server berdasarkan URL, perintah, atau nama

• Di deniedMcpServers, serverName menerima string apa pun yang tidak kosong tanpa spasi di awal atau akhir, jadi Anda dapat memblokir konektor claude.ai berdasarkan nama tampilan mereka. Misalnya, { "serverName": "claude.ai Slack" } memblokir konektor Slack. Lebih suka entri serverUrl ketika Anda memerlukan penolakan yang kuat terhadap penggantian nama, atau ketika nama konektor bertabrakan dan mendapatkan akhiran (N).
• Di allowedMcpServers, serverName terbatas pada huruf, angka, tanda hubung, dan garis bawah. Gunakan serverUrl untuk allowlist konektor claude.ai yang Claude Code ambil sendiri; untuk konektor yang host cloud berikan ke sesi yang di-host sendiri, gunakan entri yang tercantum di bawah Lalu lintas konektor meninggalkan jaringan Anda sebagai gantinya.

​

Bagaimana server dievaluasi

1. Gabungkan daftarnya. Entri allowlist dan denylist dari setiap cakupan pengaturan bergabung menjadi satu allowlist dan satu denylist. Ketika allowManagedMcpServersOnly adalah true, hanya allowlist terkelola yang disimpan; denylist selalu bergabung dari setiap cakupan. Ketika lebih dari satu sumber terkelola ada, Kunci dibaca dari setiap sumber admin mengatakan yang mana dari mereka yang memasok daftar cakupan terkelola.
2. Periksa denylist. Server yang cocok dengan entri denylist apa pun, berdasarkan URL, perintah, atau nama, diblokir. Tidak ada yang menggantikan kecocokan denylist.
3. Periksa allowlist. Jika allowedMcpServers tidak diatur di mana pun, setiap server yang melewati denylist dimuat. Jika diatur, apa yang harus cocok dengan server tergantung pada jenisnya, ditampilkan dalam tabel di bawah. Tiga kelompok server melewati pemeriksaan ini:
   • Server organisasi sendiri: setiap entri managedMcpServers, dan entri managed-mcp.json apa pun yang nilainya tidak menggunakan ekspansi ${VAR}.
   • Server bawaan, seperti Claude di Chrome, server ide yang Claude Code sambungkan ke IDE VS Code atau JetBrains yang sedang berjalan, dan server yang CLI sendiri konfigurasi.
   • Alat Slack sesi Claude Tag: server yang digunakan untuk membaca thread dan memposting balasannya dimuat tanpa entri allowlist.
   Server managed-mcp.json yang menggunakan ekspansi ${VAR} dalam perintah, argumen, env, URL, atau header masih diperiksa. Begitu juga setiap server yang ditambahkan pengguna, plugin, atau claude.ai, dan setiap server yang dilewatkan pengguna dengan --mcp-config.

• Perintah cocok dengan tepat. Setiap argumen, secara berurutan. ["npx", "-y", "server"] tidak cocok dengan ["npx", "server"] atau ["npx", "-y", "server", "--flag"].
• Nilai serverCommand dan serverUrl diperluas sebelum pencocokan. Baik entri kebijakan maupun nilai yang dikonfigurasi server melalui ekspansi ${VAR} dan ${VAR:-default}, jadi entri yang ditulis sebagai ["${HOME}/bin/server"] cocok dengan konfigurasi server yang menggunakan referensi yang sama atau jalur yang diperluas. Di Windows, referensikan variabel lingkungan yang diatur di sana, seperti ${USERPROFILE} bukan ${HOME}. Nilai serverName cocok secara harfiah dan tidak pernah diperluas. Kedua belah pihak membaca lingkungan yang berbeda; Bagaimana entri kebijakan diperluas mencakup yang mana, dan bagaimana entri allowlist dan denylist berbeda.
• URL mendukung wildcard * di mana pun dalam pola, termasuk skema. Pencocokan nama host tidak peka huruf besar-kecil dan mengabaikan titik FQDN yang tertinggal, jadi https://Mcp.Example.com/* cocok dengan https://mcp.example.com/api. Jalur tetap peka huruf besar-kecil.

​

Bagaimana entri kebijakan diperluas

​

Contoh konfigurasi

{
  "allowedMcpServers": [
    { "serverUrl": "https://api.githubcopilot.com/*" },
    { "serverUrl": "https://mcp.sentry.dev/*" },
    { "serverCommand": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "."] },
    { "serverCommand": ["python", "/usr/local/bin/approved-server.py"] },
    { "serverUrl": "https://mcp.example.com/*" },
    { "serverUrl": "https://*.internal.example.com/*" }
  ],
  "deniedMcpServers": [
    { "serverName": "dangerous-server" },
    { "serverCommand": ["npx", "-y", "unapproved-package"] },
    { "serverUrl": "https://*.untrusted.example.com/*" }
  ]
}

• Baris 3: entri serverUrl pertama. Setelah satu ada, setiap server jarak jauh harus cocok dengan pola URL, jadi pengguna tidak dapat mendapatkan server jarak jauh yang tidak terdaftar dengan memberikannya nama yang diizinkan.
• Baris 5: entri serverCommand pertama. Efek yang sama untuk server stdio, jadi setiap server lokal harus cocok dengan perintah yang terdaftar dengan tepat.
• Baris 11: entri serverName dalam denylist. Entri denylist selalu berlaku, jadi server apa pun yang bernama dangerous-server diblokir terlepas dari URL atau perintahnya.

{
  "allowedMcpServers": [
    { "serverUrl": "https://mcp.example.com/*" },
    { "serverUrl": "https://*.internal.example.com/*" }
  ]
}

{
  "allowedMcpServers": [
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverName": "internal-tool" }
  ]
}

{
  "allowedMcpServers": [
    { "serverUrl": "https://*.example.com/*" }
  ],
  "deniedMcpServers": [
    { "serverUrl": "https://staging.example.com/*" }
  ]
}

​

Batasi allowlist ke pengaturan terkelola saja

{
  "allowManagedMcpServersOnly": true,
  "allowedMcpServers": [
    { "serverUrl": "https://api.githubcopilot.com/*" },
    { "serverUrl": "https://*.internal.example.com/*" }
  ]
}

​

Bagaimana pembatasan muncul kepada pengguna

​

Pantau penggunaan MCP

​

Ringkasan konfigurasi

​

Sumber daya terkait

• Tentukan apa yang akan diterapkan: pembatasan MCP bersama dengan aturan izin, sandboxing, dan kontrol admin lainnya
• Hubungkan Claude Code ke alat melalui MCP: referensi MCP lengkap, termasuk transportasi, cakupan, dan autentikasi
• Pengaturan: hierarki pengaturan dan bagaimana pengaturan yang dikelola memiliki prioritas
• Pengaturan yang dikelola server: kirimkan allowedMcpServers dan deniedMcpServers dari konsol admin Claude.ai
• Keamanan: model ancaman yang dilindungi kontrol ini
• Panduan Administrator Perusahaan Claude: SSO, SCIM, manajemen kursi, dan playbook peluncuran