Model Context Protocol(MCP)는 LLM 애플리케이션과 외부 데이터 소스 및 도구 간의 원활한 통합을 가능하게 하는 개방형 프로토콜입니다. 데스크톱 확장 프로그램의 도입으로 로컬 MCP 서버의 설치 및 관리가 훨씬 더 쉬워졌습니다.

데스크톱 확장 프로그램

데스크톱 확장 프로그램은 한 번의 클릭으로 설치 가능한 패키지를 통해 로컬 MCP 서버를 설치하고 관리하는 간편한 방법을 제공합니다. JSON 파일을 수동으로 구성하고 종속성을 관리하는 대신, 이제 브라우저 확장 프로그램처럼 쉽게 컴퓨터에 로컬 MCP 서버를 설치할 수 있습니다.

참고: 데스크톱 확장 프로그램 디렉토리를 구축 중입니다. 개발자로서 직접 만든 확장 프로그램을 디렉토리에 추가하고 싶다면, 당사의 데스크톱 확장 프로그램 관심 양식을 작성하여 더 많은 정보를 공유해 주세요.

디렉토리에서 데스크톱 확장 프로그램 설치

Claude Desktop에서 설정 > 확장 프로그램으로 이동합니다.
"확장 프로그램 찾아보기"를 클릭하여 디렉토리를 보고 사용하려는 Anthropic 검토 도구를 클릭합니다. 원하는 확장 프로그램에서 "설치"를 클릭합니다.
사용자 친화적인 인터페이스를 통해 필요한 설정(예: API 키)을 구성합니다.
확장 프로그램이 대화에서 자동으로 사용 가능해집니다.

사용자 정의 데스크톱 확장 프로그램 설치

Claude Desktop에서 설정 > 확장 프로그램으로 이동합니다.
"고급 설정"을 클릭하고 확장 프로그램 개발자 섹션을 찾습니다.
"확장 프로그램 설치…"를 클릭합니다.
.mcpb 파일을 선택하고 프롬프트를 따라 설치합니다.

데스크톱 확장 프로그램의 관리자 제어

Team 및 Enterprise 플랜의 소유자 및 주요 소유자는 두 가지 제어를 사용하여 팀의 데스크톱 확장 프로그램 액세스를 관리할 수 있습니다:

조직의 보안 표준에 따라 공개 데스크톱 확장 프로그램을 활성화하거나 비활성화합니다.
사용자 정의 데스크톱 확장 프로그램을 업로드하고 팀에서 한 번의 클릭으로 설치할 수 있도록 제공합니다.

이러한 제어를 통해 조직은 팀이 액세스해야 하는 확장 프로그램만 추가하고 다른 확장 프로그램을 제거하여 레지스트리를 완전히 사용자 정의할 수 있습니다.

Team 및 Enterprise 플랜에서 특정 확장 프로그램 활성화/비활성화

Team 및 Enterprise 조직의 소유자 및 주요 소유자는 조직에서 활성화된 데스크톱 확장 프로그램과 Claude Desktop을 통해 다른 구성원이 액세스할 수 있는 확장 프로그램을 관리할 수 있습니다. 데스크톱 확장 프로그램 허용 목록 활성화 및 사용

을 참조하여 구체적인 지침을 확인하세요.

조직을 위한 사용자 정의 확장 프로그램 생성 및 업로드

사용자 정의 데스크톱 확장 프로그램 업로드를 통해 Team 및 Enterprise 플랜은 공개 디렉토리에서 사용할 수 없는 조직별 워크플로우를 활용할 수 있습니다. 사용자 정의 데스크톱 확장 프로그램을 만든 후, 소유자 및 주요 소유자는 Claude Desktop 내에서 설정 > 확장 프로그램으로 이동하고 "고급 설정"을 클릭하여 확장 프로그램 개발자 섹션에 액세스할 수 있습니다:

"확장 프로그램 설치…"를 클릭하고 .mcpb 파일을 선택합니다. 프롬프트를 따라 사용자 정의 데스크톱 확장 프로그램을 설치하고 구성합니다. 더 자세한 정보는 데스크톱 확장 프로그램 개발자 설명서를 참조하세요.

Enterprise 정책 제어

참고: 사용자-머신 수준의 Enterprise 정책 제어는 모든 앱 내 제어(차단 목록 및 허용 목록)를 재정의합니다. 앱 내 제어를 사용하려면 isDesktopExtensionEnabled 및 isDesktopExtensionDirectoryEnabled가 "false"로 설정되지 않았는지 확인하여 허용 목록이 사용 가능한 레지스트리를 채울 수 있도록 하세요.

시스템 정책을 통해 데스크톱 확장 프로그램을 제어하려면 데스크톱 Enterprise 구성 설명서를 참조하세요.

데스크톱 확장 프로그램 설치 문제 해결

확장 프로그램이 설치되지 않음

최신 버전의 Claude Desktop을 실행 중인지 확인합니다.
확장 프로그램 파일을 다시 다운로드하여 손상되지 않았는지 확인합니다.
설치를 위한 충분한 디스크 공간이 있는지 확인합니다.

확장 프로그램이 설치된 것으로 표시되지만 도구를 사용할 수 없음

Claude Desktop을 다시 시작하여 확장 프로그램 레지스트리를 새로 고칩니다.
필수 필드가 누락되지 않았는지 확장 프로그램의 구성 설정을 확인합니다.
API 키 또는 인증 자격 증명이 올바르게 입력되었는지 확인합니다.

확장 프로그램 구성 문제

설정 > 확장 프로그램으로 이동하고 확장 프로그램을 클릭하여 설정을 검토합니다.
모든 필수 구성 필드가 완료되었는지 확인합니다.
파일 경로(해당하는 경우)가 액세스할 수 있는 기존 디렉토리를 가리키는지 확인합니다.

권한 또는 보안 오류

macOS에서 보안 경고가 표시되면 시스템 환경설정 > 보안 및 개인정보 보호를 확인합니다.
Windows에서 Claude Desktop이 필요한 디렉토리에 액세스할 수 있는 필요한 권한이 있는지 확인합니다.
Enterprise 환경의 경우 조직의 정책을 통해 데스크톱 확장 프로그램이 활성화되어 있는지 확인합니다.

개발자 FAQ

MCP 서버가 Claude Desktop에 제대로 연결되어 있는지 확인하려면 어떻게 해야 합니까?

Claude Desktop의 채팅 상자 하단에 있는 "+" 버튼을 클릭한 다음 "커넥터"를 선택합니다. 이렇게 하면 연결된 MCP 서버와 해당 도구가 표시됩니다. 또는 개발자 설정(데스크톱 앱 아래)을 방문하여 연결 상태를 확인하고 MCP 서버의 로그를 볼 수 있습니다.

기존 MCP 서버를 데스크톱 확장 프로그램으로 변환하려면 어떻게 해야 합니까?

필수 메타데이터가 포함된 manifest.json 파일을 MCP 서버 디렉토리에 추가합니다.
mcpb pack 명령을 사용하여 패키징합니다.
자세한 지침은 MCPB 설명서를 참조하세요.