Claude for Desktop의 MCP는 현재 베타 기능입니다.
Model Context Protocol (MCP)은 LLM 애플리케이션과 외부 데이터 소스 및 도구 간의 원활한 통합을 가능하게 하는 오픈 프로토콜입니다. 데스크톱 확장(DXT)의 도입으로 로컬 MCP 서버의 설치 및 관리가 훨씬 쉬워졌습니다.
데스크톱 확장
데스크톱 확장은 원클릭 설치 가능한 패키지를 통해 로컬 MCP 서버를 설치하고 관리하는 간소화된 방법을 제공합니다. JSON 파일을 수동으로 구성하고 종속성을 관리하는 대신, 이제 브라우저 확장처럼 쉽게 컴퓨터에 로컬 MCP 서버를 설치할 수 있습니다.
참고: 저희는 데스크톱 확장 디렉토리를 구축하고 있습니다. 개발자로서 본인이 만든 확장을 디렉토리에 추가하고 싶으시다면, 데스크톱 확장 관심 양식을 작성하여 더 많은 정보를 저희와 공유해 주세요.
데스크톱 확장 설치
Claude Desktop 내에서 설정 > 확장으로 이동
확장 디렉토리를 탐색하거나 .dxt 파일에서 설치
원하는 확장에서 "설치" 클릭
사용자 친화적인 인터페이스를 통해 필요한 설정(API 키 등) 구성
확장이 대화에서 자동으로 사용 가능해집니다
데스크톱 확장 설치 문제 해결
확장이 설치되지 않는 경우
Claude Desktop의 최신 버전을 실행하고 있는지 확인
확장 파일을 다시 다운로드하여 손상되지 않았는지 확인
설치를 위한 충분한 디스크 공간이 있는지 확인
확장이 설치된 것으로 보이지만 도구를 사용할 수 없는 경우
Claude Desktop을 재시작하여 확장 레지스트리를 새로 고침
누락된 필수 필드에 대한 확장의 구성 설정 확인
API 키 또는 인증 자격 증명이 올바르게 입력되었는지 확인
확장 구성 문제
설정 > 확장으로 이동하여 확장을 클릭하여 설정 검토
모든 필수 구성 필드가 완료되었는지 확인
파일 경로(해당하는 경우)가 액세스 권한이 있는 기존 디렉토리를 가리키는지 확인
권한 또는 보안 오류
macOS에서 보안 경고를 받는 경우 시스템 환경설정 > 보안 및 개인 정보 보호 확인
Windows에서 Claude Desktop이 필요한 디렉토리에 액세스할 수 있는 필요한 권한을 가지고 있는지 확인
기업 환경의 경우, 조직의 정책을 통해 데스크톱 확장이 활성화되어 있는지 확인
개발자 FAQ
기존 MCP 서버를 DXT 확장으로 변환하는 방법은?
필요한 메타데이터가 포함된 manifest.json 파일을 MCP 서버 디렉토리에 추가
dxt pack 명령을 사용하여 패키징
자세한 지침은 DXT 문서를 참조하세요
DXT 확장에서 지원되는 프로그래밍 언어는?
DXT 확장은 Node.js, Python 및 바이너리 MCP 서버를 지원합니다. Claude Desktop에는 내장된 Node.js 환경이 포함되어 있어 Node.js 설치가 필요하지 않습니다.
API 키와 같은 민감한 구성을 처리하는 방법은?
manifest.json에서 구성 필드를 "sensitive": true로 표시하세요. Claude Desktop은 운영 체제의 보안 저장소(macOS의 Keychain, Windows의 Credential Manager)를 사용하여 이러한 값을 자동으로 암호화합니다.
DXT 확장을 비공개로 배포할 수 있나요?
예, .dxt 파일을 특정 사용자나 팀과 직접 공유할 수 있습니다. 더 광범위한 배포를 위해서는 공식 디렉토리에 확장을 제출할 수 있습니다.
DXT 확장의 문제를 디버그하는 방법은?
Claude Desktop 설정에서 디버그 로깅을 활성화하고, 확장 설정 패널에서 확장 로그를 확인하며, 프로토콜별 문제 해결을 위해 MCP 디버깅 가이드를 참조하세요.
확장에 업데이트가 필요한 경우 어떻게 되나요?
공식 디렉토리의 확장은 기본적으로 자동으로 업데이트됩니다. 비공개로 배포된 확장의 경우, 사용