본문 바로가기
Codex 로고

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

Codex는 Capacitor 앱을 빌드하고 배포하며 라이브 업데이트합니다: Mac 없이 iOS와 Android 빌드, 몇 분 안에 OTA 수정, 원클릭 롤백.

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

Codex에서 Capgo 설정하기

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

  1. 1단계

    호스팅된 Capgo MCP 추가

    서버를 추가한 후 로그인하세요. Codex가 브라우저에서 Capgo 동의 페이지를 엽니다. API 키는 필요하지 않습니다.

    터미널
    $ codex mcp add capgo --url https://api.capgo.app/mcp $ codex mcp login capgo

  2. 2단계

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

    Capgo API 키로 한 번 로그인한 후 로컬 서버를 등록하세요. Codex는 두 항목 모두 ~/.codex/config.toml에 저장합니다.

    터미널
    $ npx @capgo/cli@latest login $ codex mcp add capgo-cli -- npx @capgo/cli@latest mcp

  3. 3단계

    Capgo skills 설치하기

    Codex는 .agents/skills에서 skills를 로드합니다. 설치 프로그램이 해당 위치에 자동으로 구성해 줍니다.

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

Codex에게 물어볼 수 있는 질문들

프롬프트를 복사하여 Codex에 붙여넣으세요. 앱 ID와 버전은 본인의 것으로 변경해야 합니다.

  • 빌드

    “Capgo Build를 사용하여 이 앱의 iOS signed release를 빌드해 줘.”

  • 배포

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

  • 업데이트

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

  • 업데이트

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

  • 롤백

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

  • Observe

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

  • Observe

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

  • 업데이트

    “이 빌드를 새 베타 채널에 업로드하고 테스트할 수 있도록 QR code를 줘.”

전체 릴리스 루프

첫 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 살펴보기

Codex 참고 사항 및 제한 사항

  • Codex는 터미널에서 명령을 실행하므로 Capgo CLI로 빌드, 업로드, 롤백까지 모두 할 수 있습니다.
  • 설정 파일을 직접 편집하는 게 좋으신가요? ~/.codex/config.toml에 [mcp_servers.capgo] 항목과 url = "https://api.capgo.app/mcp"를 추가한 다음 codex mcp login capgo을 실행하세요.
  • codex mcp login 단계를 건너뛰지 마세요. 로그인하지 않으면 Codex가 인증 없이 연결되어 Capgo 도구가 계정에 접근할 수 없습니다.
  • 같은 설정을 Codex IDE 확장과 Codex 앱에서 모두 사용할 수 있습니다.

자주 묻는 질문

Capgo와 Codex: 자주 묻는 질문

Mac 없이도 Codex로 iOS 앱을 빌드할 수 있나요?

네. Codex는 Capgo CLI를 실행하여 프로젝트를 Capgo Build에 업로드합니다. Capgo가 클라우드에서 iOS 및 Android 앱을 서명하고 빌드하며, TestFlight 및 Google Play로 전송할 수도 있습니다.

Native Build 문서

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

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

Capgo API 키 생성하기

Codex로 잘못된 업데이트를 롤백할 수 있나요?

네. Codex에게 채널을 이전 번들로 다시 지정해 달라고 요청하세요. 기기는 다음 업데이트 확인 시 전환됩니다. Capgo updater 또한 새 번들 실행에 실패하면 자동으로 롤백을 수행합니다.

Live update 문서

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

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

Codex에서 Capgo를 사용하는 비용은 얼마인가요?

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

요금제

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

Capgo 계정을 만들고 Codex를 연결해 오늘 첫 build 또는 live update을 푸시해 보세요.

문서

관련 페이지