Controllare l'accesso ai server MCP per la vostra organizzazione

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

• Scegliere un modello che corrisponda al livello di controllo di cui avete bisogno
• Distribuire un set di server fisso con managed-mcp.json, incluso come disabilitare completamente MCP
• Controllare i server con allowlist e denylist
• Comunicare agli utenti cosa aspettarsi quando una restrizione blocca un server
• Monitorare quali server la vostra organizzazione utilizza effettivamente

​

Scegliere un modello

​

Controllo esclusivo con managed-mcp.json

• allowedMcpServers e deniedMcpServers si applicano anche ai server gestiti, quindi un server gestito che non li supera non verrà caricato.
• Il proprio deniedMcpServers di un utente si unisce dalle sue impostazioni, quindi gli utenti possono bloccare un server gestito per se stessi.

{
  "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"
      }
    }
  }
}

​

Autenticarsi con credenziali per utente

• Espansione ${VAR} per leggere i segreti dall’ambiente di ogni utente.
• OAuth o intestazioni per utente in modo che ogni utente si autentichi come se stesso.
• headersHelper per generare credenziali al momento della connessione.

​

Convalidare la configurazione

1. claude mcp list mostra solo i server in managed-mcp.json. Se i server personali di un utente appaiono ancora, il file non viene letto; controllate il percorso e i permessi.
2. claude mcp add --transport http test https://example.com/mcp fallisce con Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers. L’URL non deve essere un server reale, poiché il controllo della politica rifiuta il comando prima che qualsiasi cosa venga contattata.

​

Disabilitare completamente MCP

{
  "mcpServers": {}
}

​

Controllo basato su politica con allowlist e denylist

​

Abbinare i server per URL, comando o nome

​

Come viene valutato un server

1. Unire gli elenchi. Le voci di allowlist e denylist da ogni fonte di impostazioni si combinano in un allowlist e una denylist. Quando allowManagedMcpServersOnly è true, viene mantenuto solo l’allowlist gestito; la denylist si unisce sempre da ogni fonte.
2. Controllare la denylist. Un server che corrisponde a qualsiasi voce di denylist, per URL, comando o nome, viene bloccato. Nulla sostituisce una corrispondenza di denylist.
3. Controllare l’allowlist. Se allowedMcpServers non è impostato da nessuna parte, ogni server che ha superato la denylist viene caricato. Se è impostato, ciò a cui il server deve corrispondere dipende dal suo tipo, mostrato nella tabella di seguito.

• I comandi corrispondono esattamente. Ogni argomento, in ordine. ["npx", "-y", "server"] non corrisponde a ["npx", "server"] o ["npx", "-y", "server", "--flag"].
• Gli URL supportano caratteri jolly * ovunque nel modello, incluso lo schema. La corrispondenza del nome host non distingue tra maiuscole e minuscole e ignora un punto FQDN finale, quindi https://Mcp.Example.com/* corrisponde a https://mcp.example.com/api. I percorsi rimangono sensibili alle maiuscole.

​

Configurazione di esempio

{
  "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/*" }
  ]
}

• Riga 3: la prima voce serverUrl. Una volta che ne esiste una, ogni server remoto deve corrispondere a un modello di URL, quindi un utente non può ottenere un server remoto non elencato dandogli un nome consentito.
• Riga 5: la prima voce serverCommand. Lo stesso effetto per i server stdio, quindi ogni server locale deve corrispondere esattamente a un comando elencato.
• Riga 11: una voce serverName nella denylist. Le voci di denylist si applicano sempre, quindi qualsiasi server denominato dangerous-server viene bloccato indipendentemente dal suo URL o comando.

{
  "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/*" }
  ]
}

​

Limitare l’allowlist solo alle impostazioni gestite

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

​

Come le restrizioni appaiono agli utenti

​

Monitorare l’utilizzo di MCP

​

Riepilogo della configurazione

​

Risorse correlate

• Decidere cosa applicare: restrizioni MCP insieme alle regole di autorizzazione, sandboxing e agli altri controlli di amministrazione
• Connettere Claude Code agli strumenti tramite MCP: il riferimento MCP completo, inclusi trasporti, ambiti e autenticazione
• Impostazioni: la gerarchia delle impostazioni e come le impostazioni gestite hanno la precedenza
• Impostazioni gestite dal server: consegnare allowedMcpServers e deniedMcpServers dalla console di amministrazione di Claude.ai
• Sicurezza: il modello di minaccia che questi controlli difendono
• Guida dell’amministratore Claude Enterprise: SSO, SCIM, gestione dei posti e playbook di implementazione