이것은 로컬 서버(MCPB)를 Anthropic의 공개 디렉토리에 제출하여 더 광범위한 배포 및 검색 가능성을 위한 완전한 가이드입니다.
전제 조건
이 가이드를 읽기 전에 다음이 필요합니다:
작동하는 MCPB
변수 치환을 사용하는 이식 가능한 코드
좋은 오류 메시지 및 사용자 경험
깔끔하게 번들된 종속성
MCPB 개발이 처음이신가요? 먼저 Building MCPB Extensions를 참조하세요. 기술적 모범 사례(테스트, 오류 메시지, 이식성)는 MCPB Repository를 참조하세요.
참고: 이 가이드는 로컬 MCP 서버를 다룹니다. 원격 데스크톱 확장의 경우 Remote MCP Server Submission Guide를 참조하세요.
1. 디렉토리 개요
디렉토리 포함의 이점은 무엇입니까?
검색 가능성 및 신뢰:
Claude Desktop 내 공식 Anthropic 디렉토리에 나열됨
개별 Claude Desktop 사용자가 검색 가능
관리자가 허용 목록에 추가할 때 Teams/Enterprise 사용자에게 표시됨
Anthropic 검토는 사용자 신뢰를 구축함
사용자 경험:
디렉토리에서 원클릭 설치
Claude Desktop 설정 UI와 통합
표준화된 프레젠테이션
지원 및 신뢰성:
품질 및 보안에 대한 Anthropic 검토
다른 검토된 확장과 함께 나열됨
커뮤니티 가시성 및 피드백
전문적인 배포 채널
2. 필수 요구 사항
이 섹션의 모든 요구 사항은 디렉토리 승인을 위해 필수입니다. 이 중 하나라도 누락되면 거부 또는 수정 요청이 발생합니다.
참고: 이는 Anthropic 디렉토리 특정 요구 사항입니다.
일반적인 MCPB 개발 모범 사례(테스트, 오류 처리, 이식성)는 MCPB Repository README를 참조하세요.
도구 주석이 필수입니까?
예. 모든 도구는 정확한 안전 주석을 가져야 하고 유지해야 합니다.
모든 도구에 필수:
readOnlyHint: true - 데이터만 읽는 도구의 경우
destructiveHint: true - 데이터를 수정하거나 부작용이 있는 도구의 경우
MCP Protocol - Tool Annotations에서 완전한 스키마 및 구현 세부 사항을 참조하세요.
선택 사항이 아닙니다. 이는 MCP Directory Policy에서 파생된 하드 요구 사항입니다.
어떤 주석을 선택할지 결정하는 방법:
도구 동작 | 주석 | 예시 |
데이터만 읽음 | readOnlyHint: true | search, get, list, fetch, read |
데이터 쓰기/수정 | destructiveHint: true | create, update, delete, send, write |
임시 파일 생성 | destructiveHint: true | 임시 쓰기도 포함됨 |
외부 요청 전송 | destructiveHint: true | 이메일, 알림, 웹훅 |
내부적으로만 캐시 | readOnlyHint: true | 내부 최적화 OK |
구현 세부 사항: MCP Protocol - Tools에서 다음을 참조하세요:
주석이 있는 완전한 도구 스키마
도구 정의 구조
입력/출력 스키마 사양
추가 도구 속성(선택적 제목 필드 포함)
제출 전 검증:
# 모든 도구에 주석이 있는지 확인
grep -A 5 -B 5 "readOnlyHint\|destructiveHint" server/
# 각 도구에 정확히 하나의 주석이 있는지 확인
영향: 우리가 확인하는 첫 번째 항목이며 수정 요청의 가장 일반적인 이유입니다.
추가 권장 주석:
title - UI 표시를 위한 인간이 읽을 수 있는 도구 이름(사용자 경험 개선)
개인정보 보호정책이 필수입니까?
예, 개인정보 보호정책은 두 위치에 필요합니다:
위치 1: README.md
사용자가 귀사의 관행을 인식할 수 있도록 전체 개인정보 보호정책 링크가 있는 "Privacy Policy" 섹션을 README에 추가하세요:
## Privacy Policy
This extension collects [describe data types]. For complete privacy information, see our privacy policy: https://your-domain.com/privacy-policy
### Data Collection
- [List what data is collected]
- [How it's used]
- [Whether it's shared with third parties]
- [Retention period]
위치 2: manifest.json
공개적으로 접근 가능한 HTTPS URL이 있는 privacy_policies 배열을 추가하세요:
완전한 구현: MCPB Manifest Spec - Privacy Policies에서 다음을 참조하세요:
개인정보 보호정책 필드 구조
매니페스트 버전 요구 사항(0.3+)
여러 정책 URL 지원
검증 요구 사항
개인정보 보호정책이 다루어야 할 사항:
MCPB가 수집하는 데이터
데이터 사용 및 저장 방법
데이터가 제3자와 공유되는지 여부
사용자 데이터 보존 정책
개인정보 보호 관련 문의 연락처
요구 사항:
공개적으로 접근 가능한 HTTPS URL이어야 함
귀사 도메인에서 제공되어야 함(제3자 호스팅 아님)
현재이고 정확해야 함
README AND manifest.json에 있어야 함
manifest_version "0.3" 이상을 사용해야 함
일반적인 실수:
개인정보 보호정책이 매니페스트에는 있지만 README에는 없음
개인정보 보호정책이 README에는 있지만 매니페스트에는 없음
manifest_version "0.2" 이상 사용
유효하지 않거나 접근 불가능한 URL
제3자 사이트에서 호스팅되는 개인정보 보호정책
영향: 거부의 가장 일반적인 원인 중 하나 - 수정하기는 간단하지만 자주 간과됩니다.
몇 개의 예시가 필요합니까?
핵심 기능을 보여주는 최소 3개의 작동하는 예시.
좋은 예시로 간주되는 것:
현실적인 사용 사례를 보여줌
예상되는 사용자 입력/프롬프트 포함
예상되는 출력/동작을 보여줌
실제 도구 사용을 보여줌
명확하고 이해하기 쉬운 워크플로우
예시 형식(README.md에서):
## Examples
### Example 1: Search for files
**User prompt:** "Find all JavaScript files in my project"
**Expected behavior:**
- Extension searches workspace directory
- Returns list of .js files with paths
- Shows file count in summary
### Example 2: Read file contents
**User prompt:** "Show me the contents of config.json"
**Expected behavior:**
- Extension reads config.json
- Returns formatted JSON content
- Handles file not found gracefully
### Example 3: Create new file
**User prompt:** "Create a new file called notes.txt with 'Hello World'"
**Expected behavior:**
- Extension creates notes.txt
- Writes content to file
- Confirms creation with file path
포함할 사항:
현실적인 사용자 프롬프트(사용자가 상호 작용하는 방식)
예상되는 도구 호출(백그라운드에서 발생하는 일)
예상되는 출력(사용자가 볼 내용)
오류 처리 예시(선택 사항이지만 권장)
요구 사항:
최소 3개의 예시(최대값 없음)
핵심 기능 포함
다양한 도구/기능 표시
가치 제안 시연
README.md에 포함
영향: 지연 또는 거부의 빈번한 원인 - 검토자는 제출을 적절히 평가하기 위해 완전한 문서가 필요합니다.
테스트 자격 증명을 제공해야 합니까?
MCPB가 인증이나 외부 서비스 접근이 필요한 경우 예.
필수인 경우:
MCPB가 외부 API에 연결
기능을 위해 인증이 필요
MCPB 사용자가 기능을 사용하려면 계정이 있어야 함
외부 서비스 통합이 있음
필수가 아닌 경우:
순수 로컬 MCPB(파일 시스템 작업만)
외부 연결 없음
인증 필요 없음
완전히 자체 포함됨
제공할 사항:
테스트 계정 자격 증명(사용자 이름/암호 또는 API 키)
계정의 샘플 데이터(기능 테스트에 도움이 됨)
설정 지침(테스트 계정을 구성하고 사용하는 방법)
접근 제한 사항(있는 경우)
계정 만료 날짜(임시인 경우)
제공 방법:
제출 양식에 포함
매우 민감한 경우 안전한 방법으로 전송
검토 기간 동안 계정이 활성 상태로 유지되는지 확인
완전한 테스트를 위해 충분한 접근 수준 제공
모범 사례: 프로덕션과 별도의 전용 테스트 계정을 만들어:
프로덕션 데이터 노출 방지
검토자가 접근할 수 있는 항목 제어
승인 후 접근 쉽게 취소
테스트 계정 사용 추적
영향: 필요할 때 누락되면 검토 프로세스가 지연됨
어떤 문서가 필요합니까?
필수 섹션의 최소값이 있는 README.md의 포괄적인 문서.
필수 최소 섹션:
Description - MCPB가 수행하는 작업에 대한 명확한 설명
Features - 주요 기능 및 사용 사례
Installation - 설치 방법(일반적으로: "Anthropic Directory에서 설치")
Configuration - 필수 설정 및 설정 단계
Usage Examples - 최소 3개의 예시(위 섹션 참조)
Privacy Policy - 전체 개인정보 보호정책 링크
Support - 사용자가 도움을 받거나 문제를 보고하는 방법
예시 README.md 구조:
# My MCPB Extension
## Description
Brief description of what this extension does and why it's useful.
## Features
- Feature 1: [description]
- Feature 2: [description]
- Feature 3: [description]
## Installation
Install from the Anthropic Directory in Claude Desktop Settings → Extensions.
## Configuration
1. Open Settings → Extensions → [Extension Name]
2. Add API key (if required)
3. Select workspace directory
4. Configure optional settings
## Examples
[See minimum 3 examples section above]
## Privacy Policy
See our privacy policy: https://your-domain.com/privacy
## Support
For issues or questions: [email protected]
GitHub Issues: https://github.com/your-username/your-extension/issues
추가 권장 섹션:
Troubleshooting - 일반적인 문제 및 해결책
Version compatibility - 지원되는 Claude Desktop 버전
Changelog - 버전 기록 및 변경 사항
Contributing - 다른 사람이 기여하는 방법(오픈 소스의 경우)
모범 사례:
명확하고 간결한 작성
스크린샷(선택 사항이지만 매우 도움이 됨)
단계별 지침
추가 리소스 링크
3. 제출 프로세스
디렉토리에 어떻게 제출합니까?
디렉토리에 제출하기 전에 이 단계별 제출 프로세스를 완료하세요:
1. 제출 전 체크리스트:
MCPB 테스트:
4가지 테스트 단계 모두 통과(개발, 깨끗한 환경, 크로스 플랫폼, Claude Desktop)
개발 도구 없이 깨끗한 환경에서 작동
macOS 및 Windows에서 이식 가능
종속성이 최신이고 번들됨
오류 메시지가 도움이 되고 실행 가능
성능이 허용 가능
필수 요구 사항 확인:
모든 도구에 readOnlyHint 또는 destructiveHint 주석이 있음
개인정보 보호정책이 README.md에 있음
개인정보 보호정책이 manifest.json privacy_policies 배열에 있음
최상의 호환성을 위해 최신 Manifest 버전 사용
README에 문서화된 최소 3개의 작동하는 예시
테스트 자격 증명 제공(해당하는 경우)
문서 준비:
필수 섹션이 모두 있는 README.md 완성
LICENSE 파일 포함
아이콘 포함(권장, 512×512px PNG)
CHANGELOG.md(선택 사항이지만 권장)
2. 최종 버전 패키징:
# Clean build
rm -rf node_modules/.cache
npm install --production
# Package
mcpb pack
# Verify package
mcpb info your-extension.mcpb
3. 공식 양식을 통해 제출:
제출 양식: