---
description: 앱 등록과 테스터 승인부터 SDK 피드백 수집, API 및 MCP 연동까지 OpenTester를 시작하는 순서입니다.
---

# 빠른 시작 {#quick-start}

OpenTester는 앱별 테스터 참여와 피드백을 관리하고, 개발 도구가 그 피드백을 수정 작업으로 연결할 수 있게 합니다. 먼저 앱을 등록한 뒤 목적에 맞는 연동 방법을 선택하세요.

::: info 서비스 초기 설정
로그인, 앱 등록, 에이전트 토큰 발급에는 운영자의 Google 로그인 설정이 필요합니다. 로그인 준비 중으로 표시된다면 설정 완료 후 아래 절차를 이용할 수 있습니다.
:::

## 1. 앱을 준비하세요 {#1-prepare-your-app}

1. 서비스에 개발자 계정으로 로그인하고 **개발자 콘솔 → 앱 등록**에서 Android 앱을 등록합니다.
2. 앱의 패키지 이름, 모집 방식, SDK 인증 콜백 주소를 설정합니다. 콜백은 앱이 처리할 수 있는 주소여야 합니다.
3. **앱 정보 및 SDK** 화면에서 **앱 ID**를 확인합니다. 패키지 이름과 앱 ID는 다른 값입니다. API와 MCP는 UUID 형식의 앱 ID를 사용합니다.
4. 별도의 테스터 계정으로 앱에 참여합니다. 승인제 앱이라면 개발자가 신청을 승인합니다.

앱을 설치할 수 있는 권한과 SDK를 사용할 수 있는 권한은 별도입니다. [핵심 개념](/ko/guide/concepts)에서 참여 상태와 Google Play의 관계를 확인하세요.

## 2. 필요한 연결을 선택하세요 {#2-choose-an-integration}

### 앱에서 의견·버그 받기 {#collect-feedback-and-bugs-in-your-app}

[Android SDK 설치](/ko/sdk/) 후 앱 시작 시 SDK를 초기화합니다. 브라우저 인증 결과를 앱으로 전달하고, 승인된 테스터에게 피드백 입력 UI를 제공합니다.

SDK는 **로그인·권한 확인·텍스트 제출 API**를 제공합니다. 의견 입력 화면과 앱 내 접근 흐름은 앱 개발자가 구성합니다. 현재 자동 크래시 수집과 스크린샷 업로드는 제공하지 않습니다.

### 서버나 개발 도구에서 API 호출하기 {#call-the-api-from-a-server-or-tool}

앱의 **앱 정보 및 SDK → 코딩 에이전트 연결**에서 토큰을 발급합니다. 피드백만 읽는 도구에는 조회 전용 토큰을, 작업을 생성하는 도구에는 수정 작업 권한이 있는 토큰을 사용하세요.

```sh
# 실제 서비스 API 주소와 발급받은 앱 ID로 바꿉니다.
export OPENTESTER_API_URL='https://api.example.com/api/v1'
export OPENTESTER_APP_ID='00000000-0000-4000-8000-000000000001'
# OPENTESTER_AGENT_TOKEN은 비밀 저장소 또는 현재 셸 환경에 설정합니다.

curl --fail-with-body \
  "$OPENTESTER_API_URL/apps/$OPENTESTER_APP_ID/automation/feedback?limit=20" \
  -H "Authorization: Bearer $OPENTESTER_AGENT_TOKEN"
```

`api.example.com`은 예시 주소입니다. 서비스 운영자가 제공한 API 기본 주소를 사용하세요. 응답 구조와 조회 조건은 [피드백 API](/ko/api/feedback)를 참고하세요.

### Codex 또는 Claude Code에서 연결하기 {#connect-codex-or-claude-code}

`https://mcp.opentester.app/mcp`에 앱별 토큰과 앱 UUID 헤더로 연결하거나, 로컬 MCP 서버에 위 세 환경변수를 전달합니다. [클라이언트 설정](/ko/mcp/clients)에 복사할 수 있는 설정 예시가 있습니다.

연결 후 아래처럼 요청할 수 있습니다.

> OpenTester의 열린 버그를 조회해 재현 가능한 항목을 하나 골라줘. 피드백을 근거로 수정 작업을 생성하고, 코드를 수정한 뒤 테스트 결과를 정리해줘. 내가 사용하는 저장소에서 PR을 만든 후 그 URL을 작업에 연결해줘.

MCP가 제공하는 기능은 피드백 조회, 수정 작업 생성·조회, PR URL 연결입니다. 실제 코드 변경과 PR 생성은 코딩 에이전트와 별도로 연결된 저장소 도구가 수행합니다.

## 3. 결과를 확인하세요 {#3-verify-the-result}

| 연동      | 성공 확인                                                               |
| --------- | ----------------------------------------------------------------------- |
| SDK       | 로그인 후 권한 확인이 성공하고, 제출한 리포트가 개발자 콘솔에 표시됨    |
| API       | 토큰으로 해당 앱의 피드백 목록 조회가 성공함                            |
| MCP       | 도구 목록 6개가 표시되고 `list_feedback` 호출이 성공함                  |
| 수정 작업 | 생성된 작업을 조회할 수 있고 PR 연결 후 `status`가 `pr_linked`로 표시됨 |

오류가 발생하면 [SDK 문제 해결](/ko/sdk/troubleshooting), [API 오류](/ko/api/errors), [MCP 문제 해결](/ko/mcp/troubleshooting)을 확인하세요.