이 가이드는 내부 사용, 개인 배포 또는 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, 내부 wiki, 개인 데이터베이스)
원활한 인증 - 기존 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 호환성 섹션에서 지원되는 플랫폼을 지정하세요.
모범 사례: 주로 한 플랫폼에서 개발하더라도 두 플랫폼 모두에서 테스