조직의 MCP 서버 액세스 제어

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.

• 필요한 제어 수준에 맞는 패턴 선택
• managed-mcp.json으로 고정 서버 집합 배포, MCP 완전히 비활성화 방법 포함
• 허용 목록 및 거부 목록으로 서버 제어
• 제한이 서버를 차단할 때 사용자에게 표시되는 내용 알리기
• 조직이 실제로 사용하는 서버 모니터링

​

패턴 선택

​

managed-mcp.json으로 독점 제어

• allowedMcpServers 및 deniedMcpServers는 관리형 서버에도 적용되므로, 이를 통과하지 못하는 관리형 서버는 로드되지 않습니다.
• 사용자의 자신의 deniedMcpServers는 설정에서 병합되므로, 사용자는 자신을 위해 관리형 서버를 차단할 수 있습니다.

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

​

사용자별 자격증명으로 인증

• ${VAR} 확장으로 각 사용자의 환경에서 비밀을 읽습니다.
• OAuth 또는 사용자별 헤더로 각 사용자가 자신으로 인증합니다.
• headersHelper로 연결 시간에 자격증명을 생성합니다.

​

구성 검증

1. claude mcp list는 managed-mcp.json의 서버만 표시합니다. 사용자의 자신의 서버가 여전히 나타나면, 파일이 읽혀지지 않습니다. 경로와 권한을 확인합니다.
2. claude mcp add --transport http test https://example.com/mcp는 Cannot add MCP server: enterprise MCP configuration is active and has exclusive control over MCP servers로 실패합니다. URL이 실제 서버일 필요는 없습니다. 정책 확인이 무엇이든 연결되기 전에 명령을 거부하기 때문입니다.

​

MCP 완전히 비활성화

{
  "mcpServers": {}
}

​

허용 목록 및 거부 목록으로 정책 기반 제어

​

URL, 명령 또는 이름으로 서버 일치

​

서버 평가 방법

1. 목록 병합. 모든 설정 소스의 허용 목록 및 거부 목록 항목이 하나의 허용 목록 및 하나의 거부 목록으로 결합됩니다. allowManagedMcpServersOnly가 true일 때, 관리형 허용 목록만 유지됩니다. 거부 목록은 항상 모든 소스에서 병합됩니다.
2. 거부 목록 확인. URL, 명령 또는 이름으로 거부 목록 항목과 일치하는 서버는 차단됩니다. 거부 목록 일치를 재정의하는 것은 없습니다.
3. 허용 목록 확인. allowedMcpServers가 어디서도 설정되지 않으면, 거부 목록을 통과한 모든 서버가 로드됩니다. 설정되면, 서버가 일치해야 하는 항목은 아래 표에 표시된 유형에 따라 다릅니다.

• 명령은 정확하게 일치합니다. 모든 인수, 순서대로. ["npx", "-y", "server"]는 ["npx", "server"] 또는 ["npx", "-y", "server", "--flag"]와 일치하지 않습니다.
• URL은 * 와일드카드를 지원합니다 패턴의 어디서나, 스키마 포함. 호스트명 일치는 대소문자를 구분하지 않으며 후행 FQDN 점을 무시하므로, https://Mcp.Example.com/*는 https://mcp.example.com/api와 일치합니다. 경로는 대소문자를 구분합니다.

​

예제 구성

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

• 3번 줄: 첫 번째 serverUrl 항목. 하나가 존재하면, 모든 원격 서버는 URL 패턴과 일치해야 하므로, 사용자는 허용된 이름을 제공하여 나열되지 않은 원격 서버를 얻을 수 없습니다.
• 5번 줄: 첫 번째 serverCommand 항목. stdio 서버에 대해 동일한 효과이므로, 모든 로컬 서버는 나열된 명령과 정확하게 일치해야 합니다.
• 11번 줄: 거부 목록의 serverName 항목. 거부 목록 항목은 항상 적용되므로, dangerous-server라는 모든 서버는 URL 또는 명령에 관계없이 차단됩니다.

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

​

허용 목록을 관리형 설정만으로 제한

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

​

제한이 사용자에게 표시되는 방식

​

MCP 사용 모니터링

​

구성 요약

​

관련 리소스

• 적용할 항목 결정: 권한 규칙, 샌드박싱 및 다른 관리 제어와 함께 MCP 제한
• MCP를 통해 Claude Code를 도구에 연결: 전송, 범위 및 인증을 포함한 전체 MCP 참조
• 설정: 설정 계층 구조 및 관리형 설정이 우선하는 방식
• 서버 관리 설정: Claude.ai 관리 콘솔에서 allowedMcpServers 및 deniedMcpServers 전달
• 보안: 이러한 제어가 방어하는 위협 모델
• Claude Enterprise Administrator Guide: SSO, SCIM, 시트 관리 및 롤아웃 플레이북