호스팅 MCP 서버

Capgo는 호스팅된 Model Context Protocol (MCP) 서버를 실행하여 AI 어시스턴트가 Capgo 계정과 연동할 수 있게 합니다. 채팅만으로 앱 및 bundle 목록 확인, 채널을 새 bundle로 이동, rollout 일시 중지, update 상태 점검, 또는 Native Build logs 읽기가 가능합니다.

https://api.capgo.app/mcp

• 설치할 항목이 없습니다. URL을 MCP 클라이언트에 붙여넣으세요.
• 상태 비저장 Streamable HTTP. 원격 MCP 서버를 지원하는 모든 클라이언트에서 작동합니다.
• OAuth 2.1 로그인. MCP 인증을 지원하는 클라이언트는 Capgo 콘솔을 열어 액세스를 승인할 수 있습니다. OAuth를 지원하지 않는 클라이언트는 대신 Capgo API 키를 보낼 수 있습니다.

호스팅인가요, 로컬인가요?

호스팅된 서버는 사용자의 컴퓨터에 있는 파일을 읽을 수 없습니다. 번들을 업로드하거나, Native Build를 요청하거나, 실행하려면 doctor 및 probe 다음을 사용하세요. 로컬 CLI MCP 서버 (npx @capgo/cli@latest mcp). 다음을 참고하세요:) 호스팅 vs 로컬 MCP.

클라이언트 연결하기

OAuth를 지원하는 클라이언트는 URL만 있으면 됩니다. 클라이언트가 자동으로 Capgo 로그인 플로우를 감지하며, 서버를 처음 사용할 때 동의 페이지가 열립니다.

Claude.ai

1. 열기 설정 → 커넥터에서 다음을 선택하세요: 커스텀 커넥터 추가.
2. 이름을 입력한 뒤 Capgo 다음 내용을 https://api.capgo.app/mcp URL로 붙여넣으세요.
3. 클릭 연결 을 클릭한 다음, 권한 동의 페이지가 열리면 Capgo 계정으로 로그인하세요.

Claude Code 연결하기

claude mcp add --transport http capgo https://api.capgo.app/mcp

그런 다음 실행하세요 /mcp Claude Code 내부에서 선택하고 capgo 로그인하세요.

ChatGPT

1. ChatGPT 설정에서 다음을 여세요: 앱 및 커넥터 그 다음 Developer mode를 고급 설정에서 활성화하세요.
2. 새 커넥터를 생성하고 이름을 Capgo입력한 뒤, https://api.capgo.app/mcp 를 서버 URL로 입력하세요.
3. OAuth 인증을 선택하고 안내에 따라 Capgo에 로그인하세요.

Cursor

서버를 다음 위치에 추가하세요: ~/.cursor/mcp.json (모든 프로젝트) 또는 .cursor/mcp.json (특정 프로젝트):

{
  "mcpServers": {
    "capgo": {
      "url": "https://api.capgo.app/mcp"
    }
  }
}

Cursor에 표시되는 로그인 필요 프롬프트가 서버 옆에 나타납니다. 클릭하여 Capgo에 로그인하세요.

VS Code

서버를 다음 위치에 추가하세요: .vscode/mcp.json 워크스페이스에 추가하거나, 다음 명령어를 실행하세요: MCP: 서버 추가하기 커맨드 팔레트에서 선택하세요: HTTP:

{
  "servers": {
    "capgo": {
      "type": "http",
      "url": "https://api.capgo.app/mcp"
    }
  }
}

Copilot Chat이 처음으로 서버를 사용할 때 VS Code에서 Capgo에 로그인하라고 요청합니다.

Lovable

1. Lovable 커넥터 설정을 열고 커스텀 MCP 서버를 추가하세요.
2. 붙여넣기 https://api.capgo.app/mcp 를 서버 URL로 입력하세요.
3. 선택 OAuth 를 선택하고 Capgo에 로그인하세요. 키를 사용하려면 API 키 를 선택한 뒤 붙여넣으세요 Capgo API 키.

MCP Inspector처럼 MCP 인증 규격을 구현한 다른 클라이언트도 동일하게 동작합니다. URL을 알려주고 로그인 프롬프트를 따르세요.

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).

1. MCP 클라이언트가 Capgo 콘솔 동의 페이지를 엽니다 (console.capgo.app/oauth/authorize).
2. Capgo 계정으로 로그인합니다.
3. 클라이언트가 액세스할 조직을 선택합니다.
4. Capgo는 전용 API 키를 생성합니다 MCP · <client name> 해당 클라이언트를 위한 키입니다.

해당 키는 최대 90일 후 만료됩니다. 조직에서 더 짧은 API 키 만료 정책을 적용하면 더 엄격한 제한이 우선합니다. 만료되면 클라이언트에서 다시 로그인해 연결하세요.

액세스 권한 취소

연결된 모든 클라이언트는 고유한 MCP · <client name> 키를 가집니다. 클라이언트 연결을 해제하려면 해당 키를 다음에서 삭제하세요: API 키 페이지 Capgo 콘솔의 키입니다. 클라이언트의 액세스 권한이 상실되며, 다시 연결하려면 동의 페이지를 거쳐야 합니다.

어시스턴트 기능

호스팅된 서버는 약 50개의 도구를 제공합니다:

영역	지원 범위
계정 및 조직	내 정보, 조직, 멤버 및 초대, 감사 로그, API 키
앱	앱 목록 조회, 생성, 업데이트 및 삭제
번들	bundle 목록, 메타데이터 업데이트, 삭제, 사용량 확인
Channels 및 rollouts	channel 생성 및 업데이트, channel에 bundle 설정, 점진적 rollout (일시 중지, 승인, 롤백), 자동 일시 중지
기기	디바이스 목록 및 상세 정보 확인, channel override 설정 또는 제거
통계 및 Observe	App, 조직 및 계정 통계, 업데이트 상태 확인 Observe
Native Build	build 상태, build logs, build 취소
Webhooks	webhook 생성, 업데이트, 테스트, 삭제, 전달 상태 확인 및 재시도
푸시 알림	알림 설정, 프로바이더, 캠페인, 알림 전송, 통계

각 도구는 다음을 호출합니다: Capgo 공개 API 세션의 키로 호출합니다. 권한(RBAC), rate limit, 감사 로그는 해당 키를 사용하는 REST API 호출과 정확히 동일하게 동작합니다.

데이터를 삭제하거나 덮어쓰는 도구는 destructive로 표시되므로, MCP 클라이언트가 실행 전에 확인을 요청합니다.

프롬프트 예시

• “내 Capgo 앱을 나열하고, 각 production channel의 bundle을 보여줘.”
• “production channel의 롤아웃을 일시중지해줘 com.example.app.”
• “마지막 iOS native build가 왜 실패했지? 로그를 보여줘.”
• “어떤 기기가 아직 bundle 1.4.2를 사용 중인가요?”

호스팅 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, 빌드, 웹훅, 알림	앱, 번들, 채널, 조직, 통계
빌드 폴더에서 bundle 업로드	아니요	지원
Native Build 요청	지원 안 함 (상태, logs, 취소만 가능)	지원
doctor, probe, 프로젝트와의 호환성 체크	아니요	지원

어떤 채팅 앱에서도 일상적인 계정 작업을 수행하려면 호스팅된 서버를 사용하세요. 반면, 로컬 CLI MCP 서버는 어시스턴트가 프로젝트 파일에 접근해야 할 때 사용합니다.

팁

https://capgo.app/mcp 는 별도의 공개 문서 검색용 MCP 서버입니다. 에이전트가 Capgo 문서와 OpenAPI 스펙을 찾는 것을 도와주며, 계정에는 접근할 수 없습니다. 계정 관련 도구는 https://api.capgo.app/mcp.

관련 항목

• CLI MCP 서버 (로컬)
• 콘솔의 API 키
• 공개 API
• AI 에이전트를 위한 Capgo MCP