본문 바로가기
Windsurf 로고

Capgo와 함께 Windsurf에서 모바일 앱을 배포하세요

Windsurf는 Capacitor 앱의 빌드, 배포, Live Update를 지원합니다: Mac 없이도 iOS 및 Android 빌드 가능, 몇 분 만에 완료되는 OTA 수정, 원클릭 롤백.

  • IDE
  • 호스팅 MCP
  • 로컬 MCP
  • 스킬
  • CLI

Windsurf에서 Capgo 설정하기

단 세 단계면 충분합니다. 각 블록을 그대로 복사하세요.

  1. 1단계

    호스팅된 Capgo MCP 추가

    Cascade 패널의 Actions 메뉴를 열고 Open MCP config file을 클릭하세요. Capgo를 추가하고 안내에 따라 로그인하면 됩니다. API 키는 필요하지 않습니다.

    mcp_config.json 
    {
  "mcpServers": {
    "capgo": {
      "serverUrl": "https://api.capgo.app/mcp"
    }
  }
}

  2. 2단계

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

    터미널에서 npx @capgo/cli@latest login를 한 번 실행한 다음, capgo-cli 항목을 추가하세요.

    mcp_config.json 
    {
  "mcpServers": {
    "capgo": {
      "serverUrl": "https://api.capgo.app/mcp"
    },
    "capgo-cli": {
      "command": "npx",
      "args": [
        "@capgo/cli@latest",
        "mcp"
      ]
    }
  }
}

  3. 3단계

    Capgo 스킬 설치하기

    설치 프로그램은 Windsurf 및 Devin 스킬 폴더를 지원합니다.

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

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

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

  • 빌드

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

  • 배포

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

  • 업데이트

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

  • 업데이트

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

  • 롤백

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

  • Observe

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

  • Observe

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

  • 업데이트

    “베타 채널을 생성하고 이 브랜치를 live update로 전송하세요.”

전체 릴리스 루프

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

  1. 1

    빌드

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

    Capgo 네이티브 앱용 Build
  2. 2

    배포하기

    Build를 TestFlight 및 Google Play로 전송하거나 스토어 심사를 위해 제출하세요.

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

    업데이트

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

    Capgo Live Update 사용하기
  4. 4

    Observe

    업데이트 대상자, 실패 원인, 각 릴리스의 성능을 확인하세요.

    Capgo Observe 살펴보기

Windsurf 참고 사항 및 제한 사항

  • Windsurf는 이제 Devin Desktop으로 변경되었습니다. 위 설정은 Cascade MCP 설정 파일을 사용합니다.
  • Devin CLI를 사용하여 devin mcp add -s user capgo https://api.capgo.app/mcp를 실행한 다음, devin mcp login capgo를 입력하세요.
  • Teams 및 Enterprise 플랜에서는 관리자의 MCP 허용 목록에 없는 서버가 차단됩니다. 관리자에게 Capgo를 추가해 달라고 요청하세요.

자주 묻는 질문

Capgo와 Windsurf: 자주 묻는 질문

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

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

Native Build 문서

Windsurf에 Capgo API 키가 필요한가요?

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

Capgo API 키 생성하기

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

네. Windsurf에게 채널을 이전 번들로 되돌리라고 요청하세요. 기기는 다음 업데이트 확인 시점에 전환됩니다. 새 번들이 시작되지 않으면 Capgo updater가 자동으로 롤백하기도 합니다.

Live update 문서

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

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

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

MCP 서버, skills, CLI는 무료로 사용할 수 있습니다. Capgo 플랜이 필요하며, 모든 플랜은 신용카드 등록 없이 14일간 무료 체험이 가능합니다. Build, Live Update, Observe 기능은 모든 플랜에 포함되어 있습니다.

요금제

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

Capgo 계정을 생성하고 Windsurf를 연결하여, 오늘 첫 번째 build 또는 live update을 푸시해 보세요.

문서

관련 페이지