빠른 시작
OpenTester는 앱별 테스터 참여와 피드백을 관리하고, 개발 도구가 그 피드백을 수정 작업으로 연결할 수 있게 합니다. 먼저 앱을 등록한 뒤 목적에 맞는 연동 방법을 선택하세요.
서비스 초기 설정
로그인, 앱 등록, 에이전트 토큰 발급에는 운영자의 Google 로그인 설정이 필요합니다. 로그인 준비 중으로 표시된다면 설정 완료 후 아래 절차를 이용할 수 있습니다.
1. 앱을 준비하세요
- 서비스에 개발자 계정으로 로그인하고 개발자 콘솔 → 앱 등록에서 Android 앱을 등록합니다.
- 앱의 패키지 이름, 모집 방식, SDK 인증 콜백 주소를 설정합니다. 콜백은 앱이 처리할 수 있는 주소여야 합니다.
- 앱 정보 및 SDK 화면에서 앱 ID를 확인합니다. 패키지 이름과 앱 ID는 다른 값입니다. API와 MCP는 UUID 형식의 앱 ID를 사용합니다.
- 별도의 테스터 계정으로 앱에 참여합니다. 승인제 앱이라면 개발자가 신청을 승인합니다.
앱을 설치할 수 있는 권한과 SDK를 사용할 수 있는 권한은 별도입니다. 핵심 개념에서 참여 상태와 Google Play의 관계를 확인하세요.
2. 필요한 연결을 선택하세요
앱에서 의견·버그 받기
Android SDK 설치 후 앱 시작 시 SDK를 초기화합니다. 브라우저 인증 결과를 앱으로 전달하고, 승인된 테스터에게 피드백 입력 UI를 제공합니다.
SDK는 로그인·권한 확인·텍스트 제출 API를 제공합니다. 의견 입력 화면과 앱 내 접근 흐름은 앱 개발자가 구성합니다. 현재 자동 크래시 수집과 스크린샷 업로드는 제공하지 않습니다.
서버나 개발 도구에서 API 호출하기
앱의 앱 정보 및 SDK → 코딩 에이전트 연결에서 토큰을 발급합니다. 피드백만 읽는 도구에는 조회 전용 토큰을, 작업을 생성하는 도구에는 수정 작업 권한이 있는 토큰을 사용하세요.
# 실제 서비스 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를 참고하세요.
Codex 또는 Claude Code에서 연결하기
https://mcp.opentester.app/mcp에 앱별 토큰과 앱 UUID 헤더로 연결하거나, 로컬 MCP 서버에 위 세 환경변수를 전달합니다. 클라이언트 설정에 복사할 수 있는 설정 예시가 있습니다.
연결 후 아래처럼 요청할 수 있습니다.
OpenTester의 열린 버그를 조회해 재현 가능한 항목을 하나 골라줘. 피드백을 근거로 수정 작업을 생성하고, 코드를 수정한 뒤 테스트 결과를 정리해줘. 내가 사용하는 저장소에서 PR을 만든 후 그 URL을 작업에 연결해줘.
MCP가 제공하는 기능은 피드백 조회, 수정 작업 생성·조회, PR URL 연결입니다. 실제 코드 변경과 PR 생성은 코딩 에이전트와 별도로 연결된 저장소 도구가 수행합니다.
3. 결과를 확인하세요
| 연동 | 성공 확인 |
|---|---|
| SDK | 로그인 후 권한 확인이 성공하고, 제출한 리포트가 개발자 콘솔에 표시됨 |
| API | 토큰으로 해당 앱의 피드백 목록 조회가 성공함 |
| MCP | 도구 목록 6개가 표시되고 list_feedback 호출이 성공함 |
| 수정 작업 | 생성된 작업을 조회할 수 있고 PR 연결 후 status가 pr_linked로 표시됨 |