QApilot MCP for Android
Android용 QApilot MCP는 AI 코딩 클라이언트를 로컬 Android 기기에 연결하여, 수동으로 Appium 코드를 작성하지 않고도 일상 언어로 작성된 테스트를 바로 실행합니다.
Android용 QApilot MCP는 AI 코딩 클라이언트를 로컬 Android 기기에 연결하여, 수동으로 Appium 코드를 작성하지 않고도 일상 언어로 작성된 테스트를 바로 실행합니다.
제품의 기능과 공식 포지셔닝
Android용 QApilot MCP는 Claude Desktop 및 Cursor와 같은 AI 어시스턴트가 모바일 애플리케이션 테스트를 직접 주도할 수 있도록 지원하는 Model Context Protocol CLI 브리지입니다. 로컬 Appium 서버 및 Android Debug Bridge(ADB) 환경에 직접 연결되므로 사용자가 Appium이나 UIAutomator 스크립트를 직접 작성하지 않고도 실제 기기와 에뮬레이터를 자유롭게 제어할 수 있습니다.
이 도구는 대화형 프롬프트를 정형화된 실행 계획으로 변환하고, UI 동작을 수행하며, 브라우저 미리보기로 실시간 실행 과정을 스트리밍하고, 검증된 테스트 경로를 QApilot 프로젝트에 다시 저장함으로써 테스트 워크플로를 자동화합니다. 테스트 실행이 끝나면 구조화된 데이터, Gherkin 명세서, 세션 지표를 결과물로 생성합니다.
공식 출처로 확인된 활용 사례
품질 엔지니어는 자연어로 테스트 상호작용을 설명하여 AI 클라이언트가 구조화된 테스트 계획을 구성하고, 연결된 Android 기기에서 동작을 실행하며, 스크린샷을 캡처하도록 할 수 있습니다.
팀은 이전에 승인된 테스트 케이스를 ID별로 순차 실행하거나 연결된 에뮬레이터를 대상으로 Excel(.xlsx) 스프레드시트에서 직접 로드한 전체 테스트 스위트를 대량 실행할 수 있습니다.
공식 문서에 안내된 사용 절차
Node.js 18+, Java JDK 11+, Android SDK 등의 필수 구성 요소를 확인하고 지정된 uiautomator2 드라이버와 함께 Appium 2.19.0을 실행합니다.
Claude Desktop, Cursor 또는 호환되는 AI 클라이언트의 MCP 설정 구성에 qapilot-mobile-mcp 명령과 인수를 추가합니다.
QApilot 작업 공간에 로그인하고 Android 패키지 식별자를 지정하여 대상 애플리케이션을 실행합니다.
AI 어시스턴트에 동작 수행을 지시하고, 라이브 미리보기 URL을 통해 실시간 진행 상황을 확인하며, 성공적인 정상 경로 단계를 QApilot에 등록합니다.
세션 보고서를 생성하여 JSON, YAML 및 Gherkin 파일을 출력하고 다음 실행을 위해 실행 상태를 초기화합니다.
CLI는 표준 입출력(stdio) 스트림을 통해 통신하는 MCP 서버로 작동하며, 기기 관리, 계획 수립, 작업 전달, 상태 쿼리를 위한 전용 도구를 노출합니다. AI 클라이언트는 mobile_launch_app, mobile_submit_plan, mobile_execute와 같은 도구를 활용하여 Appium 세션 수명 주기를 프로그래밍 방식으로 제어합니다.
활성 실행 중에 상태 검사 명령을 사용하면 클라이언트가 실행 상태를 쿼리하고 캐시된 애플리케이션 스킬과 XPath를 가져올 수 있습니다. 실행이 완료된 후 리포팅 도구를 호출하면 테스트 산출물이 로컬 Downloads 디렉터리에 기록되고 활성 실행 컨텍스트가 초기화됩니다.
본인의 자료와 작업 흐름으로 직접 확인할 항목
확인한 출처와 확인 시점
출처를 확인한 제품 정보를 바탕으로 한 답변
이 서버는 Claude Desktop, Cursor, OpenAI Codex 또는 Model Context Protocol과 호환되는 모든 AI 도구에서 구성하여 사용할 수 있습니다.
공식 문서에 따르면 버전 4.2.6의 uiautomator2 드라이버와 함께 설치된 Appium 2.19.0 버전이 필수로 요구됩니다.
아니요, 정상 경로(happy-path) 단계만 승인됩니다. 실패한 단계는 제외되며, 단계를 테스트 케이스로 저장하려면 먼저 오류를 수정해야 합니다.
보고서는 사용자의 Downloads 디렉터리에 저장되며, 통과한 세션에 대해 output.json, report.yaml 및 scenario.feature Gherkin 파일이 포함됩니다.
네, mobile_run_excel_testcases 도구를 사용하면 Excel(.xlsx) 파일에서 저장된 테스트 케이스를 직접 로드하여 실행할 수 있습니다.