이 가이드는 내부 사용, 개인 배포 또는 Anthropic의 Connectors Directory에 제출하기 위한 기초로 사용할 수 있는 MCP Bundle(.mcpb)을 구축하는 데 도움이 됩니다.

MCPB(.mcpb) 파일은 로컬 MCP 서버와 manifest.json을 포함하는 zip 아카이브입니다. 브라우저 확장 프로그램과 유사하게 Claude Desktop에서 한 번의 클릭으로 설치할 수 있습니다.

주요 특징:

자세히 알아보기:

다음의 경우 로컬 서버(MCPB)를 선택하세요:

내부 시스템 및 보안

로컬 리소스

엔터프라이즈 배포

다음의 경우 원격 커넥터를 선택하세요:

주요 차이점: MCPB는 stdio 전송을 통해 사용자의 머신에서 실행되며 로컬 및 내부 리소스에 액세스할 수 있습니다. 원격 커넥터는 HTTPS를 통해 사용자의 서버에서 실행되며 Anthropic의 인프라를 통해 액세스됩니다.

실제 사용: 조직은 내부 MCP 서버에 대한 보안 프록시로, 내부 문서 액세스를 위해, 그리고 보안 아키텍처를 유지하면서 개발 도구를 연결하기 위해 MCPB를 구축하고 있습니다.

원격 커넥터 지침: 완전한 원격 커넥터 문서는 MCP Partner FAQ를 참조하세요.

Node.js를 강력히 권장합니다 이유는:

Claude Desktop은 다음에서 실행됩니다:

manifest.json 호환성 섹션에서 지원되는 플랫폼을 지정하세요.

모범 사례: 주로 한 플랫폼에서 개발하더라도 두 플랫폼 모두에서 테스트하세요.

플랫폼 호환성 세부 정보: 플랫폼 사양 및 런타임 요구 사항은 MCPB Manifest Spec - Compatibility를 참조하세요.

다음 5단계 프로세스를 따르세요:

1. MCPB CLI 설치: npm install -g @anthropic-ai/mcpb

2. MCP 서버 생성(MCP SDK 참조)

3. mcpb init을 실행하여 manifest.json 생성

4. mcpb pack을 실행하여 번들

5. Claude Desktop에서 설치 및 테스트

자세한 구현 지침:

개발, 테스트 및 모범 사례에 대한 포괄적인 지침은 MCPB README의 "For Bundle Developers" 섹션을 참조하세요.

manifest.json 파일은 MCPB를 설명하는 필수 메타데이터입니다 - 기능, 실행 방법, 제공하는 도구 및 필요한 구성입니다.

최신 정보는 공식 MCPB 사양을 참조하세요.

아이콘은 선택 사항이지만 전문적인 모양을 위해 권장됩니다.

기본 접근: 번들 루트 디렉토리에 icon.png 파일을 포함하고 manifest.json에서 참조하세요.

요구 사항:

고급 옵션: 다양한 크기 및 테마(라이트/다크 모드 지원)에 대한 여러 아이콘 변형.

구현 세부 정보: 다음을 위해 MCPB Manifest Spec - Icons를 참조하세요:

manifest.json에서 user_config 섹션을 정의하세요. Claude Desktop은 자동으로 사용자가 확장을 구성할 수 있는 설정 UI를 생성합니다.

완전한 구현을 위해 MCPB Manifest Spec - User Configuration을 참조하세요:

세 가지 설치 방법이 있습니다:

모든 방법이 설치 UI를 열며 사용자는 다음을 수행할 수 있습니다:

설치 범위: 사용자별 설치 - 각 사용자는 자신의 시스템에 별도로 설치해야 합니다.

사용자 경험 및 관리자 제어: 최종 사용자 설치 경험 및 엔터프라이즈 관리자 제어(Team/Enterprise 조직 관리 및 정책 구성 포함)에 대한 자세한 정보는 다음을 참조하세요:

MCPB 프레임워크:

MCP 프로토콜:

Claude Desktop:

지원 채널:

커뮤니티 리소스:

작동하는 MCPB를 구축했고 더 광범위한 배포 및 검색 가능성을 위해 Anthropic Directory에 제출하려면 동반 가이드를 참조하세요: Submitting to Anthropic Directory.

디렉토리 가이드는 다음을 포함한 추가 요구 사항을 다룹니다: