Claude Desktop Extensions release notes / what's new

Anthropic은 사용자가 클릭 한 번으로 Claude Desktop에 Model Context Protocol (MCP) 서버를 설치할 수 있는 새로운 패키징 형식인 Desktop Extensions를 출시했습니다. 이번 업데이트를 통해 사용자는 Node.js나 Python과 같은 런타임을 설치하거나, JSON 설정 파일을 수동으로 편집하거나, 종속성 충돌을 해결할 필요가 없어졌습니다.

Simplified MCP Server Installation

Desktop Extensions는 로컬 MCP 서버 설치 과정을 개발자 중심의 수동 프로세스에서 간소화된 사용자 경험으로 전환합니다. 이전에는 사용자가 런타임을 설치하고, ~/.claude/claude_desktop_config.json을 수동으로 편집하며, 패키지 버전을 관리해야 했습니다. 이전의 .dxt 확장자를 대체하는 새로운 .mcpb (MCP Bundle) 파일 확장자를 통해, 이제 사용자는 번들을 다운로드하고 더블 클릭하여 Claude Desktop을 통해 간단히 설치할 수 있습니다.

Technical Architecture of .mcpb Files

A Desktop Extension은 MCP 서버 구현체와 모든 종속성을 하나의 패키지로 묶는 ZIP 아카이브입니다. 아키텍처는 다음과 같은 구성 요소로 이루어집니다:

manifest.json: 메타데이터, 설정 및 런타임 요구 사항을 포함하는 유일한 필수 파일입니다.
server/: MCP 서버 구현체가 포함된 디렉토리입니다.
dependencies/: 모든 필요한 패키지 및 라이브러리(예: Node.js의 node_modules 또는 Python의 lib)입니다.
icon.png: 확장을 위한 선택 사항인 아이콘입니다.

Claude Desktop은 내장된 Node.js 런타임을 제공하고, 확장에 대한 자동 업데이트를 제공하며, 민감한 API 키를 운영 체제의 키체인에 저장함으로써 런타임 환경을 간소화합니다.

The Manifest Specification

manifest.json 파일은 확장이 어떻게 작동하는지 정의합니다. 주요 기능은 다음과 같습니다:

Runtime Support: node, python, 및 binary 서버 유형을 지원합니다.
User Configuration: 개발자는 필수 입력 사항(예: api_key 또는 allowed_directories)을 정의할 수 있습니다. Claude Desktop은 이러한 입력 사항에 대한 UI를 제공하고, 이를 검증하며, 민감한 값을 OS의 비밀 저장소에 저장합니다.
Dynamic Variables: manifest는 설치 디렉토리를 위한 ${__dirname} 및 사용자 제공 값을 위한 ${user_config.key}와 같은 템플릿 리터럴을 지원합니다.
Cross-Platform Overrides: 개발자는 win32, darwin, 및 linux를 위해 플랫폼별 명령어나 환경 변수를 지정할 수 있습니다.

Developer Toolchain and Workflow

Anthropic은 개발자가 기존 MCP 서버를 Desktop Extensions로 패키징할 수 있도록 돕는 오픈 소스 툴체인을 제공합니다. 워크플로우는 네 가지 주요 단계로 구성됩니다:

Initialization: 대화형 도구를 통해 manifest.json을 생성하기 위해 npx @anthropic-ai/mcpb init을 실행합니다.
Configuration: manifest의 user_config 섹션에 사용자 필수 입력 사항을 정의합니다.
Packaging: npx @anthropic-ai/mcpb pack을 실행하여 manifest를 검증하고 .mcpb 아카이브를 생성합니다.
Testing: 생성된 파일을 Claude Desktop 설정 창으로 드래그하여 설치합니다.

Ecosystem and Enterprise Security

광범위한 생태계를 조성하기 위해, Anthropic은 MCPB 사양, 패키징 도구 및 참조 구현체를 오픈 소스로 공개했습니다. 이를 통해 다른 AI 데스크톱 애플리케이션도 일관된 확장 지원을 위해 .mcpb 형식을 채택할 수 있습니다.

Enterprise Management

조직적 배포를 위해, Anthropic은 여러 보안 및 관리 제어 기능을 도입했습니다:

Deployment: 승인된 확장을 사전 설치하기 위한 Group Policy (Windows) 및 MDM (macOS) 지원.
Control: 특정 게시자나 확장을 차단 목록에 추가하거나 내장된 확장 디렉토리를 완전히 비활성화할 수 있는 기능.
Private Directories: 조직 전용의 프라이빗 확장 디렉토리를 배포하기 위한 지원.

Capabilities and Use Cases

Desktop Extensions는 Claude가 데이터를 사용자의 머신에 유지하면서 로컬 애플리케이션 및 프라이빗 데이터와 상호작용할 수 있게 합니다. 개념 증명(Proof of Concept)으로서, Anthropic은 Claude를 PyBoy GameBoy 에뮬레이터에 연결하는 확장을 시연연하여, 모델이 Super Mario Land와 같은 게임을 플레이하기 위해 에뮬레이터를 제어할 수 있레도록 했습니다.