Claude Desktop의 로컬 MCP 서버 설치 지원

Claude Desktop 로컬 MCP 서버 설치 지원

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

데스크톱 확장 기능

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

참고: 디렉터리에 데스크톱 확장 기능(Claude Desktop용 로컬 MCP 서버)을 등록하려는 개발자라면 데스크톱 확장 제출 양식을 통해 제출하세요. 대신 플러그인이나 원격 커넥터를 제출하려면 개발자 포털을 사용하세요. 각 경로에서 어떤 항목을 받는지는 플러그인 제출을 참조하세요.

디렉터리에서 데스크톱 확장 기능 설치하기

1. Claude Desktop에서 설정 > 데스크톱 앱으로 이동한 다음 확장 기능 옆의 "관리"를 선택합니다(이전 설정 레이아웃에서는 설정 > 확장 기능).
2. “확장 기능 찾아보기”를 클릭해 디렉터리를 보고 사용하려는 Anthropic 검토 도구를 클릭합니다. 원하는 확장 기능에서 "설치"를 클릭합니다.
3. 사용자 친화적인 인터페이스를 통해 필요한 설정(API 키 등)을 구성합니다.
4. 확장 기능이 대화에서 자동으로 사용 가능해집니다.

사용자 지정 데스크톱 확장 기능 설치하기

1. Claude Desktop에서 설정 > 데스크톱 앱으로 이동한 다음 확장 기능 옆의 "관리"를 선택합니다(이전 설정 레이아웃에서는 설정 > 확장 기능).
2. “고급 설정”을 클릭하고 Extension Developer 섹션을 찾습니다.
3. “Install Extension…”을 클릭합니다.
4. .mcpb 파일을 선택하고 안내에 따라 설치합니다.

데스크톱 확장 기능을 위한 관리자 제어

Team 및 Enterprise 플랜의 Owner와 Primary Owner는 두 가지 제어 수단을 사용해 팀의 데스크톱 확장 기능 접근을 관리할 수 있습니다.

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

이러한 제어 수단을 통해 조직은 팀이 접근해야 하는 확장 기능만 추가하고 나머지는 제거함으로써 등록 항목을 완전히 맞춤 설정할 수 있습니다.

Team 및 Enterprise 플랜에서 특정 확장 기능 활성화/비활성화하기

Team 및 Enterprise 조직의 Owner와 Primary Owner는 Claude Desktop을 통해 조직에서 어떤 데스크톱 확장 기능을 활성화하고 다른 구성원이 접근할 수 있게 할지 관리할 수 있습니다. 구체적인 안내는 데스크톱 확장 허용 목록 활성화 및 사용을 참조하세요.

조직용 사용자 지정 확장 기능 만들기 및 업로드하기

사용자 지정 데스크톱 확장 기능 업로드를 통해 Team 및 Enterprise 플랜은 공개 디렉터리에는 없는 조직별 워크플로를 활용할 수 있습니다. 사용자 지정 데스크톱 확장 기능을 만든 뒤, Owner와 Primary Owner는 설정 > 데스크톱 앱으로 이동해 확장 기능 옆의 "관리"를 선택하고(이전 설정 레이아웃에서는 설정 > 확장 기능), "고급 설정"을 클릭해 Extension Developer 섹션에 접근할 수 있습니다:

“Install Extension…”을 클릭하고 .mcpb 파일을 선택합니다. 안내에 따라 사용자 지정 데스크톱 확장 기능을 설치하고 구성하세요. 더 자세한 정보는 데스크톱 확장 개발자 문서를 참고하세요.

Enterprise 정책 제어

참고: 사용자-기기 수준의 Enterprise 정책 제어는 앱 내 제어(blocklist 및 allowlist)를 모두 덮어씁니다. 앱 내 제어를 사용하려면 isDesktopExtensionEnabled와 isDesktopExtensionDirectoryEnabled가 "false"로 설정되어 있지 않은지 확인해 allowlist가 사용 가능한 등록 항목을 채울 수 있도록 하세요.

시스템 정책을 통해 데스크톱 확장 기능을 제어하려면 데스크톱 Enterprise 구성 문서를 참조하세요.

데스크톱 확장 기능 설치 문제 해결

확장 기능이 설치되지 않음

• Claude Desktop의 최신 버전을 실행하고 있는지 확인하세요.
• 확장 파일이 손상되지 않았는지 다시 다운로드하여 확인하세요.
• 설치에 필요한 충분한 디스크 공간이 있는지 확인하세요.

확장은 설치된 것처럼 보이지만 도구를 사용할 수 없음

• Claude Desktop을 다시 시작하여 확장 레지스트리를 새로고침하세요.
• 확장 설정에서 필수 항목이 누락되었는지 확인하세요.
• API 키나 인증 자격 증명이 올바르게 입력되었는지 확인하세요.

확장 구성 문제

• Settings > Desktop app으로 이동한 다음 Extensions 옆의 "Manage"를 선택합니다(또는 이전 Settings 레이아웃에서는 Settings > Extensions). 그런 다음 확장을 클릭해 설정을 검토하세요.
• 필요한 모든 구성 필드가 입력되었는지 확인하세요.
• 파일 경로가 적용되는 경우, 접근 권한이 있는 기존 디렉터리를 가리키는지 확인하세요.

권한 또는 보안 오류

• macOS에서는 보안 경고가 표시되면 System Preferences > Security & Privacy를 확인하세요.
• Windows 및 Linux에서는 Claude Desktop이 필요한 디렉터리에 접근할 수 있도록 필요한 권한이 있는지 확인하세요.
• 엔터프라이즈 환경에서는 조직의 정책을 통해 데스크톱 확장이 활성화되어 있는지 확인하세요.

개발자 FAQ

Claude Desktop에서 MCP 서버가 제대로 연결되었는지 어떻게 확인하나요?

Claude Desktop의 채팅 상자 하단에 있는 "+" 버튼을 클릭한 다음 "Connectors"를 선택하세요. 그러면 연결된 MCP 서버와 해당 도구가 표시됩니다. 또는 Extensions 페이지의 Local MCP servers 섹션(Settings > Desktop app에서 Extensions 옆의 "Manage"를 선택)으로 이동하거나, 이전 Settings 레이아웃에서는 Settings > Developer 아래의 This computer로 이동해 연결 상태를 확인하고 MCP 서버의 로그를 볼 수 있습니다.

기존 MCP 서버를 데스크톱 확장으로 변환하려면 어떻게 하나요?

1. MCP 서버 디렉터리에 필요한 메타데이터가 포함된 manifest.json 파일을 추가하세요.
2. mcpb pack 명령으로 패키징하세요.
3. 자세한 지침은 MCPB documentation을 참조하세요.

데스크톱 확장에서 지원하는 프로그래밍 언어는 무엇인가요?

데스크톱 확장은 Node.js, Python, 그리고 바이너리 MCP 서버를 지원합니다. Claude Desktop에는 기본 제공 Node.js 환경이 포함되어 있으므로 Node.js를 별도로 설치할 필요가 없습니다.

API 키와 같은 민감한 구성은 어떻게 처리하나요?

manifest.json에서 구성 필드를 "sensitive": true로 표시하세요. Claude Desktop은 운영 체제의 보안 저장소(macOS의 Keychain, Windows의 Credential Manager, 그리고 Linux의 배포판별 키체인 관리자)를 사용해 이 값들을 자동으로 암호화합니다.

사용자 지정 데스크톱 확장을 비공개로 배포할 수 있나요?

네, .mcpb 파일을 특정 사용자나 팀과 직접 공유할 수 있습니다. 더 넓은 배포가 필요한 경우, 확장을 공식 디렉터리에 제출할 수 있습니다.

데스크톱 확장 문제를 어떻게 디버그하나요?

Claude Desktop 설정에서 디버그 로깅을 활성화하고, Extensions 설정 패널에서 확장 로그를 확인한 다음, 프로토콜별 문제 해결을 위해 MCP 디버깅 가이드를 참조하세요.

내 확장에 업데이트가 필요하면 어떻게 되나요?

공식 디렉터리의 확장은 기본적으로 자동 업데이트됩니다. 비공개로 배포된 확장의 경우, 사용자가 업데이트된 .mcpb 파일을 수동으로 설치해야 합니다.

MCP에 대해 더 알아보고 싶으신가요?

자체 MCP 클라이언트와 서버를 구축하는 방법에 대한 더 자세한 정보를 원하신다면, 다음 자료를 검토해 보시길 권장합니다.

• MCP 빠른 시작 가이드 - 기본적인 MCP 통합을 시작하기에 완벽한 단계별 튜토리얼입니다.
• Model Context Protocol Github - 전체 기술 문서, 코드 예제, 구현 가이드를 포함하고 있습니다.
• MCP 통합 디버깅 가이드 - 일반적인 구현 문제에 대한 문제 해결 팁과 해결책을 제공합니다.

추가 안내가 필요하시면, 더 많은 지원 옵션이 있는 지원 받는 방법 가이드를 방문하세요.

출처

• 원문: https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop (2026-10-23 · support.claude.com)