이 가이드는 내부 사용, 비공개 배포 또는 Anthropic의 Connectors Directory 제출을 위한 기반으로 데스크톱 확장 프로그램을 만들기 위해 MCP Bundle(.mcpb)을 빌드하는 데 도움을 드립니다.
1. 소개
MCPB란 무엇인가요?
MCPB(.mcpb) 파일은 로컬 MCP 서버와 manifest.json을 포함하는 zip 아카이브입니다. 브라우저 확장 프로그램과 유사하게 Claude Desktop에서 원클릭 설치를 가능하게 합니다.
주요 특징:
사용자의 컴퓨터에서 로컬로 실행
stdio 전송을 통해 통신
모든 종속성 번들링
오프라인 작동
OAuth 불필요
자세히 알아보기:
MCPB Repository - 전체 사양 및 아키텍처
Desktop Extensions Blog Post - 개요 및 사용 사례
로컬 서버(MCPB)와 원격 서버 중 어떤 것을 사용해야 하나요?
다음의 경우 로컬 서버(MCPB)를 선택하세요:
내부 시스템 및 보안
방화벽 뒤의 시스템 액세스(JIRA, Confluence, 내부 위키, 비공개 데이터베이스)
원활한 인증 - 기존 SSO 및 브라우저 세션을 자동으로 사용하며 토큰 관리 불필요
제로 트러스트 규정 준수 - 내부 리소스를 공개적으로 노출하지 않고 기업 네트워크 경계 내에서 작동
로컬 리소스
코드 편집 및 Git 작업을 위한 직접 파일시스템 액세스
로컬에 설치된 도구(Docker, IDE, 데이터베이스)와의 통합
하드웨어 통합 및 데스크톱 애플리케이션 제어
사용자의 컴퓨터를 벗어나서는 안 되는 개인정보 보호에 민감한 작업
엔터프라이즈 배포
내장된 Node.js 런타임으로 원클릭 설치(관리할 종속성 없음)
클라우드 인프라, VPN 구성 또는 방화벽 규칙 불필요
조직 수준 제어 - 관리자가 사용자 지정 확장 프로그램을 업로드하고 허용 목록을 통해 액세스 관리 가능
인증, 권한 부여 및 감사 로그에 대한 완전한 제어
다음의 경우 원격 커넥터를 선택하세요:
중앙 집중식 인프라가 필요한 클라우드 서비스 및 공개 API
웹, 모바일 및 데스크톱의 Claude 전반에 걸친 배포
모든 사용자에게 중앙 집중식 업데이트가 필요한 서비스
서버 측 토큰 관리가 필요한 OAuth 플로우
여러 조직에서 사용하는 공개 통합
주요 차이점: MCPB는 로컬 및 내부 리소스에 액세스할 수 있는 stdio 전송을 통해 사용자의 컴퓨터에서 실행됩니다. 원격 커넥터는 HTTPS를 통해 서버에서 실행되며 Anthropic의 인프라를 통해 액세스됩니다.
실제 사용: 조직들은 내부 MCP 서버에 대한 보안 프록시로, 내부 문서 액세스를 위해, 그리고 보안 아키텍처를 유지하면서 개발 도구를 연결하기 위해 MCPB를 구축하고 있습니다.
원격 커넥터 가이드: 전체 원격 커넥터 문서는 MCP Partner FAQ를 참조하세요.
2. 시작하기
어떤 프로그래밍 언어를 사용해야 하나요?
Node.js를 강력히 권장합니다. 이유는 다음과 같습니다:
macOS 및 Windows용 Claude와 함께 제공됨(사용자의 설치 마찰 제로)
사용자가 별도의 런타임 설치 불필요
Claude Desktop과의 최고의 호환성 및 안정성
광범위한 MCP SDK 지원
어떤 플랫폼을 지원해야 하나요?
Claude Desktop은 다음에서 실행됩니다:
macOS (darwin)
Windows (win32)
manifest.json 호환성 섹션에서 지원되는 플랫폼을 지정하세요.
모범 사례: 주로 한 플랫폼에서 개발하더라도