Morit Plugin1. 시작과 개발 흐름

앱에서 플러그인 만들기

Plugin Builder는 개발 환경 없이 작은 Tool 또는 Skill을 만드는 경로입니다. Builder도 일반 .mplg를 생성하고 같은 설치·권한·삭제 흐름을 사용하지만, 안전하게 표현할 수 있는 범위를 의도적으로 제한합니다.

지원 범위

항목	지원 값
capability kind	`tool`, `skill`
runtime	`text_stats`, `text_template`
UI 위치	`card`, `screen`, `settings` 중 최대 3개
선택 기능	Search Provider, Slash Command, background, notification
권한	`background`, `notifications`
credential	앱 Builder에서는 만들 수 없음. API token이 필요하면 CLI 프로젝트를 사용
background 주기	15분, 1시간, 6시간, 24시간 중 선택

Builder는 ID, 이름, 설명, version, capability 제목과 runtime 설정을 입력받아 최소 Manifest와 고정된 카드·설정 UI(ui_schema가 없는 legacy 선언형 UI)를 만듭니다. UI 코드를 생성하거나 외부 코드를 실행하지 않습니다.

Builder가 적합한 예

입력 텍스트의 길이와 단어 수를 계산하는 Tool
정해진 템플릿으로 회의 메모를 정리하는 Skill
settings의 작은 정적 목록을 Search Provider로 노출
정해진 문구를 일정 주기로 알리는 개인 알림

소스 프로젝트로 전환할 때

다음 중 하나가 필요하면 공식 CLI 프로젝트를 사용합니다.

Runtime v3의 화면·내비게이션·theme·Response UI
외부 HTTPS API, OAuth, Remote MCP
여러 데이터 source와 동적 목록
sandbox_python 데이터 처리
child package와 dependency
Cloud Secret, Connector retry/rate-limit
package asset, 이미지, 복수 source file

Builder 패키지를 소스 프로젝트로 가져오는 기능은 없습니다. 시작하기의 @morit/cli plugin setup으로 새 프로젝트를 만들고, 같은 capability 이름을 쓰면 사용자가 기능을 다시 익힐 필요가 없습니다. Builder 패키지는 publisher와 서명 identity가 CLI 프로젝트와 다르므로, CLI로 만든 패키지는 기존 Builder 설치의 업데이트가 아니라 별도 플러그인으로 설치됩니다.

실제 확인

Builder 생성 성공만 확인하지 말고 다음을 앱에서 실행합니다.

생성 직후 설치 목록에 나타나는지
필요한 권한을 거부했을 때 기능이 실행되지 않는지
Tool/Skill과 Slash Command가 정확한 capability를 호출하는지
background/notification을 켜고 끌 수 있는지
설정 변경 후 다시 열었을 때 유지되는지
삭제 후 pending 알림과 credential이 정리되는지

고급 화면 개발은 화면, 레이아웃, 내비게이션부터 시작하세요.