MoringDocs
대시보드
Morit Plugin1. 시작과 개발 흐름

Morit Plugin 개발 문서

이 문서는 아이디어를 실제 설치 가능한 .mplg로 만드는 순서대로 구성되어 있습니다. 플러그인은 실행 코드를 앱에 직접 주입하지 않습니다. Manifest와 JSON fragment로 기능·화면·권한을 선언하고, Morit Host가 서명과 계약을 확인한 뒤 공용 런타임으로 실행합니다.

가장 짧은 개발 경로

text
요구사항 정리
  → 프로젝트 생성
  → manifest와 기능 fragment 작성
  → 화면·상태·내비게이션 작성
  → 권한·설정·알림 연결
  → validate
  → preview
  → build
  → verify
  → 실제 앱 설치·실사용 테스트
  → deploy

공식 CLI를 사용하는 기본 명령은 다음과 같습니다.

bash
npx -y @morit/cli plugin setup . \
  --id com.example.study \
  --name "Study" \
  --publisher example
npx -y @morit/cli plugin validate .
npx -y @morit/cli plugin preview . --output ./dist/preview.html
npx -y @morit/cli plugin build .
npx -y @morit/cli login
npx -y @morit/cli plugin add .
npx -y @morit/cli plugin deploy . --visibility private

같은 safe renderer는 공식 CLI, Local/Remote Plugin MCP의 morit_project_preview, 저장소 도구 python tools/morit_plugin.py preview <project>에서 사용합니다. preview의 라이트·다크 전환으로 계약과 배치를 확인하고, 실제 Flutter focus·navigation·Tool 흐름은 앱에서도 확인합니다.

개발 순서별 인덱스

1. 시작과 개발 흐름

  1. 시작하기와 개발 흐름 — 개발 방식 선택, 첫 프로젝트, 완료 조건
  2. 앱에서 플러그인 만들기 — 단순 Tool을 앱 Builder로 만드는 범위

2. 프로젝트와 계약

  1. 프로젝트 구조와 fragment — 디렉터리, 병합 규칙, 패키지 포함 파일
  2. Manifest 레퍼런스 — ID, 버전, capability, connector, dependency
  3. Instance, Connector, 복합 패키지 — 사용자별 실행 단위와 계정 연결

3. 화면과 사용자 경험

  1. 화면, 레이아웃, 내비게이션 — 화면 역할과 이동 구조
  2. 기본·커스텀 컴포넌트 — 각 node의 목적, 속성, 제약
  3. 토큰, 크기, 색, 여백, 반응형 — Material 3 기반 시각 규칙
  4. 화면 분리와 정보 계층 — 한 화면에 정보를 몰지 않는 설계
  5. UI extension point — Host의 어느 위치에 UI를 노출할지 선택
  6. UI Runtime v2 레퍼런스 — data, state, binding, event 계약
  7. Response UI와 Agent Timeline — AI 메시지 안의 결과 UI

4. 기능, 데이터, 사용자 제어

  1. Tool, Skill, Search, Slash Command — capability와 runtime adapter
  2. 권한, 설정, 저장소, 알림 — 최소 권한과 Host action
  3. Plugin Local Storage와 AI 접근 — namespace, CRUD, migration, 격리, AI Tool
  4. 외부 서비스 인증과 Cloud Secrets — OAuth, API key, 비밀 값 경계
  5. AI Skill과 파일 산출물 — 실제 파일을 반환하는 완료 흐름

5. 플랫폼

  1. Android, iOS, Desktop 호환 — 현재 지원 범위와 이식 원칙

6. 검증과 배포

  1. 공식 CLI 개발 흐름 — setup, sync, preview, build, deploy
  2. 패키징과 테스트 — 서명, 무결성, 테스트 층
  3. 오류 해결 — validate, preview, build, 설치, 실행 오류 구분
  4. 예제 검증 방법과 확인 경계 — 자동·live·실기기 검증의 차이

7. SDK, MCP, API

  1. CLI와 AI 에이전트 MCP — Codex·Claude 등 로컬/원격 연결
  2. 원격 Plugin MCP — Cloud Project를 다루는 Tool 계약
  3. 수명주기와 HTTP API — Host API와 설치·실행 상태

8. 실제 예제

  1. 학교 생활 플러그인 — 공개 NEIS와 AI 할 일을 사용하는 학생용 경험
  2. 학교 생활 개인정보 처리 — 저장·전송·삭제 범위
  3. Notion 플러그인 — OAuth Connection과 실제 문서 검색

문서가 배포되는 위치

docs/plugin_docs가 문서 콘텐츠의 공통 원본입니다. 같은 파일이 다음 위치에 복사되거나 빌드 시 포함됩니다.

  • @morit/cli: npm 패키지의 assets/docs
  • Local MCP @morit/plugin-mcp: npm 패키지의 assets/docs
  • Remote MCP: 서비스 이미지의 /app/docs/plugin_docs
  • developers.moring.co: docs-index.json의 순서와 경로로 생성한 MDX

네 배포 위치는 같은 계약과 예제를 제공하며, 문서의 JSON은 공식 CLI와 Host 계약으로 지속 검증합니다. 각 경로에서 별도 규격을 정의하지 않습니다.