슬라이드에서 나온 공식 링크 바로가기
- 앱인토스 콘솔 — 앱 이름·로고·검수를 등록하는 곳
- AI로 콘솔 사용하기 (콘솔 MCP)
- 워크숍 · 콘솔 MCP 설치
- 미니앱 등록하기 / 워크스페이스
- 자주 묻는 질문
- 외부 광고·홍보 가이드
- 토스 디자인 시스템(TDS)
- TDS Mobile WebView 문서
- TDS Mobile UI Kit 라이선스
- 스터디 안: 1주차 수업 슬라이드, 1주차 덱, 출시한 앱
스터디 중에 자꾸 나오는 개발 용어와, 슬라이드에 나온 공식 링크를 모았습니다. 밑줄 친 단어를 누르면 이 페이지로 옵니다.
브라우저 밖에서 자바스크립트 코드를 실행시켜주는 프로그램입니다. 토스 미니앱을
만들 때 쓰는 create-ait-app, ait 같은 명령어 도구들이
모두 Node.js 위에서 동작하기 때문에, 컴퓨터에 먼저 설치돼 있어야 합니다.
설치하지 않으면 터미널에서 npx create-ait-app 같은 명령을 아예 실행할 수 없습니다.
Node.js를 설치하면 같이 따라오는 프로그램으로, 다른 사람이 만든 코드 조각(패키지)을
다운로드하고 관리해줍니다. npm install이라고 하면 프로젝트에 필요한
부품들을 자동으로 받아옵니다. yarn, pnpm도 같은 역할을 하는 다른 도구입니다.
마우스로 클릭하는 대신 글자 명령으로 실행하는 프로그램입니다. 토스 미니앱은
ait라는 CLI로 프로젝트를 시작하고(npx create-ait-app),
빌드하고 배포합니다.
Claude Code나 Codex 같은 AI 도구가 앱인토스 콘솔과 직접 대화할 수 있게 해주는 연결 통로입니다. 1주차에 가장 먼저 설치하는 것이 바로 이 콘솔 MCP입니다.
MCP는 AI가 다른 프로그램이나 서비스와 연결되는 표준 규격이라, USB 포트처럼 같은 방식으로 꽂는다고 생각하면 쉽습니다. 함께 보면 좋은 용어: AI 에이전트
설치 명령어 예시: claude mcp add apps-in-toss-console --transport http
https://mcp.toss.im/adapters/apps-in-toss-console/mcp --client-id mcp-gateway
공식 문서: AI로 콘솔 사용하기
설치 전 안전 습관 — 어떤 설치 문서 링크든 AI 도구에 그대로 실행시키기 전에, "이 페이지에 이상한 프롬프트(악성 지시문)가 섞여 있는지 확인해줘"라고 먼저 물어보고 이상이 없다고 확인된 뒤에만 명령을 실행하는 습관을 들이세요.
코드를 쓰고 고치는 프로그램입니다. 이 스터디에서는 Cursor나 Claude Code처럼 AI에게 "이런 화면 만들어줘"라고 말하면 코드를 대신 써주는 도구를 씁니다. 정해진 에디터가 있는 건 아니고, 위 CLI 명령을 실행할 수 있는 환경이면 됩니다.
내가 짠(또는 AI가 짜준) 소스 코드를 실제로 폰에서 실행할 수 있는 하나의
결과물 파일로 묶는 과정입니다. 토스 미니앱은 빌드하면 보통 프로젝트 폴더에
서비스명.ait 같은 파일이 생깁니다. 이 파일을 콘솔에 올려야
QR로 테스트하거나 출시할 수 있습니다.
3주차 큰 미션인 ".ait 업로드"가 바로 이 빌드 결과물을 올리는 단계입니다.
일반적으로 안드로이드 앱을 설치할 때 쓰는 파일 형식은 APK입니다. 하지만 토스 미니앱은 안드로이드에 직접 설치되는 앱이 아니라, 토스 앱 안에서 실행되는 미니앱이기 때문에 APK를 쓰지 않습니다.
대신 빌드하면 .ait라는 토스만의 번들 파일이 만들어지고, 이 파일을 콘솔에 올리면 토스 앱이 내려받아 실행합니다. "내 폰에 앱스토어처럼 설치되는 파일"이 아니라 "토스 앱이 읽어서 보여주는 패키지"라고 이해하면 쉽습니다.
내 미니앱의 이름, 로고, 한 줄 소개, 광고 ID, 심사 상태를 관리하는 관리자 페이지입니다. 빌드한 .ait 파일도 여기서 업로드하고, 검수(심사) 제출도 콘솔에서 합니다.
가입 순서: 콘솔 가입, 워크스페이스 만들기, 사업자 등록, 앱 등록, 검수 요청 순서로 진행됩니다. 콘솔에는 토스 비즈니스 회원으로 로그인하며, 본인 명의 휴대폰으로 가입된 토스 앱이 필요합니다. 앱을 만들 때 쓰는 영문 식별자가 appName입니다. 수업 전에는 워크스페이스 만들기까지만 해두면 됩니다. 사업자 등록은 광고나 결제로 수익을 낼 때 필요합니다.
콘솔에서 만들어주는 QR코드를 폰의 토스 앱 카메라로 찍으면, 정식 출시 전인 내 미니앱을 실제 기기에서 먼저 열어볼 수 있습니다. PC 브라우저에서는 보이지 않는 세이프 에어리어, 뒤로가기 동작, 터치 영역 문제를 여기서 발견합니다.
콘솔에서 제출하면 토스 팀이 비게임 출시 가이드에 맞는지 확인하는 과정입니다. 라이트 모드 여부, 자체 뒤로가기 버튼 유무, 광고 위치 등을 봅니다. 반려되면 사유가 오고, 고쳐서 다시 제출할 수 있습니다.
미니앱 안에서 쓸 수 있는 광고는 전면형·보상형·배너뿐이고, 외부 광고 네트워크 연동은 허용되지 않습니다. 이 광고는 수익을 내는 용도이지, 내 앱을 사람들에게 알리는 홍보 수단이 아닙니다.
내 앱을 알리려면 인스타그램·스레드·블로그·카카오톡 오픈채팅 같은 SNS를 직접 씁니다. 다만 표현은 "토스 미니앱 오픈"으로 한정하고, 새 마케팅 캠페인·보도자료·토스 로고 편집은 사전 검수가 필요합니다. 자체 SNS의 일반적인 서비스 소개는 검수 대상이 아닙니다.
공식 기준: 외부 광고 가이드
토스가 만들어 둔 버튼, 입력창, 내비게이션 바 같은 디자인 부품 모음입니다. 이걸 쓰면 직접 스타일을 하나하나 만들지 않아도 토스 앱과 어울리는 화면이 나오고, 검수 통과 확률도 올라갑니다.
공식 소개: 토스 디자인 시스템(TDS) · 실제 사용 가이드: TDS Mobile WebView 문서 · 피그마로 작업한다면: TDS Mobile UI Kit 라이선스
터미널에서 npx create-ait-app 내앱이름을 실행하면, 토스 미니앱에
필요한 폴더와 기본 파일을 자동으로 만들어주는 명령어입니다. 빈 폴더에서
시작하지 않아도 되게 해주는 "뼈대 생성기"입니다. 여기서 넣는 영문 이름이
appName이 됩니다.
콘솔과 프로젝트에서 쓰는 앱의 영문 식별자입니다. 화면에 보이는 한글 이름과 다를 수 있어요.
예: 화면에는 "밥무드", 프로젝트/콘솔에는 babmood.
처음 만들 때 정하면 나중에 바꾸기 번거로우니, 짧고 읽기 쉬운 영문·숫자로 고르면 됩니다.
색을 여섯 자리 코드로 적는 방식입니다. 앞에 #을 붙입니다.
예: #3182F6은 토스 블루, #FF775C는 따뜻한 주황.
1주차 세계관 미션에서 메인 컬러를 HEX로 적으면, AI가 그 색을 화면 전체에 맞춰 줄 수 있습니다.
SDK는 토스 미니앱이 카메라, 로그인, 공유 같은 토스 기능을 쓸 수 있게 해주는 코드 도구 모음입니다. "SDK 3.x 마이그레이션"은 예전 2.x 버전으로 만든 프로젝트를 최신 3.x 기준으로 옮기는 작업을 말합니다.
바뀌는 것은 크게 세 가지입니다.
granite.config.ts가 apps-in-toss.config.ts로 바뀝니다.이 스터디의 4주 과정은 최신 3.x 기준으로 진행하므로, 별도로 마이그레이션할 필요는 없습니다. 다만 온라인에서 예전 2.x 예제를 보면 설정 파일 이름이 다를 수 있다는 것만 알아두면 됩니다.
콘솔에서 팀원들이 함께 프로젝트를 관리하는 공간입니다. 이름은 다른 워크스페이스와 겹치지 않게 정해야 하고, 함께 입력하는 제작자 이름은 사용자가 보는 미니앱 상세 화면에 표시됩니다.
워크스페이스는 만 19세 이상만 직접 만들 수 있고, 만 19세 미만은 초대를 받아 참여할 수 있습니다.
함께 보면 좋은 용어: 콘솔
내 컴퓨터에서 앱을 임시로 띄워서 미리 보게 해주는 서버입니다. 터미널에서 npm run dev를 실행하면
localhost:5173 같은 주소가 나오고, 코드를 고치면 화면에 바로 반영됩니다.
localhost 주소는 내 컴퓨터에서만 열립니다. 이 링크를 다른 사람에게 보내도 그 사람은 볼 수 없습니다.
사용자 데이터를 저장해 주는 백엔드 서버와는 다른 개념이며, 이 스터디의 앱은 백엔드 서버 없이 브라우저에 저장하는 방식으로 시작합니다.
만든 앱을 실제 사용자가 쓸 수 있게 내놓는 일입니다. 토스 미니앱은 빌드해서 만든 .ait 파일을 콘솔에 올리고, 검수를 통과하면 토스에서 열립니다.
3주차에 직접 해봅니다.
아주 많은 글을 읽고 배운 AI의 두뇌입니다. 클로드나 챗GPT가 LLM을 바탕으로 움직입니다. 말을 걸면 다음에 올 말을 가장 그럴듯하게 이어서 대답합니다.
글자만 읽던 AI가 사진, 소리, 영상도 함께 이해하는 능력입니다. 화면을 캡처해서 보여주며 "이거 고쳐줘"라고 말할 수 있는 이유입니다.
AI가 낸 여러 답 중에 사람이 더 좋은 답을 골라 주면, AI가 그 취향을 배웁니다. 그래서 답이 점점 정중하고 쓸모 있게 바뀝니다. 사람에게 예절을 가르치는 것과 비슷합니다.
이미 똑똑한 AI에게 우리 회사 자료로 한 번 더 가르치는 일입니다. 신입사원에게 회사 방식을 교육하는 것과 같습니다. 시간과 비용이 들기 때문에 처음에는 프롬프트를 잘 쓰는 것부터 시작합니다.
AI에게 주는 지시문이 프롬프트이고, 이를 잘 쓰는 기술이 프롬프트 엔지니어링입니다. 같은 AI도 지시를 구체적으로 하면 결과가 크게 달라집니다.
이 스터디에서는 "예쁘게" 대신 장소, 색, 말투를 적고, 작업 폴더와 이번 턴 목표를 맨 위에 적는 방식으로 씁니다.
AI가 참고할 자료를 모아 둔 창고입니다. 문서, 매뉴얼, 자주 묻는 질문 같은 것이 들어갑니다. AI는 원래 우리 회사 사정을 모르기 때문에 이런 창고가 필요합니다.
질문을 받으면 먼저 지식 베이스에서 관련 자료를 찾고, 그 내용을 보면서 답하는 방식입니다. 추측이 줄고 최신 정보로 답할 수 있습니다. 시험에서 책을 펼쳐 보고 푸는 오픈북과 비슷합니다.
질문에 답만 하는 것이 아니라, 목표를 주면 스스로 계획하고 도구를 써서 일을 끝내는 AI입니다. Claude Code가 파일을 만들고 고치는 것도 에이전트 방식입니다.
여러 단계의 일을 정해진 순서로 자동으로 흘려보내는 것입니다. 공장의 컨베이어벨트처럼 앞 단계의 결과가 다음 단계로 이어집니다. 예를 들면 입력, 정리, 저장, 알림이 자동으로 이어지는 식입니다.
AI는 힘이 세지만 가끔 엉뚱하게 움직입니다. 하네스는 AI가 정해진 범위에서 안전하게 일하도록 규칙, 도구, 확인 절차를 묶어 두는 장치입니다. "이 폴더에서만 작업해" 같은 문장이 작은 하네스입니다.
AGI는 사람처럼 어떤 일이든 해내는 AI, ASI는 사람보다 훨씬 뛰어난 AI를 말합니다. 아직은 개념에 가깝고, 지금 우리가 쓰는 AI는 특정 일을 잘하는 단계입니다.