이것은 원격 MCP 서버를 Anthropic의 MCP 디렉토리에 제출하여 더 광범위한 배포 및 검색 가능성을 위한 완전한 가이드입니다.
전제 조건
서버 제출 전에 다음이 필요합니다:
작동하고 완전히 테스트된 원격 MCP 서버
OAuth 2.0 인증 구현(인증이 필요한 경우)
적절한 안전 주석이 있는 모든 도구
프로덕션 준비 배포
전용 지원 채널(이메일 또는 웹)
샘플 데이터가 있는 프로비저닝된 테스트 계정
포괄적인 문서
원격 MCP 개발이 처음이신가요? 먼저 원격 MCP를 사용한 사용자 정의 커넥터 시작하기를 참조하세요. 기술적 모범 사례 및 프로토콜 세부 정보는 MCP 프로토콜 문서를 참조하세요.
참고: 이 가이드는 원격 MCP 서버(클라우드 호스팅, HTTPS)를 다룹니다. 로컬 데스크톱 확장의 경우 로컬 MCP 서버 제출 가이드를 참조하세요.
1. 디렉토리 개요
디렉토리 포함의 이점은 무엇입니까?
검색 가능성 및 신뢰:
Claude.ai에서 액세스 가능한 공식 Anthropic MCP 디렉토리에 나열됨
모든 플랫폼(웹, 데스크톱, 모바일)의 Claude 사용자가 액세스 가능
서비스의 전문적 가시성
사용자 경험:
디렉토리에서 원클릭 연결
Claude의 커넥터 인터페이스와 통합
플랫폼 전체에서 표준화된 프레젠테이션
OAuth 흐름이 원활하게 처리됨
지원 및 신뢰성:
품질, 보안 및 규정 준수에 대한 Anthropic 검토
다른 검증된 커넥터와 함께 나열됨
커뮤니티 가시성 및 피드백
전문적 배포 채널
어떤 Claude 플랫폼이 원격 MCP 서버를 지원합니까?
모든 주요 Claude 플랫폼:
Claude.ai(웹) - OAuth를 통한 완전 지원
Claude Desktop - OAuth를 통한 완전 지원
Claude Code - 사용자 머신에서의 직접 연결(OAuth 지원 포함)
Claude API - 통합 지원
Claude 모바일 앱 - 커넥터 지원
2. 필수 요구 사항
이 섹션의 모든 요구 사항은 디렉토리 승인을 위해 필수입니다. 이 중 하나라도 누락되면 거부 또는 수정 요청이 발생합니다.
안전 주석이 필요합니까?
예 - 모든 도구는 정확한 안전 주석을 가져야 합니다.
모든 도구에 필수:
readOnlyHint: true - 데이터만 읽는 도구의 경우
destructiveHint: true - 데이터를 수정하거나 부작용이 있는 도구의 경우
MCP 프로토콜 - 도구 주석에서 완전한 스키마 및 구현 세부 정보를 참조하세요.
선택 사항이 아닙니다. 이것은 MCP 디렉토리 정책에서 파생된 엄격한 요구 사항입니다.
주석을 선택하는 방법:
도구 동작 | 주석 | 예시 |
데이터만 읽음 | readOnlyHint: true, destructiveHint: false | search, get, list, fetch, read |
데이터 쓰기/수정 | destructiveHint: true, readOnlyHint: false | create, update, delete, send |
임시 파일 생성 | destructiveHint: true | 임시 쓰기도 포함됨 |
외부 요청 전송 | destructiveHint: true | 이메일, 알림, 웹훅 |
내부적으로만 캐시 | readOnlyHint: true | 내부 최적화 가능 |
추가 권장 주석:
title - UI 표시를 위한 인간이 읽을 수 있는 도구 이름(사용자 경험 개선)
테스트 계정을 제공해야 합니까?
예 - 서버에 인증이 필요한 경우입니다.
제공할 사항:
테스트 계정 자격 증명(사용자 이름/암호 또는 API 키)
계정의 샘플 데이터(기능 테스트에 필요)
테스트 환경 설정 지침
액세스 제한(있는 경우)
테스트 계정은 다음을 가져야 합니다:
검토 중인 모든 도구에 대한 액세스
대표적인 샘플 데이터
전체 기능 테스트를 위한 적절한 권한
검토 기간 및 그 이후 활성 상태
제공 방법:
제출 양식에 자격 증명 포함(이상적으로 1Password 링크와 같은 보안 방법을 통해 공유)
검토 중 및 이후 정기적인 사후 승인 검토를 위해 계정이 활성 상태로 유지되는지 확인
포괄적인 테스트를 위한 충분한 액세스 제공
OAuth 2.0이 필요합니까?
예 - 서버에 인증이 필요한 경우입니다.
OAuth 구현 요구 사항:
OAuth 2.0 인증 코드 흐름을 사용해야 함
인정된 기관의 인증서
로컬 MCP 클라이언트(예: Claude Code, MCP Inspector) 콜백 URL 허용 목록:
http://localhost:6274/oauth/callback
http://localhost:6274/oauth/callback/debug
Claude 콜백 URL 허용 목록:
적절한 리다이렉트 URI 구성
피해야 할 일반적인 OAuth 문제:
잘못된 리다이렉트 URI 오류(두 콜백 URL이 모두 허용 목록에 있는지 확인)
토큰 없는 HEAD 요청(OAuth 흐름 후 정상적으로 처리)
구현 지침: 완전한 OAuth 구현 세부 정보는 OAuth 2.0 인증 프레임워크를 참조하세요.
방화벽 요구 사항이 있습니까?
예 - claude.ai 호환성을 위해 Claude의 IP 주소를 허용 목록에 추가해야 합니다
방화벽 뒤의 서버의 경우 https://docs.claude.com/en/api/ip-addresses의 IP 주소를 허용 목록에 추가하세요.
필수: Claude.ai 및 Claude Desktop
필수 아님: Claude Code(사용자 머신에서 직접 연결)
중요: IP 허용 목록만으로는 보안 조치로 권장되지 않습니다. 가능하면 OAuth 2.0을 인증에 사용하세요.
어떤 문서가 필요합니까?
특정 섹션이 있는 포괄적인 서버 문서입니다.
권장 섹션:
서버 설명 - 서버가 수행하는 작업에 대한 명확한 설명
기능 - 주요 기능 및 사용 사례
설정 지침 - 사용자가 연결하고 구성하는 방법
인증 - OAuth 설정 및 요구 사항(해당하는 경우)
사용 예시 - 최소 3개의 작동하는 예시(프롬프트 포함)(필수)
개인정보 보호정책 - 전체 개인정보 보호정책 링크
지원 - 사용자가 도움을 받거나 문제를 보고하는 방법
예시 문서 구조:
# [서비스 이름] MCP 서버
## 설명
[서비스 통합 및 기능에 대한 간단한 설명]
## 기능
- 기능 1: [설명 및 가치]
- 기능 2: [설명 및 가치]
- 기능 3: [설명 및 가치]
## 설정
1. [Anthropic MCP 디렉토리](https://claude.com/connectors) 방문
2. [서비스] 찾기 및 연결
3. OAuth 인증 완료
4. 필요한 설정 구성
## 인증
이 서버는 OAuth 인증이 필요합니다. 다음이 필요합니다:
- 유효한 [서비스] 계정
- [특정 권한 또는 계정 유형]
## 예시
[아래 최소 3개 예시 섹션 참조]
## 개인정보 보호정책
개인정보 보호정책 참조: https://your-domain.com/privacy
## 지원
- 이메일: [email protected]
- 문서: https://your-domain.com/mcp-docs
- 문제: https://github.com/yourcompany/mcp-server/issues
몇 개의 사용 예시가 필요합니까?
핵심 기능을 보여주는 최소 3개의 작동하는 예시입니다.
좋은 예시로 간주되는 것:
현실적인 사용자 프롬프트/요청을 보여줌
실제 서버 기능을 보여줌
예상 출력 또는 동작 포함
명확하고 이해하기 쉬운 워크플로우
다양한 기능 포함
예시 형식:
## 예시
### 예시 1: 문서 검색
**사용자 프롬프트:** "내 작업 공간에서 최근 프로젝트 보고서 찾기"
**수행되는 작업:**
- 서버가 작업 공간 검색
- 메타데이터가 있는 일치하는 문서 반환
- 빠른 액세스 링크 제공
### 예시 2: 새 콘텐츠 생성
**사용자 프롬프트:** "마케팅 캠페인을 위한 새 작업 목록 생성"
**수행되는 작업:**
- 서버가 새 작업 목록 생성
- 컨텍스트를 기반으로 초기 구조 추가
- 새로 생성된 목록에 대한 링크 반환
### 예시 3: 기존 데이터 업데이트
**사용자 프롬프트:** "프로젝트 상태를 '진행 중'으로 업데이트하고 오늘의 마일스톤 추가"
**수행되는 작업:**
- 서버가 프로젝트 찾기
- 상태 필드 업데이트
- 현재 날짜로 마일스톤 추가
- 변경 사항 확인
요구 사항:
최소 3개 예시(최대 없음)
다양한 도구/기능 포함
현실적인 사용자 상호 작용 표시
가치 제안 시연
서버 문서에 포함
프로덕션 준비 요구 사항은 무엇입니까?
서버는 일반 가용성(GA) 상태여야 합니다.
프로덕션 준비 의미:
서버가 프로덕션에서 안정적이고 신뢰할 수 있음
"베타", "알파" 또는 "개발"로 표시되지 않음
모든 기능이 완전히 구현되고 테스트됨
적절한 오류 처리 및 정상적인 실패
확장 가능한 인프라 및 모니터링
완전한 문서 및 지원 채널
포함될 수 없음: 베타 버전, 개발 서버 또는 제한된 액세스 서비스.
충족해야 할 기술 요구 사항은 무엇입니까?
핵심 기술 규정 준수 표준을 충족해야 합니다.
전송 및 성능:
Streamable HTTP 전송 지원 필수(SSE 지원은 더 이상 사용되지 않을 수 있음)
빠른 응답 시간 및 높은 가용성
도움이 되는 메시지를 포함한 정상적인 오류 처리
토큰 효율적인 응답(도구 결과당 최대 25,000개 토큰)
보안 및 데이터:
유효한 인증서가 있는 HTTPS/TLS
브라우저 클라이언트를 위해 적절히 구성된 CORS
필요한 모든 Claude 클라이언트 원본 지원
기능에 필요한 데이터만 수집
무관한 대화 데이터 수집 없음
개인정보 보호 준수 데이터 관행
3. 제출 프로세스
원격 MCP 서버를 어떻게 제출합니까?
다음 단계별 제출 프로세스를 따르세요:
1. 제출 전 체크리스트:
필수 요구 사항 확인:
[ ] 모든 도구에 readOnlyHint 또는 destructiveHint 주석이 있음
[ ] OAuth 2.0 구현됨(인증이 필요한 경우)
[ ] 서버가 HTTPS를 통해 액세스 가능
[ ] Claude IP 주소가 허용 목록에 있음(방화벽 뒤에 있는 경우)
[ ] 포괄적인 문서 게시됨
[ ] 개인정보 보호정책이 게시되고 액세스 가능
[ ] 전용 지원 채널(이메일 또는 웹)
[ ] 테스트 계정 준비됨(인증이 필요한 경우)
[ ] 서버가 프로덕션 준비됨(GA 상태)
서버 테스트:
[ ] Claude.ai에서 올바르게 작동
[ ] Claude Desktop에서 올바르게 작동
[ ] Claude Code에서 올바르게 작동(IP 제한이 없는 경우)
[ ] OAuth 흐름이 성공적으로 완료됨
[ ] 모든 도구가 문서화된 대로 작동
[ ] 오류 메시지가 도움이 되고 사용자 친화적
[ ] 부하 상태에서 성능이 허용 가능
2. 제출 양식 작성:
제출 양식: MCP 디렉토리 서버 검토 양식
필수 정보: 서버 세부 정보, 문서 링크, 테스트 자격 증명, 예시(최소 3개) 및 연락처 정보. 양식에