클로드 플러그인 사용방법은 연결 기능을 만들고 공개 전 점검을 거쳐 Claude 디렉터리에 제출하는 흐름으로 이해하면 됩니다. 2026년 10월 2일 기준으로 제출 경로와 자동 검사, 공개 전 체크리스트를 정리합니다.
“플러그인을 만들었는데 어디에 올려야 하죠?” Claude를 업무에 연결해 반복 작업을 줄이려는 소규모 팀 운영 담당자라면, 기능 개발만큼이나 제출·자동검사·승인·공개 순서를 확인해야 합니다. 플러그인은 앱에 기능을 붙이는 어댑터처럼 MCP 커넥터나 Agent Skills를 묶어 Claude에서 쓰게 하는 확장 단위입니다.
1. 플러그인과 단일 커넥터 구분하기
먼저 만들려는 것이 하나의 원격 MCP 커넥터인지, 여러 구성요소를 묶은 플러그인 번들인지 나눕니다. MCP는 Claude와 외부 도구가 정해진 약속에 따라 대화하도록 돕는 연결 규격입니다. 콘센트와 플러그인처럼 연결 규격이 맞아야 데이터와 기능을 주고받습니다.
Anthropic의 안내에 따르면 단일 MCP 커넥터는 원격 MCP 서버를 지정해 제출하는 방식입니다. 플러그인 번들은 MCP 서버와 스킬을 조합하고 GitHub 저장소에 두어 제출합니다. Claude Code 플러그인에는 LSP, 명령, 훅, 에이전트 같은 요소도 들어갈 수 있습니다. 즉, 도구 하나를 연결하는지 업무 절차까지 꾸려서 배포하는지에 따라 준비물이 달라집니다.
업무 흐름을 여러 단계로 자동화하려면 플러그인 번들이 적합하고, 단일 서비스 연결이 목적이면 커넥터부터 검토합니다. 다만 기능이 많다는 이유만으로 번들로 시작할 필요는 없습니다. 사용자가 실제로 반복하는 한 가지 일을 정하고, 그 일을 끝내는 데 필요한 최소 구성으로 시작합니다.
2. 제출 전에 준비할 자료
제출 전에 먼저 저장소와 테스트 경로를 정리합니다. 공개 디렉터리에 플러그인 번들을 내는 경우, 제출 안내는 공개 GitHub 저장소 링크를 요구합니다. 비공개 저장소는 제출 대상이 아닙니다. Claude Code 환경에서는 제출 전에 claude plugin validate를 실행해 형식과 구조를 점검하라고 안내합니다.
검증은 자동차 출고 전 계기판을 확인하는 과정과 비슷합니다. 파일 구조가 맞는지, 필요한 설명과 연결 정보가 빠지지 않았는지 미리 확인하면 제출 후 되돌아오는 수정 요청을 줄일 수 있습니다. 다만 검증 통과가 기능의 안전성이나 사용성을 보증하는 것은 아닙니다.
- GitHub 저장소가 공개 상태인지 확인합니다.
- 저장소 설명과 사용 방법을 처음 보는 사람이 따라 할 수 있게 작성합니다.
- 외부 서비스 연결과 데이터 처리 범위를 확인하고, 이용자에게 필요한 안내를 준비합니다.
- 대표 업무 사례를 직접 실행해 기대한 결과가 나오는지 테스트합니다.
- 검증 명령의 오류와 경고를 확인하고, 제출할 버전을 정리합니다.
테스트 계정이나 민감한 업무 데이터를 저장소에 올리지 않습니다. 실제 사용자 데이터 대신 목적에 맞는 샘플 데이터를 준비하고, 어떤 정보가 외부 서버로 전달되는지 확인해야 합니다. 플러그인이 실행하는 동작은 이용자의 권한으로 수행될 수 있으므로, 연결 범위와 부작용도 문서에 구체적으로 적습니다.
3. 제출부터 공개까지 진행하기
절차는 ‘형식 점검 → 포털 제출 → 검토 상태 확인 → 승인 후 공개’ 순서입니다. Anthropic은 2026년 9월 25일 개발자 포털을 안내하면서 제출 후 자동 검증과 안전 스캔을 제공하고, 검토 상태와 피드백을 포털에서 확인할 수 있다고 밝혔습니다. 검토가 끝나 승인되면 공개 시점을 선택하는 흐름입니다.
- 유형을 선택합니다. 단일 MCP 커넥터인지, MCP 서버와 스킬을 묶은 플러그인 번들인지 결정합니다.
- 제출 자료를 정리합니다. 번들이라면 공개 GitHub 저장소와 검증된 구성 파일을 준비합니다.
- 개발자 포털에서 제출합니다. 로그인과 제출 권한이 있는 계정으로 제출 양식을 작성합니다. Anthropic은 포털 제출 경로를 안내하며, 계정 유형과 권한 조건은 제출 화면에서 확인해야 합니다.
- 자동 검사와 검토 피드백을 확인합니다. 오류나 보완 요청이 있으면 내용을 반영하고 다시 검토받습니다.
- 승인 후 공개합니다. 공개를 결정하기 전에 설명, 연결 범위, 테스트 결과를 마지막으로 확인합니다.
여기서 중요한 구분이 있습니다. ‘제출했다’는 것은 누구나 바로 쓸 수 있게 공개됐다는 뜻이 아닙니다. 포털에서 심사 상태를 확인하고, 승인된 뒤 공개 단계를 진행해야 합니다. 검토 시간은 신청 물량에 따라 달라질 수 있으므로 공개 날짜를 확정된 일정처럼 안내하지 않습니다.
4. 자동 검사 결과를 읽는 기준
안전 스캔은 공항 보안 검색대처럼 알려진 위험 신호를 찾아내는 절차입니다. 위험한 동작을 놓치지 않도록 돕지만, 검색대를 통과했다고 모든 상황에서 안전하다는 뜻은 아닙니다. 검사 결과를 ‘통과/실패’ 한 줄로 끝내지 말고 실제 권한과 데이터 흐름을 사람이 살펴야 합니다.
플러그인이 로컬 도구를 실행하는지, 원격 MCP 서버와 통신하는지, 어떤 데이터가 전달되는지 확인합니다. 저장소 안의 스크립트가 문서에 적힌 목적과 같은 일을 하는지 직접 점검합니다. 사용자는 플러그인을 신뢰할 수 있는 출처에서 선택해야 하며, 개발자는 연결 기능과 외부 소프트웨어 설치 여부를 숨기지 말아야 합니다.
검사 경고가 나오면 다음 순서로 처리합니다.
- 경고가 가리키는 파일과 동작을 확인합니다.
- 해당 코드가 필요한 이유와 실행 범위를 문서와 대조합니다.
- 불필요한 권한이나 파일 접근을 제거하고, 외부 전송 항목을 최소화합니다.
- 수정한 버전으로 다시 검증한 뒤 결과를 기록합니다.
자동 스캔은 사람의 검토를 대체하지 않습니다. 특히 파일 접근, 네트워크 통신, 인증 정보 취급은 샘플 업무를 직접 실행해 결과를 확인합니다. 확인할 수 없는 동작이 남아 있다면 공개를 서두르지 않는 편이 안전합니다.
5. 팀 업무에 맞는 공개 전 점검표
공개 전에는 기능 목록보다 사용자의 업무 장면을 기준으로 점검합니다. 사용자가 어떤 자료를 넣고, 플러그인이 무엇을 읽고, 어떤 결과를 어디에 돌려주는지 한 문장씩 설명할 수 있어야 합니다.
| 점검 항목 | 확인 질문 | 확인 결과 |
|---|---|---|
| 업무 목적 | 누구의 어떤 반복 업무를 줄이는가? | 한 문장으로 설명 |
| 입력 데이터 | 무엇을 읽고 외부로 전달하는가? | 민감정보 여부 확인 |
| 권한과 실행 | 파일·계정·네트워크 접근이 필요한가? | 최소 권한으로 테스트 |
| 사용 안내 | 설치와 첫 실행을 따라 할 수 있는가? | 초보 사용자로 점검 |
| 오류 대응 | 연결 실패나 잘못된 결과를 어떻게 알리는가? | 실패 사례도 시험 |
체크리스트에서 답이 비어 있는 항목은 문서화하거나 기능을 줄입니다. 특히 내부에서 쓰던 줄임말과 권한 가정은 외부 이용자에게 그대로 통하지 않습니다. 개발자가 당연하게 여기는 조건을 설치 안내에 적어야 사용자가 처음부터 다시 추측하지 않습니다.
자주 묻는 질문
공개 GitHub 저장소가 꼭 필요한가요?
플러그인 번들을 디렉터리에 제출할 때 공식 안내는 공개 GitHub 저장소 링크를 요구하며 비공개 저장소는 받지 않는다고 설명합니다. 단일 원격 MCP 커넥터 제출은 번들과 경로가 다를 수 있으므로 포털의 현재 양식을 확인합니다.
자동 검사를 통과하면 바로 공개되나요?
아닙니다. 자동 검사는 제출 과정의 확인 단계입니다. 검토 상태와 피드백을 확인하고 승인을 받은 뒤 공개를 진행합니다.
승인까지 며칠 걸리나요?
검토 시간은 대기 물량에 따라 달라집니다. 공식 안내는 일정한 처리 기간을 보장하지 않으므로 특정 날짜를 약속하지 말고 개발자 포털에서 상태를 확인합니다.
핵심 정리
1. 단일 커넥터와 플러그인 번들을 먼저 구분합니다.
2. 공개 저장소와 검증, 데이터·권한 점검을 제출 전에 마칩니다.
3. 자동 검사와 검토 피드백을 확인하고 승인 뒤 공개합니다.
출처
글쓴이 나미리 — AI 실무 강사 · 한국AI콘텐츠연구소 전임강사. 기업·공공기관 대상 생성형 AI 업무 활용 강의를 합니다. 강사 소개
함께 보면 좋은 채널
- AI 강사 나미리 공식 홈페이지 — 강의 커리큘럼 및 강의 문의
- 네이버 블로그 — AI 활용 팁과 강의 현장 이야기
'IT·인터넷' 카테고리의 다른 글
| AI 에이전트 권한 설계, 입력과 도구와 검색 데이터의 경계 점검 (2) | 2026.10.05 |
|---|---|
| 클로드 프로젝트 지침 팀 자료를 연결하고 공유 전 점검하는 방법 (0) | 2026.10.05 |
| 제미나이 음성호출과 라이브 아바타 상담 AI를 설계하는 방법 (0) | 2026.10.02 |
| 클로드 코워크 채팅 차이 통합된 Claude에서 달라진 작업 방식 (0) | 2026.10.01 |
| 2026년 AI 에이전트 시장, 메타 '뮤즈'가 이끄는 변화와 기회 (0) | 2026.09.30 |