M

MILOT 간단 배포 시작하기 — 10분이면 준비됩니다

위에서 아래로 차례대로 따라 하시면 끝납니다. 팀원·관리자·팀리드 모두 하는 1단계입니다.

준비물 — MADUP 계정(@madup.com) · Claude Code(설치되어 있어야 합니다) · GitHub 계정(없으면 회사 메일로 github.com/signup 에서 만듭니다)

1이름을 등록합니다

초대 메일의 링크로 MILOT 간단 배포에 들어와 MADUP 계정(@madup.com)으로 로그인합니다. 이름을 입력하고 [확인] 을 누릅니다. 팀리드는 같은 화면에서 팀 ID 와 알림 슬랙 채널도 정합니다.

파란 안내 띠가 보이면 이름부터 — 이름을 등록해야 연결 키를 발급할 수 있습니다
파란 안내 띠가 보이면 이름부터 — 이름을 등록해야 연결 키를 발급할 수 있습니다

2키 파일을 받아 Claude Code 에 연결합니다

[키 파일 다운로드] 를 누르면 다운로드 폴더에 키 파일이 받아집니다. 이어서 화면에 나오는 문장을 Claude Code 에 그대로 말합니다. 문장에는 내 키 파일 이름이 들어 있습니다.

다운로드 폴더의 kim.marketer_mcp_key.json 에서 how_to_register 칸만 읽고 그대로 claude mcp add -s user 로 MILOT 간단 배포를 연결해 줘. .mcp.json 과 ~/.claude.json 은 건드리지 말고, 키 값은 앞부분도 보이지 않게.

Claude 가 파일을 찾아 등록합니다. 윈도우와 맥 모두 같고, 키를 복사할 일은 없습니다. Claude 가 막히면 아래 상자의 순서대로 직접 합니다.

[키 파일 다운로드] 를 누른 직후 — 목록에 키가 보이고, 키 값과 명령은 화면에 없습니다
[키 파일 다운로드] 를 누른 직후 — 목록에 키가 보이고, 키 값과 명령은 화면에 없습니다
화면의 문장을 말하면 — 키 값은 보이지 않고, 등록이 끝나면 Claude Code 를 다시 열라고 알려 줍니다
예시 화면화면의 문장을 말하면 — 키 값은 보이지 않고, 등록이 끝나면 Claude Code 를 다시 열라고 알려 줍니다

Claude 가 명령을 실행해도 되는지 물으면 [Yes] 를 누릅니다. 파일을 찾지 못하면 다운로드한 위치를 알려 주시기 바랍니다. Claude 가 claude 명령 없음 이라고 하면 PowerShell 에서 irm https://claude.ai/install.ps1 | iex 로 설치하고, PowerShell 을 새로 열어 claude --version 을 확인합니다. Claude 가 막혔다고 하면 Claude 가 보여 주는 등록 명령을 PowerShell 에서 직접 실행합니다. 이 명령에는 키가 들어 있지 않습니다. claude mcp list 에 mate 와 Connected 가 보이면 끝입니다. 키는 서비스마다 1개이고, 등록한 뒤 파일은 지우지 않아도 됩니다. 키 값을 대화에 붙여 넣었다면 화면 목록에서 그 키를 [지우기] 한 뒤 새로 받으시기 바랍니다.

3Claude Code 를 다시 엽니다

Claude Code 를 다시 열어야 MILOT 간단 배포 연동이 적용됩니다. 창을 완전히 닫았다가 다시 엽니다.

4"간단 배포 시작하자" 라고 말합니다

Claude Code 에 간단 배포 시작하자 를 입력합니다. Claude 가 지금 몇 번째 단계인지([1/2] 처럼)와 남은 단계를 보여 주고, 한 번에 하나씩 안내합니다. 이어지는 5~6단계가 GitHub 연동 두 단계입니다.

"간단 배포 시작하자" — 진행 표(✓ 끝난 단계 · ▶ 지금 단계)와 함께 GitHub 연동 화면을 브라우저로 엽니다
예시 화면"간단 배포 시작하자" — 진행 표(✓ 끝난 단계 · ▶ 지금 단계)와 함께 GitHub 연동 화면을 브라우저로 엽니다

5GitHub 연동 1/2 — GitHub 계정 연동

브라우저에 열린 GitHub 화면에서 [Authorize] 를 누릅니다. "GitHub 연동 완료 — Claude Code 로 돌아가시기 바랍니다" 가 보이면 Claude Code 로 돌아와 완료 라고 입력합니다.

GitHub 에 로그인한 상태에서 [Authorize] 를 누릅니다
예시 화면GitHub 에 로그인한 상태에서 [Authorize] 를 누릅니다
이 화면이 보이면 창을 닫고 Claude Code 에 "완료"
예시 화면이 화면이 보이면 창을 닫고 Claude Code 에 "완료"

6GitHub 연동 2/2 — madup-mate 조직 가입

Claude 가 madup-mate 조직(회사 앱 코드를 모아 두는 곳) 초대 페이지를 엽니다. [Join madup-mate] 를 누르고 Claude Code 에 완료 라고 입력합니다. 가입까지 자동으로 끝난 경우에는 이 단계가 바로 지나갑니다.

초대 페이지에서 [Join madup-mate]
예시 화면초대 페이지에서 [Join madup-mate]
"완료" → ✅ GitHub 연동 완료(2/2)
예시 화면"완료" → ✅ GitHub 연동 완료(2/2)

7✅ GitHub 연동 완료(2/2) — 이제 만들면 됩니다

준비가 끝났습니다. 이제 Claude Code 에 하고 싶은 일을 말하면 됩니다. 예를 들면 이렇게 말해 보시기 바랍니다.

"새 앱 만들어 줘"프로젝트를 만들고 서버에 올려 주소(https://<프로젝트>.madup.app)까지 준비합니다

"내 프로젝트 옮겨 줘"내 PC 나 다른 GitHub 에 있던 프로젝트를 MILOT 간단 배포로 옮깁니다

"작업하던 프로젝트 열어 줘"이미 있는 프로젝트를 내 PC 에 받아 이어서 작업합니다

처음 프로젝트를 받을 때 Claude 가 한 번용 코드를 보여 주면, 브라우저에 그 코드를 넣고 [Continue] → [Authorize github] 를 누르시면 됩니다.

막히거나 빨간 글씨가 나와도 Claude Code 에 그대로 물어보면 함께 해결할 수 있습니다. 어렵다면 데이터컨설팅팀(#mkt_milot_comm)에 문의해 주시기 바랍니다. 앱을 만들 때 지키는 것은 앱 개발 원칙, MILOT 간단 배포가 무엇이고 무엇을 할 수 있는지는 MILOT 간단 배포 소개서 에 있습니다.

MILOT 간단 배포 — 데이터컨설팅팀 · https://mate.madup.app/docs/start. 포털 화면은 실제 화면이고, "예시 화면"은 PowerShell · Claude Code · GitHub 화면을 같은 모양으로 그린 것입니다(가짜 계정·키).