AIREITERClaude 플러그인 제출 포털을 찾고 있다면 Anthropic 개발자 포털의 claude.ai/directory/manage로 이동하면 됩니다. 현재 제출 경로는 Submit new → Plugin bundle입니다. 다만 실제 디렉터리에 등록하려면 공개 GitHub 저장소, 제출 가능한 요금제와 역할, 그리고 심사 통과가 모두 필요합니다.
현재 Claude 플러그인 제출 경로
공식 제출 절차는 공개 GitHub 마켓플레이스 저장소가 아니라 Anthropic의 플러그인 제출 문서에서 시작합니다. 여러 플러그인이 하나의 저장소에 들어 있더라도 각 플러그인 폴더는 별도로 제출해야 합니다.
| 필요한 항목 | 현재 요구사항 |
|---|---|
| 제출 페이지 | claude.ai/directory/manage |
| 제출 유형 | Plugin bundle |
| 소스 | 목록이 게시되기 전까지 공개 상태인 GitHub 저장소 |
| 접근 권한 | 디렉터리 제출이 허용된 요금제와 역할 |
| 심사 | 검증 및 보안 검사. 일부 버전은 리뷰어 확인 필요 |
| 게시 | 검사를 통과한 버전도 별도로 게시해야 함 |
이 글은 비공개 팀 공유나 로컬 플러그인 설치가 아니라, 공개 디렉터리에 배포하는 과정을 다룹니다.
포털을 열기 전에 준비할 것
포털을 열기 전에 먼저 저장소를 제출 가능한 상태로 정리하세요.
1. 플러그인을 GitHub에 올리기
디렉터리는 github.com의 플러그인을 읽으며, Anthropic은 목록을 게시하기 전에 저장소가 공개되어 있어야 한다고 안내합니다. 플러그인이 저장소 루트가 아닌 하위 폴더에 있다면 해당 경로를 확인해 두세요.
일반적인 Claude Code 플러그인은 다음과 같은 구조를 갖습니다.
plugin-name/
├── .claude-plugin/
│ └── plugin.json
├── .mcp.json # optional
├── commands/ # optional
├── agents/ # optional
├── skills/ # optional
└── README.md디렉터리 목록에 표시되는 정보의 상당 부분은 매니페스트와 README에서 가져옵니다. 제출하기 전에 플러그인의 라이선스와 외부 서비스 사용 여부도 확인하세요.
2. 로컬에서 먼저 검증하기
플러그인 폴더가 들어 있는 디렉터리에서 다음 명령을 실행합니다.
claude plugin validate ./<plugin-folder>이 명령은 구조와 형식 문제를 찾아내지만, 포털의 Validate 단계에서는 추가 검사가 진행됩니다. 로컬 검증은 첫 단계일 뿐, 제출 승인으로 간주하면 안 됩니다.
3. 필요한 경우 MCP 커넥터를 별도로 제출하기
플러그인이 직접 운영하는 원격 MCP 서버를 참조하고 있고 해당 서버가 아직 제출되지 않았다면, Anthropic 가이드에 따라 서버를 MCP connector로 별도 제출해야 합니다. 플러그인 번들과 커넥터는 서로 다른 디렉터리 등록 항목입니다.
플러그인 번들 하나를 단계별로 제출하기
1. Plugin bundle 선택하기
개발자 포털을 열고 Submit new를 선택합니다. 무엇을 제출할지 묻는 화면에서는 Plugin bundle을 고르세요. 원격 MCP 서버를 별도 항목으로 등록할 때만 MCP connector를 선택하면 됩니다.
2. 저장소, 경로, 브랜치 입력하기
Source 단계에서 다음 정보를 입력합니다.
- GitHub URL 또는
owner/repo. - 저장소 루트에
.claude-plugin/plugin.json이 없다면 Plugin path. - 디렉터리가 기본 브랜치가 아닌 다른 대상을 추적해야 한다면 Branch or tag.
태그는 태그를 변경하기 전까지 해당 커밋을 계속 가리킵니다. 브랜치 이름에 슬래시가 들어 있다면 정확히 입력하거나, 공식 제출 가이드에 설명된 owner/repo@branch 형식을 사용하세요.
Validate를 선택합니다. 제출을 막는 문제가 발견되면 저장소를 수정하고 변경 사항을 푸시한 뒤 다시 검증하세요. 검증 결과는 특정 커밋 하나에만 적용됩니다.
3. 생성된 목록 정보 확인하기
Listing details 단계에서는 플러그인이 디렉터리에 어떻게 표시될지 확인할 수 있습니다. Anthropic은 plugin.json과 README에서 이 정보를 가져옵니다.
이름이나 짧은 설명을 고쳐야 한다면 소스 파일을 수정하세요. Anthropic의 공식 플러그인 디렉터리는 게시된 설치 슬러그를 안정적으로 유지해야 한다고도 안내합니다. 사용자가 plugin-not-found 오류를 만날 수 있기 때문입니다. 일반적인 표현만 바꿀 때는 표시 이름을 수정하고, 꼭 필요한 이전 작업일 때만 이름 변경 매핑을 사용하세요.
4. 데이터 처리 관련 질문에 답하기
Data handling 단계에서는 플러그인이 다음과 같은 동작을 하는지 묻습니다.
- 개인 데이터를 읽거나 저장하는지
- 신고된 커넥터 외의 서비스로 데이터를 전송하는지
- 데이터를 보관하는지, 보관한다면 얼마나 오래 보관하는지
- 18세 미만을 대상으로 하는지
실제 구현을 기준으로 답하세요. 원격 서비스, 파일 접근, 텔레메트리, 데이터 보관 정책을 모두 포함해야 합니다.
5. 컴플라이언스 확인 완료하기
Compliance 단계에서는 Anthropic이 연락할 수 있는 이메일 주소를 확인하고 필수 동의 항목을 선택합니다. 플러그인은 Anthropic의 Software Directory 정책을 준수해야 합니다.
6. 제출하고 업데이트 전달 방식 선택하기
Review and submit 단계에서 내용을 확인한 뒤 새 버전을 전달할 방식을 선택합니다.
- 현재 가이드에서 기본으로 선택되는 GitHub push webhook. 설정을 완료하면 푸시 이후 검사를 실행할 수 있습니다.
- Scheduled check only. 추적 중인 브랜치나 태그를 주기적으로 확인하는 방식입니다.
Submit for review를 선택합니다. 웹훅을 설정하려면 GitHub 관리자 권한이 필요합니다. Anthropic은 현재 조직당 24시간 동안 10건의 제출으로 제한하고 있으며, 저장된 초안과 철회한 제출도 이 한도에 포함됩니다. 이 제한과 업데이트 설정은 제출 워크플로에 설명되어 있습니다.
제출 후 진행되는 과정
Anthropic은 추적 중인 브랜치나 태그의 최신 커밋을 검사하고, 디렉터리 검증을 다시 실행한 뒤 보안 검사를 진행합니다. 공식 가이드에 따르면 상태는 다음과 같이 나뉩니다.
| 상태 | 의미 | 다음 단계 |
|---|---|---|
| 모든 검사 통과 | 게시 가능한 버전 | Publish 선택 |
| 리뷰어 확인 대기 | 리뷰어가 발견된 문제를 해소해야 함 | 요청된 변경을 반영하거나 리뷰를 기다림 |
| 검사 불통과 | 포털에 위반 규칙이나 보안 분류가 표시됨 | 저장소를 수정한 뒤 새 커밋을 검사 |
| 거절됨 | 제출이 승인되지 않음 | 요청된 변경을 확인하고 Resubmit for review 사용 |
검사를 통과했다고 해서 곧바로 공개되는 것은 아닙니다. 기본 설정에서는 게시 요청과 리뷰어의 게시 승인이 필요할 수 있습니다. 이후 검사에서 통과한 버전에 대해서는 자동 게시 설정을 사용할 수도 있습니다.
진행 상황을 확인하려면 Submissions에서 플러그인을 열고 Versions를 확인하세요. 수정 후에는 가능한 경우 Check for new commits를 사용하면 됩니다. 업데이트할 때는 추적 중인 브랜치에 푸시하거나 추적 중인 태그를 이동하면 되며, 제출 양식을 다시 작성할 필요는 없습니다. 새 버전이 실패하거나 리뷰를 기다리는 동안에도 마지막으로 게시된 버전은 계속 공개 상태로 유지됩니다.
개발자가 건너뛰면 안 되는 안전 점검
Anthropic 공식 디렉터리는 플러그인에 MCP 서버, 파일, 기타 Anthropic이 통제하지 않는 소프트웨어가 포함될 수 있다고 경고합니다. 제출 전에 모든 외부 서비스, 권한, 보관 기간, 백그라운드 동작을 문서화하세요.
“그러니까, 플러그인 제출이 실패한 이유를 감사하고 문제를 고쳐 달라고 요청했어요.” — @tarasshyn, 제출 실패와 감사 워크플로를 설명한 X 게시물
다음 항목을 최종 점검에 활용하세요.
- 외부로 데이터를 전송하는 모든 서비스를 명시하고 문서화합니다.
- README에 권한, 설정 방법, 데이터 흐름, 보관 기간을 설명합니다.
- 추적 대상 ref에 실제로 게시하려는 코드가 들어 있는지 확인합니다.
- 수정 커밋을 만들 때마다 다시 검증합니다.
- 백그라운드 인덱싱, 텔레메트리, 비용이 큰 자동 동작을 공개합니다.
FAQ: Claude 플러그인 제출
GitHub 저장소를 공개해야 하나요?
네. Anthropic의 현재 문서에 따르면 목록을 게시하기 전에 저장소가 공개 상태여야 합니다.
하나의 저장소에서 여러 플러그인을 제출할 수 있나요?
가능합니다. 다만 각 플러그인 폴더가 별도의 제출 항목이므로 포털에서 해당 경로를 각각 입력해야 합니다.
커뮤니티 저장소에 풀 리퀘스트를 보내 제출할 수 있나요?
아니요. Anthropic의 커뮤니티 마켓플레이스 README는 해당 저장소가 읽기 전용 미러이며 직접 풀 리퀘스트는 자동으로 닫힌다고 설명합니다. 개발자 포털을 사용하세요.
원격 MCP 서버도 별도로 제출해야 하나요?
플러그인이 직접 운영하는 원격 MCP 서버를 참조하고 있고 해당 서버가 아직 등록되지 않았다면, 서버를 MCP 커넥터로 별도 제출해야 합니다.
검증에 실패하면 어떻게 해야 하나요?
저장소를 수정하고 변경 사항을 푸시한 뒤 다시 검증하세요. 검증 결과는 특정 커밋에 적용됩니다. 제출 후에는 가능한 경우 포털의 새 커밋 확인 기능을 사용하면 됩니다.
검사를 통과하면 플러그인이 자동으로 게시되나요?
항상 그런 것은 아닙니다. 검사를 통과한 버전도 Publish 선택과 리뷰어의 게시 승인이 필요할 수 있습니다. 이후 통과한 버전을 어떻게 처리할지는 포털의 자동 게시 설정에 달려 있습니다.
게시된 플러그인을 목록에서 내릴 수 있나요?
가능합니다. 개발자 포털에서 공개 중인 플러그인을 열고 Delist plugin을 요청하세요. Anthropic은 변경 사항이 모든 Claude 앱에 반영되기까지 시간이 걸릴 수 있으며, 기존 사용자는 더 이상 업데이트를 받지 못할 수 있다고 안내합니다.
공개 등록이 목적이라면 가장 짧은 경로는 다음과 같습니다. 저장소를 공개하고, 로컬에서 검증한 뒤, Plugin bundle을 제출하세요. 이후 커밋별 문제를 해결하고 데이터 처리 및 컴플라이언스 단계를 완료한 다음, 검사를 통과한 버전을 게시하면 됩니다. 디렉터리 공개에 따른 검토와 유지보수가 이점보다 크다면 팀 전용 패키지는 비공개로 유지하는 편이 낫습니다.