본문으로 건너뛰기

비개발자의 첫 토스 미니앱 출시기: 빌드 에러부터 리워드 광고 정책까지

ririm25

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)를 출시했으며, 사용자 반응을 보며 기능을 계속 개선할 계획임.

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기