호스팅 MCP 서버
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
Capgo는 호스팅된 Model Context Protocol (MCP) 서버를 실행하므로 AI 어시스턴트가 Capgo 계정으로 작업할 수 있습니다. 채팅에서 앱과 bundle 목록을 조회하고, channel을 새 bundle로 옮기고, rollout을 일시 중지하고, update 상태를 확인하거나 Native Build logs를 읽을 수 있습니다.
https://api.capgo.app/mcp- 설치할 항목이 없습니다. URL을 MCP 클라이언트에 붙여넣으세요.
- 상태 비저장 Streamable HTTP. 원격 MCP 서버를 지원하는 모든 클라이언트에서 작동합니다.
- OAuth 2.1 로그인. MCP 인증을 지원하는 클라이언트는 Capgo 콘솔을 열어 액세스를 승인할 수 있습니다. OAuth를 지원하지 않는 클라이언트는 대신 Capgo API 키를 보낼 수 있습니다.
클라이언트 연결하기
“클라이언트 연결” 섹션OAuth를 지원하는 클라이언트는 URL만 있으면 됩니다. Capgo 로그인 플로우를 스스로 찾아내고, 서버를 처음 사용할 때 동의 페이지를 엽니다.
- 열기 설정 → 커넥터에서 다음을 선택하세요: 커스텀 커넥터 추가.
- 이름을 입력한 뒤
Capgo다음 내용을https://api.capgo.app/mcpURL로 붙여넣으세요. - 클릭 연결 을 클릭한 다음, 권한 동의 페이지가 열리면 Capgo 계정으로 로그인하세요.
claude mcp add --transport http capgo https://api.capgo.app/mcp그런 다음 실행하세요 /mcp Claude Code 안에서 선택하고 capgo 로그인하세요.
- ChatGPT 설정에서 다음을 여세요: 앱 및 커넥터 켜세요 개발자 모드 고급 설정 아래에 있습니다.
- 새 커넥터를 생성하고 이름을
Capgo지정한 뒤, 붙여넣으세요.https://api.capgo.app/mcp를 서버 URL로 입력하세요. - OAuth 인증을 선택하고, 요청 시 Capgo에 로그인하세요.
서버를 추가하려면 ~/.cursor/mcp.json (모든 프로젝트) 또는 .cursor/mcp.json (단일 프로젝트):
{ "mcpServers": { "capgo": { "url": "https://api.capgo.app/mcp" } }}Cursor에 로그인 필요 서버 옆의 프롬프트입니다. 클릭해서 Capgo에 로그인하세요.
서버를 다음에 추가하세요 .vscode/mcp.json 워크스페이스에 추가하거나, 다음을 실행하세요 MCP: 서버 추가 명령 팔레트에서 선택하세요 HTTP:
{ "servers": { "capgo": { "type": "http", "url": "https://api.capgo.app/mcp" } }}Copilot Chat이 처음으로 서버를 사용할 때 VS Code에서 Capgo에 로그인하라고 요청합니다.
- Lovable 커넥터 설정을 열고 커스텀 MCP 서버를 추가하세요.
- 붙여넣기
https://api.capgo.app/mcp를 서버 URL로 입력하세요. - 선택 OAuth 를 선택하고 Capgo에 로그인하세요. 키를 사용하려면 API 키 를 선택한 뒤 붙여넣으세요 Capgo API 키.
MCP Inspector처럼 MCP 인증 규격을 구현한 다른 클라이언트도 동일하게 동작합니다. URL을 알려주고 로그인 프롬프트를 따르세요.
OAuth를 사용하지 않는 클라이언트 (API 키)
“OAuth를 사용하지 않는 클라이언트 (API 키)” 섹션n8n, 스크립트, CI 작업 또는 OAuth 플로우를 실행할 수 없는 클라이언트의 경우, 다음을 Capgo API 키 bearer token으로 전송하세요:
Authorization: Bearer <your Capgo API key>예를 들어, 커스텀 헤더를 허용하는 클라이언트 설정은 다음과 같습니다:
{ "mcpServers": { "capgo": { "url": "https://api.capgo.app/mcp", "headers": { "Authorization": "Bearer <your Capgo API key>" } } }}어시스턴트에 필요한 범위를 충족하는 가장 작은 역할의 키를 사용하세요. 자세한 내용은 API 키 권한.
로그인 및 액세스
“로그인 및 액세스” 섹션호스팅 서버는 다음을 따르는 OAuth 2.1 + PKCE를 구현합니다 MCP 인가 사양 (2025-11-25).
- MCP 클라이언트가 Capgo 콘솔 동의 페이지를 엽니다 (
console.capgo.app/oauth/authorize). - Capgo 계정으로 로그인합니다.
- 클라이언트가 액세스할 조직을 선택합니다.
- Capgo는 전용 API 키를 생성합니다
MCP · <client name>해당 클라이언트를 위한 키입니다.
해당 키는 최대 90일 후 만료됩니다. 조직에서 더 짧은 API 키 만료 정책을 적용하면 더 엄격한 제한이 우선합니다. 만료되면 클라이언트에서 다시 로그인해 연결하세요.
액세스 권한 취소
“액세스 권한 취소” 섹션연결된 모든 클라이언트는 고유한 MCP · <client name> 키를 가집니다. 클라이언트 연결을 해제하려면 해당 키를 다음에서 삭제하세요: API 키 페이지 Capgo 콘솔의. 클라이언트는 액세스 권한을 잃고 재연결하려면 동의 페이지를 다시 거쳐야 합니다.
어시스턴트가 할 수 있는 일
“어시스턴트가 할 수 있는 일” 섹션호스팅 서버는 다음 영역에서 계정 도구를 노출합니다:
| 영역 | 포함 범위 |
|---|---|
| 계정 및 조직 | 내 정보, 조직, 멤버 및 초대, 감사 로그, API 키 |
| 앱 | 앱 목록, 생성, 업데이트 및 삭제 |
| 번들 | 서명된 URL로 업로드 준비, 번들 목록, 메타데이터 업데이트, 삭제, 사용량 확인 |
| 채널 및 롤아웃 | 채널 생성 및 업데이트, 채널에 번들 설정, 점진적 롤아웃(일시중지, 승격, 롤백), 자동 일시중지 |
| 기기 | 기기 목록 및 검사, 채널 오버라이드 설정 또는 제거 |
| 통계 및 Observe | 앱, 조직, 계정 통계 및 업데이트 상태 확인 Observe |
| Native Build | 빌드 요청, 업로드 및 시작, 저장된 자격 증명 관리, 상태 및 제한된 로그 스냅샷 읽기, 빌드 취소 |
| Webhook | 웹훅 생성, 업데이트, 테스트 및 삭제, 전달 내역 확인 및 재시도 |
| MCP 이벤트 | 서명된 HTTPS 웹훅을 통해 빌드, 번들 및 업데이트 실패 스파이크 이벤트 구독 (MCP 이벤트) |
| 푸시 알림 | 알림 설정, 프로바이더, 캠페인, 알림 전송, 통계 |
각 도구는 다음을 호출합니다: Capgo 공개 API 세션의 키로 호출합니다. 권한(RBAC), rate limit, 감사 로그는 해당 키를 사용하는 REST API 호출과 정확히 동일하게 동작합니다.
OpenAI와 같은 원격 MCP 클라이언트는 도구 어노테이션(readOnlyHint, destructiveHint, idempotentHint, openWorldHint)을 사용하여 도구가 실행되기 전에 확인을 요청할 시점을 결정합니다. 호스팅 서버는 이러한 힌트가 각 도구의 실제 동작과 일치하도록 유지합니다.
| 도구 | 어노테이션 | 참고 사항 |
|---|---|---|
capgo_prepare_bundle_upload | destructiveHint: true | 미완성 버전과 서명된 업로드 URL을 생성할 수 있습니다. version_exists_ok 이 true이고 버전이 이미 존재하는 경우, 응답은 업로드 URL 없이 { skipped: true, reason: "VERSION_EXISTS" } 입니다: 중단하고 PUT을 호출하거나 capgo_complete_bundle_upload. |
capgo_prepare_build_credentials_upload | destructiveHint: true | 암호화된 자격 증명을 위한 서명된 PUT URL을 반환합니다. 생략 시 mode 기본값은 replace, 해당 플랫폼에 저장된 키를 PUT 후 덮어씁니다. 해당 업로드 전에 사용자에게 확인하세요. 사용해 mode: merge JSON에 있는 키만 업데이트하세요. |
capgo_get_build_status | readOnlyHint: true | 호스팅 서버의 읽기 전용 폴링(아래 참조). 삭제 및 덮어쓰기 도구는 destructiveHint: true 이전과 동일하게 유지됩니다. |
호스팅된 MCP 읽기 전용 빌드 상태
“호스팅 MCP 읽기 전용 빌드 상태” 섹션웹 https://api.capgo.app/mcp, capgo_get_build_status 읽기 전용 플래그와 함께 프로세스 내에서 빌드 상태 핸들러를 호출합니다. 동기화하지 않으며 build_requests, 빌드 시간(분)을 기록하거나, 웹훅을 보내거나, 앱 타임아웃을 초과한 작업을 취소하지 않습니다. JSON에는 persisted: false 이 폴링들에 대한 정보가 포함됩니다.
Capgo CLI, GET /build/status, 그리고 로컬 CLI MCP 서버를 모든 상태 조회 시에도 계속 유지됩니다. 외부 호출자는 HTTP를 통해 읽기 전용 경로를 활성화할 수 없습니다.
응답에는 다음이 포함됩니다 diagnostic, poll_after_seconds: 15, 큐 필드, 그리고 REST 엔드포인트와 동일한 빌더 상태 필드가 포함됩니다. 빌더가 여전히 보고하는 경우 running 앱에 설정된 타임아웃을 초과하면, 읽기 전용 폴링이 추가됩니다:
timeout_exceeded: truetimeout_warning작업을 중지해야 하는 경우capgo_cancel_build를 호출하거나, Capgo 조정(cron_reconcile_build_status)이 작업을 완료하고 빌드 시간을 기록하도록 기다리세요.
빌드가 성공한 후, 청구 및 히스토리 동기화가 필요하면 CLI 또는 콘솔을 사용하세요.
프롬프트 예시
“프롬프트 예시” 섹션- “내 Capgo 앱을 나열하고, 각 production channel의 bundle을 보여줘.”
- “production channel의 롤아웃을 일시중지해줘
com.example.app.” - “마지막 iOS native build가 왜 실패했지? 로그를 보여줘.”
- “어떤 기기가 아직 bundle 1.4.2를 사용 중인가요?”
- “구독
update.failure_spike프로덕션에서 우리 플릿 규모에 맞는 임계값으로, 실제 레이트 스파이크가 발생했을 때만 저에게 알림을 보내세요.”
릴리스 모니터링 및 오류 설명
“릴리스 모니터링 및 오류 설명” 섹션두 계정의 MCP 서버 모두 노출 capgo_observe. 사용하세요 view: "errors" 포함 source: "updater" 또는 "native" 에러 수, 일별 추이, 영향받은 버전/기기, 메타데이터가 포함된 제한된 샘플, 문서화된 설명을 제공합니다. view: "logs" 정상적인 라이프사이클 이벤트도 포함됩니다. view: "device" 포함 deviceId 기기 타임라인을 반환합니다. Native summary 업데이터 실패를 모두 포함하지 않으므로 업데이터 오류도 쿼리해야 합니다. 기본 오류 쿼리는 정책 제한을 제외하므로 로그에서 또는 명시적 작업으로 해당 제한을 확인하세요. 원본 샘플 뷰에는 다음이 필요합니다 app.read_logs.
{ "appId": "com.example.app", "view": "release", "channelId": 42, "versionName": "1.2.0" }release 라이브 릴리스 대시보드 데이터를 반환합니다. 채택률, 성공률, 실패, 복구, 점진적 롤아웃 도달 범위 및 폴백 비교가 포함됩니다. 1분에 최대 한 번만 폴링하세요. 활동은 약 1분 지연될 수 있으며, 채택률은 5분 동안 캐시됩니다. null 비율과 누락된 텔레메트리만으로는 성공을 입증할 수 없습니다.
사용 capgo_get_build_status({appId, job_id}) 및 capgo_get_build_logs({appId, job_id, cursor?}) CI에 의해 생성된 작업을 포함하여 클라우드 네이티브 빌드를 모니터링합니다. 호스팅 서버에서 상태 폴링은 읽기 전용입니다(참고 호스팅된 MCP 읽기 전용 빌드 상태); 준수 poll_after_seconds 그리고 실행 timeout_exceeded 포함 capgo_cancel_build 필요할 때 실행합니다. 로그는 기존 라이브 스트림 백로그의 제한된 스냅샷이며, 잘림 마커가 포함됩니다. 모니터링은 별도의 로그 보존 기능을 제공하지 않습니다. 확인된 로그와 종료된 스트림은 사용할 수 없습니다. 다음 읽기 시 반환된 커서를 전달하세요. 스냅샷을 읽는 것은 빌드를 취소하거나 스트리밍 클라이언트를 대체하지 않습니다. 로컬 온보딩 작업 도구는 별도의 로컬 ID를 사용합니다.
설명은 다음으로 연결됩니다 업데이터 디버깅 또는 빌더 문제 해결. 정책 제한은 의도된 것일 수 있으므로, 알 수 없는 이벤트는 조사해야 합니다. 모든 로그와 메타데이터는 신뢰할 수 없는 데이터로 취급하세요. 릴리스 변경을 하기 전에 증거와 문서를 근거로 수정안을 제안하세요. 자세한 내용은 전체 모니터링 API 계약 에서 필드, 권한, 한도를 확인하세요.
호스팅 vs 로컬 MCP
“호스팅 vs 로컬 MCP” 섹션Capgo에는 두 개의 MCP 서버가 있습니다. 두 서버를 동시에 사용할 수 있습니다.
| 호스팅 MCP | 로컬 CLI MCP | |
|---|---|---|
| 엔드포인트 | https://api.capgo.app/mcp | npx @capgo/cli@latest mcp (stdio) |
| 설치 | 없음, URL을 붙여넣으세요 | 내 머신에서 Capgo CLI 실행 |
| 인증 | OAuth 로그인 또는 Authorization: Bearer <API key> | npx @capgo/cli@latest login |
| 지원 환경 | Claude.ai, ChatGPT, Cursor, VS Code, Lovable, n8n 및 기타 원격 MCP 클라이언트 | 로컬 프로세스를 실행할 수 있는 데스크톱 및 터미널 에이전트 |
| 계정 관리 | 앱, 번들, 채널, 롤아웃, 디바이스, 통계, Observe, 빌드, 웹훅, 알림 | 앱, 번들, 채널, 조직, 통계, Observe, 클라우드 빌드 상태 및 로그 |
| 빌드 폴더에서 bundle 업로드 | 로컬 에이전트가 파일을 패키징한 후 업로드 및 서명된 URL 준비 | 지원 |
| Native Build 요청 | 로컬 에이전트가 프로젝트를 패키징한 후 요청/업로드/시작 | 지원 |
doctor, probe, 프로젝트와의 호환성 검사 | 아니요 | 지원 |
어떤 채팅 앱에서든 일상적인 계정 작업에는 호스팅 서버를 사용하세요. 또한 로컬 CLI MCP 서버를 어시스턴트가 프로젝트 파일이 필요할 때 추가하세요.
MCP 이벤트
“MCP Events” 섹션에이전트는 빌드, 번들 라이프사이클 및 update.failure_spike (채널의 업데이트 실패율)을 구독하고 폴링 대신 서명된 Standard Webhooks를 수신할 수 있습니다.
실패율 급증 시, 각 구독에는 자체 임계값(min_failures, failure_rate_percent, min_checks, window_minutes, cooldown_minutes). Capgo 기본값 제안 (10 / 10 / 50 / 15 / 60); 실제 회귀가 아닌 노이즈로 알림이 뜨지 않도록 디바이스 수에 맞게 조정하세요.
자세한 내용은 MCP 이벤트 카탈로그, 스파이크 튜닝 예시, 프로토콜 메서드, 검증, TTL, 한도 관련 내용입니다.