본문 바로가기
Claude Code 로고

Claude Code에서 Capgo로 모바일 앱을 배포하세요

Claude Code가 Capacitor 앱을 빌드하고 게시하고 라이브 업데이트합니다: Mac 없이 iOS 및 Android 빌드, 몇 분 만에 OTA 수정, 클릭 한 번으로 롤백.

  • CLI 에이전트
  • 호스팅 MCP
  • 로컬 MCP
  • 스킬
  • CLI

Claude Code에서 Capgo 설정하기

3단계 이하로 끝납니다. 각 블록을 그대로 복사하세요.

  1. 1단계

    호스팅된 Capgo MCP 추가

    한 번 실행한 뒤 Claude Code에서 /mcp를 입력하고 capgo를 선택한 후 로그인하세요. API 키는 필요 없습니다.

    터미널
    $ claude mcp add --transport http capgo https://api.capgo.app/mcp
  2. 2단계

    빌드 및 업로드를 위한 로컬 CLI MCP 추가

    로컬 서버가 프로젝트를 읽기 때문에 Claude Code에서 번들을 업로드하고 네이티브 빌드를 요청할 수 있습니다. Capgo API 키로 한 번만 로그인하세요.

    터미널
    $ npx @capgo/cli@latest login $ claude mcp add --transport stdio capgo-cli -- npx @capgo/cli@latest mcp
  3. 3단계

    Capgo 스킬 설치하기

    스킬은 Claude Code에 서명, 스토어 업로드, 채널, 마이그레이션 등 Capgo 및 Capacitor 워크플로우를 알려줍니다.

    터미널
    $ npx skills add Cap-go/capgo-skills

Claude Code에게 무엇을 물어볼 수 있나요?

프롬프트를 복사해 Claude Code에 붙여넣으세요. 앱 ID와 버전은 본인 것으로 바꾸세요.

  • 빌드

    “이 앱의 서명된 iOS 릴리스를 Capgo Build로 빌드해줘.”

  • 배포

    “Android 릴리스 빌드를 요청하고 Google Play 내부 테스트 트랙으로 전송해줘.”

  • 업데이트

    “이 변경 사항에 Native Build가 필요한지, 아니면 live update로 배포 가능한지 확인해줘.”

  • 업데이트

    “웹 앱을 빌드하고 이 수정 사항을 프로덕션 채널에 푸시해줘.”

  • 롤백

    “production 채널의 마지막 bundle을 롤백해줘.”

  • Observe

    “v2.3.0 업데이트 통계를 보여줘: 설치된 기기 수와 실패한 기기 수 알려줘.”

  • Observe

    “내 마지막 iOS build가 왜 실패했지? build logs를 읽고 해결 방법을 제안해줘.”

  • 배포

    “최근 10개 커밋의 릴리스 노트와 함께 최신 iOS 빌드를 App Store 심사에 제출하세요.”

전체 릴리스 루프

첫 build부터 다음 라이브 수정까지, 하나의 계정으로 모든 단계를 커버합니다.

  1. 1

    빌드

    클라우드에서 서명된 iOS 및 Android build. Mac이나 Xcode는 필요 없습니다.

    Capgo 네이티브 앱 빌드
  2. 2

    배포

    빌드를 TestFlight와 Google Play로 보내거나 스토어 심사를 위해 제출하세요.

    Mac 없이 iOS 앱 빌드하고 배포하기
  3. 3

    업데이트

    JavaScript, HTML, CSS 수정 사항을 몇 분 만에 채널에 푸시하세요. 클릭 한 번으로 롤백도 가능합니다.

    Capgo Live Update 사용하기
  4. 4

    Observe

    누가 업데이트를 받았는지, 무엇이 실패했는지, 각 릴리스의 성능은 어떤지 확인하세요.

    Capgo Observe 살펴보기

Claude Code 참고 사항 및 제한 사항

  • Claude Code는 터미널에서 명령어를 실행하므로 build, publish, live update, rollback, stats 등 모든 단계를 수행할 수 있습니다.
  • 계정 관련 작업에는 호스팅된 MCP를 사용하고, Claude Code가 프로젝트 파일을 필요로 할 때는 로컬 CLI MCP를 사용하세요. 둘 다 추가할 수 있습니다.
  • 모든 프로젝트에서 서버를 사용하려면 --scope user를, .mcp.json으로 공유하려면 --scope project를 추가하세요.
  • 플러그인이 더 좋으신가요? Capgo skills 레포지토리는 Claude Code 플러그인 마켓플레이스이기도 합니다: claude plugin marketplace add Cap-go/capgo-skills.
  • 데이터를 삭제하거나 덮어쓰는 도구는 destructive로 표시되므로, Claude Code는 실행 전에 먼저 확인을 요청합니다.

자주 묻는 질문

Capgo 및 Claude Code: 자주 묻는 질문

Claude Code가 Mac 없이 제 iOS 앱을 빌드할 수 있나요?

네. Claude Code가 Capgo CLI를 실행해 프로젝트를 Capgo Build에 업로드합니다. Capgo가 클라우드에서 iOS와 Android 앱을 서명하고 빌드하며, TestFlight와 Google Play로 보낼 수도 있습니다.

Native Build 문서

Claude Code를 사용하려면 Capgo API 키가 필요한가요?

호스팅 MCP에는 API 키가 필요 없습니다. OAuth로 로그인하기 때문입니다. 로컬 CLI MCP와 CLI는 npx @capgo/cli@latest login로 한 번만 저장하면 되는 API 키를 사용합니다. 키는 Capgo 콘솔의 Settings > Organization > API keys에서 생성하세요.

Capgo API 키 생성하기

Claude Code가 잘못된 업데이트를 롤백할 수 있나요?

네. Claude Code에게 채널을 이전 bundle로 되돌리도록 요청하세요. 기기는 다음 업데이트 확인 때 전환됩니다. Capgo updater는 새 bundle이 실행에 실패하면 자동으로 롤백합니다.

Live update 문서

App Store와 Google Play에서 Live Updates가 허용되나요?

네, 웹 레이어(JavaScript, HTML, CSS, 에셋)는 가능합니다. Native code, 새 권한, 새 플러그인은 여전히 스토어 출시가 필요하며, Capgo Build로 처리할 수 있습니다.

Claude Code에서 Capgo 사용 시 비용은 얼마인가요?

MCP 서버와 스킬, CLI 모두 무료로 사용할 수 있습니다. Capgo 플랜이 필요하며, 모든 플랜은 신용카드 없이 14일 무료 체험으로 시작합니다. Build, Live Updates, Observe는 모든 플랜에 포함됩니다.

요금제

Claude Code에서 다음 릴리스를 배포하세요

Capgo 계정을 만들고 Claude Code를 연결한 뒤, 오늘 첫 빌드나 live update를 배포해 보세요.

문서

관련 페이지