사용 설명서 > 개발자 문서 > 검증과 올리기
MCP 연결로 AI가 직접 만들고 저장하기
사용하는 AI가 MCP(Model Context Protocol)를 지원하면 번들을 복사해 붙여 넣지 않아도 됩니다. AI가 규격을 직접 읽고, 번들을 만들고, 검증 오류를 스스로 고쳐 새 앱 초안으로 저장합니다. 번들을 만드는 데 드는 AI 비용은 사용하는 AI 쪽에서 부담합니다.
준비
- 설정의 "MCP 연동"에서 AI를 연결하고, 쓰기 권한(mcp:write)을 허용합니다. 읽기 전용으로 연결하면 규격 읽기만 되고 저장은 되지 않습니다.
- 저장(create_app_from_bundle)은 외부 코드 올리기와 같은 조건입니다. 유료 플랜에서만 열립니다.
도구
| 도구 | 하는 일 |
|---|---|
| get_app_spec | 번들 작성 규격 전문(markdown) 또는 JSON Schema를 돌려줍니다. 앱을 만들기 전에 한 번 읽습니다. |
| create_app_from_bundle | 번들을 검증하고, 통과하면 새 앱 초안으로 저장합니다. dry_run=true 면 저장 없이 검증만 합니다. |
| validate_app | 이미 만든 앱의 초안이나 수정 후보 번들을 검증합니다. |
| update_app | 앱 초안을 부분 수정합니다. 저장 전에 전체를 다시 검증합니다. |
| publish_app | 초안을 게시합니다. 늘어나는 권한은 사용자가 확인해야 합니다. |
작업 흐름
- AI가 get_app_spec 으로 규격을 읽습니다.
- 사용자가 원하는 앱을 설명하면 AI가 번들을 만들어 create_app_from_bundle 을 dry_run=true 로 호출합니다.
- 오류가 돌아오면 errors(오류 코드와 고치는 법)와 diagnostics(파일·줄·열)를 보고 AI가 번들을 고쳐 다시 호출합니다.
- 통과하면 dry_run 없이 새 idempotency_key 와 함께 호출해 저장합니다. 미리 보기와 게시는 앱빌더 화면이나 publish_app 으로 합니다.
안전장치
- 저장은 항상 새 초안입니다. 기존 앱을 덮어쓰지 않고 자동 게시하지 않습니다.
- 같은 idempotency_key 로 재시도하면 앱이 하나만 만들어집니다. 번들을 고쳐 다시 저장할 때는 새 키를 씁니다.
- 서버 기록에는 업로더, 크기, 해시만 남기고 번들 본문은 남기지 않습니다.
- 검증기는 외부 올리기 화면과 같습니다. 화면에서 통과하는 번들은 MCP 에서도 통과합니다.
MCP를 지원하지 않는 LLM이나 외주 개발사가 만든 결과는 "외부 코드 올리기" 화면에 붙여 넣거나 파일로 올립니다.