Benepass 경비报销 스킬
브라우저 자동화, Gmail 통합을 통한 인증 코드 수신, 영수증 파일 업로드를 활용하여 Benepass의 전체 경비报销 프로세스(로그인부터 제출까지)를 자동화합니다.
사전 요구 사항
- Benepass 탐색을 위한 브라우저 접근(컴퓨터 도구) 활성화
- 영수증 파일 저장 및 업로드를 위한 코드 실행 및 파일 생성 활성화
- 이메일 인증 코드 수신을 위한 Gmail MCP 구성
- Gmail MCP를 통해 이메일 주소 확인; Gmail 접근이 불가능한 경우 사용자에게 이메일 주소 요청
- 영수증 이미지(스크린샷, 사진 또는 PDF) 준비
1단계: 영수증 세부 정보 추출
Benepass로 이동하기 전에 영수증 이미지 또는 메시지에서 다음 주요 정보를 추출합니다:
- 금액 (예: $84.99)
- 가맹점 (예: Verizon, DoorDash, Lyft)
- 메모/비고 — 제공된 메모를 적용하거나, 기본값으로 간단한 설명 사용 (예: "집 와이파이", "점심", "사무실 이동")
- 복리후생 카테고리 — 지정된 카테고리를 선택; 확신이 있을 때는 문맥에서 유추하고, 그렇지 않으면 명확히 요청 (4단계 참조)
2단계: Benepass 로그인
2a. 이동 및 이메일 입력
https://app.getbenepass.com 으로 이동
- 이메일 입력 필드를 클릭하고 이메일 주소 입력
- 두 가지 로그인 옵션 표시: "G-Suite로 로그인" 및 "이메일 코드로 로그인"
- "이메일 코드로 로그인" 클릭
2b. Gmail에서 인증 코드 가져오기
"인증 코드 입력" 프롬프트(6개의 입력 상자)가 나타날 때까지 기다립니다.
Gmail MCP를 통해 코드를 가져옵니다:
Gmail 검색어: "from:benepass verification code"
maxResults: 1
- 이메일 스니펫에서 6자리 코드 추출 ("Your verification code is: XXXXXX" 찾기)
- 인증 입력 필드에 6자리 코드 입력 — 모든 6자리가 입력되면 페이지가 자동 제출됨
- 대시보드가 로드될 때까지 3-5초 대기
2c. 로그인 성공 확인
대시보드에 인사말, 계정 잔액, 인사이트 카드가 로드되어 로그인 성공을 확인합니다.
중요: 만료된 인증 코드 처리는 다음과 같이 합니다:
- 인증 페이지에서 "받지 못하셨나요? 다시 보내기" 클릭
- 5초 대기 후 Gmail에서 새 코드 검색
3단계: 경비报销 시작
- 왼쪽 사이드바에서 "경비报销 받기" 버튼 클릭
- 경비报销 양식이 로드될 때까지 대기 (두 섹션):
- 복리후생 선택 (드롭다운)
- 세부 정보 입력 (금액, 가맹점, 비고, 영수증)
4단계: 복리후생 선택
- "복리후생 선택" 드롭다운 클릭
- 지정된 카테고리 선택; 확신이 있을 때는 문맥에서 유추하고, 그렇지 않으면 명확히 요청
- 드롭다운에서 직접 사용 가능한 복리후생 옵션 읽기 — 카테고리는 고용주에 따라 다름
- 선택한 복리후생의 표시 잔액이 경비报销 금액을 충당하는지 확인
5단계: 세부 정보 입력
금액 필드
중요: 올바른 금액을 입력하기 전에 금액 필드에서 미리 채워진 값을 지웁니다.
- 금액 필드를 세 번 클릭하여 기존 값 선택
- 올바른 금액 입력 (예:
84.99) $기호는 포함하지 말고 숫자만 입력
가맹점 필드
- 가맹점 입력 필드 클릭
- 가맹점 이름 입력 (예:
Verizon,DoorDash,Lyft)
비고 필드 (선택 사항이지만 권장)
- 비고 입력 필드 클릭
- 메모 입력 (예:
집 와이파이,점심,사무실 이동)
6단계: 영수증 업로드
중요: 파일 입력은 id="fileInput"을 가진 숨겨진 요소입니다. 보이는 드롭 존은 클릭할 수 없으므로 숨겨진 입력을 사용하세요. id="fileInput"을 가진 요소가 없으면 페이지에서 <input type="file">을 검색합니다.
read_page와filter: interactive를 사용하여 파일 입력 요소를 찾습니다.- 다음을 찾습니다:
<input id="fileInput" class="hidden" type="file"> upload_file도구를 사용하여 해당 숨겨진 입력의 ref를 지정합니다:
upload_file:
file_path: <영수증 파일 경로>
ref: <fileInput의 ref>
- 업로드 후 확인:
- 영수증 레이블이 더 이상 빨간색이 아님 (업로드 전에는 빨간색이었음)
- 파일 이름과 크기를 보여주는 "업로드된 파일" 섹션이 나타남
- 영수증의 썸네일 미리보기가 보임
7단계: 제출
- 아래로 스크롤하여 "경비报销 제출" 버튼을 찾습니다.
- 제출을 클릭하기 전에 확인을 위해 요약을 표시합니다:
- 복리후생 카테고리
- 금액
- 가맹점
- 메모/비고
- 영수증 파일 이름
- 이 제출 후 남은 복리후생 잔액
- 명시적인 승인을 기다린 후 계속 진행
- "경비报销 제출" 클릭
- 처리될 때까지 3초 대기
제출 성공 확인
제출 후 페이지가 경비 세부 정보 보기로 리디렉션되어 다음을 표시합니다:
- 상태: 보류 중
- 결제 방법: 경비报销
- 복리후생: 선택한 복리후생 이름
- 지급 진행 상황: 미지급 금액 = 제출된 금액
확인 결과를 보고합니다.
문제 해결
세션 만료
오류가 발생하거나 페이지가 로그인으로 리디렉션될 경우 2단계(로그인)부터 다시 시작하여 세션 만료를 처리합니다.
인증 코드가 작동하지 않음
만료된 인증 코드 처리: "받지 못하셨나요? 다시 보내기"를 클릭하고 몇 초 기다린 후 Gmail에서 새 코드를 다시 검색합니다. 가장 최근 이메일을 가져오는지 확인합니다(maxResults: 1 및 기본 정렬 사용).
금액 필드 문제
새 금액을 입력하기 전에 항상 금액 필드를 세 번 클릭하여 기존 텍스트를 모두 선택합니다. 이렇게 하면 값이 연결되는 것을 방지할 수 있습니다 (예: 32184.99).
업로드가 등록되지 않음
영수증 업로드가 작동하지 않는 경우:
read_page로 페이지를 다시 읽어fileInputref를 찾습니다.fileInput이 없으면<input type="file">요소를 검색합니다.- 올바른 ref를 사용하여
upload_file로 업로드를 다시 시도합니다. - 업로드 후 "업로드된 파일" 섹션이 나타나는지 확인합니다.
복리후생 잔액 부족
선택한 복리후생의 잔액이 충분하지 않으면 문제를 보고하고 다른 복리후생 카테고리를 사용할지 묻습니다.