예시 실습
이 핸즈온랩은 교육 내용을 보여 드리기 위한 예시입니다. 실제 교육과정에서는 고객사의 산업과 직무를 반영한 실습 시나리오로 구성한 비공개 학습 사이트를 따로 제공합니다.
M5-4. Claude 플러그인 변환 — 5분 만에 M365 패키지
한 줄 요약 — Claude Code 플러그인이 있다면 변환 스크립트 한 줄로 M365 패키지를 만들 수 있습니다. 여러 플랫폼에서 함께 쓰려면 Claude 구조(상위 집합)로 개발한 뒤 변환하는 것이 정석입니다.
1. 변환 스크립트
.\Convert-ClaudePluginToMOS3.ps1 -PluginPath ./my-claude-plugin -OutputPath ./output
옵션: -AppId <guid>(GUID 고정) · -DefaultAuthType Auto|None|OAuthPluginVault|ApiKeyPluginVault · -DetailedOutput
2. 변환 매핑표
| Claude 아티팩트 | M365 대응 | 비고 |
|---|---|---|
.claude-plugin/plugin.json |
manifest.json |
이름·설명·author 매핑 · GUID는 UUID v5로 항상 같은 값 생성 |
skills/*/SKILL.md |
agentSkills[] + skills/ |
그대로 복사 — 같은 형식 |
.mcp.json 서버 |
agentConnectors[] |
URL·인증 타입 자동 감지 (외부 HTTPS → OAuthPluginVault 기본) |
color.png/outline.png |
아이콘 | 없으면 플레이스홀더 생성 — 스토어 제출 전 교체 |
3. 변환되지 않는 것
commands/(슬래시 명령) · agents/(서브에이전트) · hooks/ — 아직 지원하지 않음.
settings.json·bin/ — 해당 없음.
4. 크로스 플랫폼 전략
my-plugin/ # Claude 구조로 개발 (슈퍼셋)
├── .claude-plugin/plugin.json
├── skills/*/SKILL.md # ← Claude Code와 M365 양쪽에서 동작
└── .mcp.json
│
└─ Convert-ClaudePluginToMOS3.ps1 → M365 App Store용 ZIP
- 반대로 Cowork 패키지의 스킬을 Claude Code에서 쓰려면
.claude/skills/에 복사하기만 하면 됨 - 2026-07부터는 Customize 화면(문서 표기이며 진입 위치는 앱 버전에 따라 다를 수 있음. 입력창 + > Customize)에서 업로드할 때 Claude ZIP 자동 변환도 지원 (M2-6c) — 스크립트는 CI·대량 변환·세부 제어가 필요할 때 사용
출처
출처: Build plugins — Convert an existing Claude plugin (MS Learn) · What’s New — July 2026