데스크톱 확장 허용 목록은 Team 및 Enterprise 플랜의 소유자와 주요 소유자가 사용할 수 있습니다.
이 문서에서는 Team 및 Enterprise 플랜 소유자가 조직의 확장 프로그램 접근을 관리하기 위해 사용할 수 있는 데스크톱 확장 허용 목록을 소개합니다.
허용 목록을 활성화하는 방법
중요: 이전에 사용자-머신 수준에서 Enterprise 정책 제어를 구성한 경우, 이는 앱 내 허용 목록을 재정의합니다. isDesktopExtensionDirectoryEnabled 및 isDesktopExtensionEnabled가 모두 "false"로 설정되지 않았는지 확인하여 허용 목록이 사용 가능한 레지스트리를 채울 수 있도록 하세요. 자세한 내용은 데스크톱 엔터프라이즈 구성 설명서를 참조하세요.
데스크톱 확장 허용 목록은 기본적으로 비활성화되어 있으므로 조직 소유자가 수동으로 활성화해야 합니다. 허용 목록을 활성화할 때까지 사용자는 레지스트리의 모든 데스크톱 확장에 접근할 수 있습니다. 이를 방지하려면 허용 목록을 활성화하여 모든 데스크톱 확장을 기본적으로 차단한 다음, 팀이 접근해야 하는 확장만 추가하세요.
허용 목록을 켜려면:
Claude Desktop 열기
왼쪽 아래 모서리의 이니셜 또는 이름 클릭
조직 설정 > 커넥터로 이동
"Desktop" 탭으로 전환:
허용 목록 토글 켜기:
허용 목록을 활성화한 후 어떻게 되나요?
허용 목록이 활성화되면:
기존의 모든 데스크톱 확장 설치가 Claude Desktop 클라이언트에서 강제 삭제됩니다.
사용자는 허용 목록에 포함되지 않은 새로운 데스크톱 확장을 더 이상 설치할 수 없습니다.
사용자는 승인된 앱 내 레지스트리에서만 확장을 다운로드할 수 있으며, 더 이상 드래그하거나 클릭하여 MCPB를 설치할 수 없습니다.
허용 목록은 설치 후 개인이 로컬 MCP 파일 내용을 변조하는 것을 방지하지 않습니다.
기존 사용자에 대한 중단을 최소화하기 위해 업무 시간 외에 허용 목록 설정을 완료하는 것을 고려하세요. 허용 목록이 구성되는 동안 사용자의 설치된 확장이 삭제되면, 사용자는 수동으로 확장을 다시 설치해야 합니다.
중요: 허용 목록에는 Claude Desktop 버전 0.13.91 이상이 필요하므로, 사용자는 "Claude"를 클릭한 다음 "업데이트 확인" 또는 "Claude 0.13.91로 업데이트하려면 다시 시작"을 클릭하여 데스크톱 앱을 업데이트해야 합니다:
허용된 확장 관리
허용 목록을 활성화한 후 어떤 확장을 허용할지 선택할 수 있습니다:
조직 설정 > 커넥터로 이동하고 "Desktop" 탭을 선택합니다.
"확장 찾아보기"를 클릭하여 사용 가능한 확장 목록을 봅니다.
추가하려는 확장을 선택합니다.
"팀에 추가" 버튼을 클릭합니다.
확장이 허용 목록에 나타납니다.
허용 목록에서 확장을 제거하려면 "..." 버튼을 클릭하고 "허용 목록에서 제거"를 선택합니다.
사용자 정의 확장 업로드
조직 설정 > 커넥터 > Desktop을 통해 조직 전체에 배포할 사용자 정의 확장을 업로드할 수도 있습니다.
참고: manifest.json의 name 필드가 기존 MCPB와 겹치지 않도록 하세요. 모든 고유한 MCPB / 데스크톱 확장의 이름은 고유해야 합니다.
"사용자 정의 확장 추가" 클릭
파일 선택기가 열리면 .mcpb 파일을 선택합니다.
확장이 사용자 정의 팀 확장 아래에 나타납니다.
"..."를 클릭한 다음 "팀에 추가"를 클릭하여 허용 목록에 추가하고 팀에 활성화합니다.
사용자 정의 확장을 허용 목록에 추가하면, 특정 조직으로 범위가 지정되며 다른 조직에서는 사용할 수 없습니다. MCP Bundles (.mcpb)를 사용하여 사용자 정의 확장을 만드는 방법에 대한 자세한 정보는 데스크톱 확장 개발자 설명서를 참조하세요.
사용자 정의 확장 업데이트
이전에 설치한 사용자 정의 확장을 제거하고 다시 설치하지 않고도 새 버전으로 업데이트할 수 있는 기능도 도입했습니다.
manifest.json을 변경하여 새 MCPB 버전을 업데이트할 수 있으며, 업데이트 후보의 version 필드가 현재 업로드된 버전에서 증가했는지 확인하고 name 값은 변경하지 않은 상태로 유지하세요. 이름을 변경하면 새 버전을 업로드하는 대신 새로운 사용자 정의 데스크톱 확장이 생성됩니다. 그런 다음 사용자 정의 업로드 창으로 이동하여 kebab 메뉴를 통해 "새 버전 업로드"를 선택하고 새 파일을 업로드합니다.