비개발자의 첫 토스 미니앱 출시기: 빌드 에러부터 리워드 광고 정책까지
2026.10.22
하려던 것 📝
AI를 활용하여 공부 계획 관리 토스 미니앱 '스터디온(StudyOn)'을 기획부터 출시까지 진행한 사례
공부는 해야 하는데 계획을 짜기 어렵거나 꾸준하지 못한 사람을 위한 공부 계획 관리 미니앱을 개발하고자 함.
앱인토스 비게임 출시 가이드(TDS 사용, 라이트 모드, 토스 내비게이션 바, 핀치줌 차단, 자체 뒤로가기 버튼 없음)를 1순위로 지키며 출시하고자 함.
토스 콘솔 MCP를 활용해 앱 등록, 번들 업로드, 테스트 발송까지 자동화하고, 광고(리워드)까지 붙여 수익화를 시도하고자 함.
활용한 툴 ⚒️
Claude Code(데스크톱 앱): 웹 프로토타입 코드 작성 및 수정, 브라우저 화면 검증, 빌드, 앱 정보 초안(부제·상세 설명·키워드·출시 노트) 작성, 광고 정책 사전 검수 목적으로 활용함.
토스 콘솔 MCP: 미니앱 생성, 카테고리 조회, 로고 업로드, 번들(.ait) 업로드, 테스트 푸시 발송, 광고 그룹 상태 조회 목적으로 활용함.
토스 콘솔 웹: MCP로 할 수 없는 첫 검토 제출, 앱 정보 입력, 출시하기를 직접 진행함.
진행 세부 내용 🔍
1️⃣ 공부 계획 관리 미니앱 개발 및 출시
시도한 방법과 접근 방식: 홈(오늘 날짜, 계획 입력, 체크·삭제, 진행률)과 결과 화면("오늘도 수고하셨어요" / "노력하세요" 카드)부터 만들고, 이후 필요한 기능을 하나씩 추가함.
추가한 기능: 월별 달성률 그래프, 어제·내일 날짜 이동, 남은 할 일을 내일로 넘기기(예/아니오), 내일 계획 미리보기, 계획별 시간 선택, 계획 수정, 모든 기록 지우기, 휴대폰(토스 앱 저장소)에 기록 저장.
얻은 결과나 피드백: 2026년 10월 13일 출시(버전 20261013-12)함. 유입 수는 31명임.
2️⃣ 개발 환경 빌드 에러 해결
발생한 문제와 해결 방법:
npm run dev와vite build가 오류 문구 없이 종료됨(종료 코드 -1073740791). 원인을 좁혀 보니 폴더 경로에 한글이 있을 때 Node 24의fs.rmSync가 프로세스를 통째로 죽이는 문제였음.얻은 결과나 피드백: 폴더 이동이나 Node 버전 변경 없이,
vite.config.ts에서 폴더 삭제만 JS 방식으로 바꿔 해결함.
3️⃣ 토스 콘솔 MCP 등록 과정의 제약 해결
발생한 문제와 해결 방법: MCP로 앱을 만들 때 입력 규칙에 연달아 막힘. appName은 영문 소문자·숫자·하이픈만 가능(StudyOn → studyon), 영문 이름은 단어 첫 글자가 대문자여야 함(studyon → Studyon), 부제는 20자 이내여야 함.
추가로 막힌 점: 첫 등록은 앱 정보와 번들을 함께 제출해야 해서, MCP로는 앱 이름만 저장되고 로고·카테고리·소개는 저장되지 않음.
얻은 결과나 피드백: 앱 생성·번들 업로드·테스트 발송은 MCP로, 첫 검토 제출·로고 등 앱 정보 입력·출시하기는 콘솔 웹에서 직접 하는 것으로 역할을 나눠 출시함.
4️⃣ 리워드 광고 적용과 방식 변경
시도한 방법과 접근 방식: 처음에는 결과 화면에 "광고 보고 응원 한마디 받기" 버튼을 넣었으나, 아무도 누르지 않을 것 같아 "오늘 공부 마치기"를 누르면 자동으로 광고가 나오는 방식을 검토함.
발생한 문제와 해결 방법: 리워드 광고는 사용자가 직접 선택해서 보는 형식이라 자동 노출은 정책 위반 소지가 있음을 확인함. 그래서 "광고 보고 결과 확인하기" 버튼을 직접 누르는 방식으로 바꾸고, 응원 한마디는 선택형 광고로 따로 남김.
얻은 결과나 피드백: 광고를 못 불러와도 결과는 광고 없이 보여주도록 처리해 사용자가 막히지 않게 함. 폰 테스트에서 광고가 동작하지 않아, 광고를 한 곳에서 관리하고 앱 시작 시 미리 불러오도록 고침.
5️⃣ 폰 테스트로 찾은 사용성 문제 개선
발생한 문제와 해결 방법: 할 일 1개를 체크하는 순간 결과 화면으로 넘어감 → "오늘 공부 마치기"를 눌렀을 때만 결과로 가도록 수정함.
등록한 계획을 수정할 수 없었음 → 계획마다 수정 버튼을 추가해 내용과 시간을 바꿀 수 있게 함.
테스트할 때 예전에 눌러둔 기록이 그대로 보였음 → 기록은 각자 휴대폰에만 저장된다는 점을 확인하고, "모든 기록 지우기"를 추가함.
6️⃣ 광고 정책 사전 검수와 FAIL 목록
사용한 프롬프트: "지금 내 앱에 광고 있잖아, 앱인토스 광고 정책에 위반되는 사항 없지?"
얻은 결과나 피드백: 앱인토스 개발자 문서 기준으로 점검해 FAIL 4건을 찾음.
테스트할 때 테스트용 광고 ID가 아닌 운영 광고 ID를 사용함(제재 위험).
결과를 광고 뒤에 둬서 핵심 기능을 가로막을 소지가 있음.
사용 연령이 기본값 19세 이상으로 등록됨.
광고를 못 불러올 때 개발용 오류 문구가 사용자에게 보임.
시행착오 ⚠️
MCP로 앱을 만들면 다 되는 줄 알았으나, 첫 등록은 앱 정보와 번들을 함께 내야 해서 로고가 계속 안 들어갔음. 결국 콘솔 웹에서 직접 입력해 해결함.
사용 연령을 고치려고 검토 요청을 취소했더니, 취소한 번들은 다시 검토 요청할 수 없어 같은 내용의 새 번들을 올려야 했음.
광고 그룹을 등록한 뒤 구글 반영(약 2시간)이 끝나야 광고 그룹 ID가 나와서, 그 전에는 광고를 확인할 수 없었음.
테스트에서 운영 광고 ID를 쓰면 제재를 받을 수 있다는 정책을 출시 뒤에야 확인함.
배운 점 📚
토스 콘솔은 MCP로 자동화할 수 있는 작업(생성, 업로드, 테스트 발송)과 콘솔 웹에서만 되는 작업(첫 제출, 로고 등 앱 정보, 출시하기, 사용 연령)이 나뉘어 있어, 시작 전에 이를 알면 시행착오를 줄일 수 있음.
리워드 광고는 사용자가 직접 선택해야 하는 형식이라, 버튼 문구에 "광고 보고 ~"를 명시하고 광고를 못 불러와도 사용자가 막히지 않게 해야 함.
광고를 넣기 전에 정책 문서를 먼저 읽고, 테스트용 ID와 운영 ID를 나눠 두어야 함.
기록이 각자 휴대폰에 저장되는 구조라, 테스트용 초기화 기능이 개발과 사용자 모두에게 필요함.
향후 계획 🧭
계획 수정 기능을 추가한 업데이트(20261014-13)를 출시했으며, 사용자 반응을 보며 기능을 계속 개선할 계획임.



