본문 바로가기
Capgo CLI + MCP

모든 것을 하나로 아우르는 CLI + MCP

라이브 업데이트, 네이티브 빌드, 호환성 검사, 디바이스 실행, MCP를 통한 AI 지원 Capgo 자동화까지 하나의 도구로 해결하세요.

CLI 문서 읽기 실행 모습 보기 ↓
✓ AI 에이전트용 MCP 도구 ✓ OTA 또는 Native Build 출시 체크 ✓ 같은 터미널에서 Signed build
Capgo CLI

한 터미널 세션에서 출시 체크, 안전한 upload, Native Build를 처리하세요.

npx @capgo/cli bundle releaseType
애니메이션 예시 — 탭으로 명령 흐름 전환
CLI 검증

터미널에서 프로덕션까지, 신뢰할 수 있는 릴리스 워크플로우

Capgo를 사용해 Capacitor 업데이트, Native Build, 릴리스 제어를 하는 팀들의 짧은 후기입니다.

5.0/5 개발 팀 평점 9,400+ 팀 리뷰 보기

설정하는 데 하루도 안 걸렸어요. 채널 기반 롤아웃 덕분에 프로덕션 사용자에게 배포되기 전에 제 기기에서 먼저 테스트할 수 있어요.

네이트 판 졸 Private CTO

특정 그룹에 Device ID를 추가하고 해당 그룹에만 변경 사항을 푸시할 수 있다는 건 정말 큰 도움이 됩니다.

no-tone @ Webincode Webincode 개발자
솔직한 비교

Capgo CLI vs. 다른 대안

릴리스 작업은 같아도 자동화는 다릅니다.

Capgo CLI DIY / 수동 스크립트, Fastlane, 대시보드 클릭 경쟁사 클라우드
CLI 릴리스 단 하나의 CLI. OTA 업로드, 네이티브 빌드, 채널, 호환성, 디바이스 실행, MCP를 동일한 터미널에서 처리합니다. 직접 관리해야 하는 개별 스크립트, curl 작업, Fastlane 레인, 일회성 API 호출. 1급 CLI가 없습니다. 릴리스는 대시보드나 git 트리거 플로우에 머물러 있습니다.
AI 에이전트 자동화 내장 MCP. 앱, 번들, 채널, 빌드, 통계, 진단을 Codex, Cursor, Claude Code 및 기타 에이전트에 노출합니다. 자체 툴링을 구축하고 유지보수하지 않는 한 아무것도 없습니다. MCP 서버가 없습니다. 에이전트가 대신 릴리스를 진행할 수 없습니다.
OTA vs 네이티브 결정 명시적 명령. bundle releaseType은 배포 전 OTA가 안전한지, Native Build가 필요한지 알려줍니다. 네이티브 diff를 수동으로 검토하거나 팀 내 지식에 의존해야 합니다. 대시보드는 기껏해야 힌트만 줍니다. 긴박한 상황에서는 잘못 판단하기 쉽습니다.
안전한 OTA upload CI를 통한 방식. 호환성 체크, delta 지원, 암호화 및 QR 미리보기 링크를 포함한 bundle upload. 수동 zip upload 또는 직접 작성한 체크 로직이 포함된 API 스크립트. Portal upload 또는 git hook. 터미널에서 사전 검사가 제한적입니다.
Native Build 요청 동일한 터미널에서. 출력 레코드, QR 링크, 셸로 스트리밍되는 logs를 포함한 build request. 직접 관리하는 Mac에서 Xcode, Android Studio 또는 Fastlane을 실행해야 합니다. git에 push하거나 대시보드에서 클릭하세요. CI에서 스크립트로 다룰 수 있는 빌드 기록은 없습니다.
CI 통합 스크립트 기반 출력. 파이프라인에서 게이트 조건으로 쓸 수 있는 JSON 빌드 기록, exit code, QR 아티팩트. 모든 단계와 secret, 아티팩트 경로를 직접 연결해야 합니다. 웹훅은 일부만 지원됩니다. 대부분의 팀은 여전히 릴리스를 수동으로 조율합니다.
호환성 체크 업로드 전. CLI가 native 의존성을 스캔해 OTA가 안전하지 않으면 조기에 실패합니다. 직접 만들지 않으면 가드레일이 없습니다. 기본 bundle 검증만 수행합니다. Native drift를 놓치기 쉽습니다.
무료로 체험하기 네. 14일간 무제한 무료 체험. 카드 등록이 필요 없습니다. 스크립트를 유지하는 데 드는 시간을 계산하기 전까지만 저렴합니다. 계층형 플랜. 체험 기간은 벤더마다 다릅니다.

비교 데이터는 일반적인 DIY/수동 설정 및 경쟁사 클라우드 문서를 기준으로 합니다.

Martin 드림

Capgo CLI가 중요한 이유

Capgo 창립자 Martin이 터미널에서 Capacitor 릴리스를 배포하고, 푸시 전 호환성을 확인하며, 네이티브 빌드를 같은 워크플로우에 유지하는 방법을 이야기합니다.

Martin, Capgo 창립자

커맨드 흐름

설정부터 적절한 릴리스 방식 선택까지

Capgo CLI 명령어는 중요한 릴리스 분기를 명확히 합니다: 웹 레이어가 바뀌면 live update, 앱 바이너리를 새로 배포해야 하면 Native Build를 사용하세요.

OTA 경로

웹 번들이 안전하게 업데이트될 수 있다면 호환성 게이트와 프리뷰 QR 링크를 활용하세요.

네이티브 경로

의존성, 권한 또는 네이티브 code가 변경된 경우 서명된 빌드를 요청하세요.

  1. 1

    업데이트 초기화, upload, 빌드, 검증 흐름

    npx @capgo/cli@latest init
  2. 2

    릴리스를 OTA로 할지 Native로 할지 물어보세요

    npx @capgo/cli@latest bundle releaseType com.acme.app --channel production
  3. 3

    프리뷰 QR과 함께 안전 장치를 적용한 live update upload

    npx @capgo/cli@latest bundle upload --channel production --fail-on-incompatible --qr-preview
  4. 4

    Native Build를 요청하고 CI나 PR용 결과물 보관

    npx @capgo/cli@latest build request com.acme.app --platform ios --build-mode release --output-upload --output-record .capgo/build.json

자동화

Scoped key 입력, 릴리스 이벤트 출력

CI와 에이전트에는 필요한 작업만 할 수 있는 키를 발급하고, 모든 bundle 및 channel 변경 사항을 팀이 이미 보고 있는 도구로 전송하세요.

CI, 스크립트, AI 에이전트용 스코프 키

하나의 조직이나 앱으로만 제한된 키를 만들고, upload, read, write 모드와 만료일을 설정하세요. 키는 해시로 저장할 수 있으며 다시는 표시되지 않습니다.

  • CI 파이프라인용 upload 전용 키
  • 모든 키에 만료일 설정
  • 조직에서 요구할 경우 해시로 저장
Capgo API 키 페이지에 GitHub Actions, Fastlane, 읽기 전용 지원 대시보드, Capgo MCP 서버용 키가 각각 만료일과 함께 나열되어 있습니다.

Native Build 및 MCP

CLI가 앱에 실제로 필요한 릴리스 작업을 처리하도록 하세요

호환성 검사에서 변경 사항이 OTA에 안전하다고 판단되면 보호된 live update를 배포하세요. native code, 권한 또는 의존성이 변경되면 native build를 요청하고 CI, PR, 리뷰어가 결과물을 볼 수 있도록 유지하세요.

앱
번들
채널
호환성
Native Build
통계
Doctor
전송 프로브

그다음 에이전트에게 요청하세요

  • 이 빌드를 프로덕션에 업로드하고 호환되지 않으면 실패 처리해줘
  • iOS 릴리스 빌드를 요청하고 출력 기록을 저장해줘
  • Capgo doctor를 실행하고 발견된 문제를 수정해줘

에이전트가 각 워크플로우를 이해할 수 있도록 Capgo Agent Skills를 추가하세요:

npx skills add Cap-go/capgo-skills
AI 도구 살펴보기

MCP 설치

Capgo CLI MCP 설치하기

Codex, Cursor, Claude Code, Windsurf, VS Code, Zed 또는 Gemini CLI에서 CLI 서버를 등록하세요.

npx install-mcp 'npx @capgo/cli@latest mcp' --client codex

교체 codex 팀에서 사용하는 클라이언트로 교체하세요.

호스팅 MCP

Claude, ChatGPT 또는 Cursor에서 Capgo 사용하기

설치할 필요가 없습니다. URL을 원격 MCP 클라이언트에 붙여넣고 OAuth로 로그인하면 채팅에서 앱, 채널, 롤아웃, 디바이스, 빌드를 관리할 수 있습니다.

https://api.capgo.app/mcp

업로드와 Native Build 요청은 여전히 위의 CLI MCP를 통해 처리됩니다. 호스팅된 MCP 설정 가이드 읽기

빌드 기록

iOS release 빌드

CI, PR 체크, 모바일 리뷰용으로 저장된 결과물입니다.

준비 완료
플랫폼
iOS
모드
릴리스
결과물
IPA 및 설치 QR
기록
.capgo/build.json
npx @capgo/cli@latest build request com.acme.app --platform ios --output-upload --output-record .capgo/build.json

릴리스 노트가 게시되기 전에도 상태를 확인할 수 있습니다.

기기 검증을 위해 QR 출력을 계속 사용할 수 있습니다.

위험한 릴리스가 배포되기 전에 에러가 CI를 실패시킬 수 있습니다.

Capacitor로 빌드된 앱

Capacitor 앱에는 네이티브 경계를 존중하는 릴리스 툴링이 필요합니다

규모가 큰 Capacitor 앱은 웹 변경 사항과 네이티브 의존성이 섞여 있습니다. Capgo CLI는 프로덕션 릴리스가 나가기 전에 그 경계를 계속 보여줍니다.

표시된 앱은 웹사이트 전반에서 사용되는 공개 스토어 앱 데이터셋에서 가져왔습니다.

지금 CLI 사용해 보세요

대시보드 세션을 기다릴 필요 없이 릴리스 스크립트에 Capgo를 추가하세요.

CLI 문서부터 시작한 다음, 호환성 체크, bundle 업로드, Native Build 또는 MCP를 팀이 이미 사용하는 워크플로우에 연결하세요.

Bundle 명령어 Build 명령어