Controllare l'accesso ai server MCP per la vostra organizzazione

• 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 MCP interamente

{
  "mcpServers": {}
}

​

Consentire i connettori di claude.ai insieme al set gestito

​

Controllo basato su politica con allowlist e denylist

​

Abbinare i server per URL, comando o nome

• In deniedMcpServers, serverName accetta qualsiasi stringa non vuota, quindi potete bloccare i connettori claude.ai per il loro nome visualizzato. Ad esempio, { "serverName": "claude.ai Slack" } blocca il connettore Slack. Preferite una voce serverUrl quando avete bisogno che il blocco sia robusto rispetto ai cambi di nome, o quando un nome di connettore collide e guadagna un suffisso (N).
• In allowedMcpServers, serverName è limitato a lettere, numeri, trattini e sottolineature. Utilizzate serverUrl per aggiungere un connettore claude.ai all’allowlist.

​

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"].
• I valori serverCommand e serverUrl si espandono prima della corrispondenza. Sia la voce di politica che il valore configurato del server passano attraverso la stessa espansione ${VAR} e ${VAR:-default} di .mcp.json, quindi una voce scritta come ["${HOME}/bin/server"] corrisponde a una configurazione di server che utilizza sia lo stesso riferimento che il percorso espanso. Su Windows, fate riferimento a una variabile di ambiente impostata lì, come ${USERPROFILE} invece di ${HOME}. I valori serverName corrispondono letteralmente e non si espandono mai.
• 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