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	최대 4개의 `api_token` 선언(현재 앱 화면은 고급 source 흐름에서 설정)
background 주기	15~10,080분

Builder는 ID, 이름, 설명, version, capability 제목과 runtime 설정을 입력받아 최소 Manifest와 Runtime v1 UI를 만듭니다. UI 코드를 생성하거나 외부 코드를 실행하지 않습니다.

Builder가 적합한 예

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

소스 프로젝트로 전환할 때

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

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

시작하기의 @morit/cli plugin setup으로 프로젝트를 만들고 Builder에서 정한 ID와 capability 이름을 유지하면 사용자가 기능을 다시 익힐 필요가 없습니다. 기존 설치를 업데이트할 때는 publisher와 서명 identity, plugin ID, semantic version 순서를 유지해야 합니다.

실제 확인

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

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

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