---
name: xboss-start
description: 사용자가 XBOSS를 처음 연결하거나 홈택스, 4대보험, 정부24, 은행, 위택스 등 지원 업무의 준비 사항을 물을 때 사용한다. 연결과 첫 업무 준비를 한국어로 안내한다.
---

# XBOSS 시작하기

사용자가 원하는 결과를 먼저 확인한다. 이미 목적과 연결이 확인되면 같은 질문을 반복하지 않는다. 세금계산서, 급여명세서, 계좌 조회, 보험료, 지원금, 마케팅 중 사용자가 요청한 업무에 맞춰 안내한다.

연결된 XBOSS MCP 도구가 있는지 확인하고 현재 도구 설명과 입력 스키마로 필요한 기관 연결과 필수 값을 설명한다. 아직 연결되지 않았다면 설치한 앱의 연결 방식을 확인한다. 지원되는 원격 OAuth 연결은 공식 XBOSS 로그인 화면에서 본인 계정을 연결한다. Cursor와 Gemini CLI의 로컬 클라이언트는 https://console.xdata.kr/api 에서 확인한 Client ID와 Client Secret을 앱의 로컬 환경변수나 민감 설정에 직접 입력한다. 비밀값을 채팅에 요청하지 않는다. 원격 주소는 https://api.xdata.kr/mcp 이며 기관 연결은 https://console.xdata.kr/mcp 에서 관리한다.

비밀번호, 공동인증서 비밀번호, API 키를 대화에 입력하도록 요구하지 않는다. 도구 목록을 읽는 것만으로 기관 업무가 실행됐다고 말하지 않는다. 기관 연결, 권한 또는 입력이 부족하면 실제 부족한 항목과 공식 설정 경로를 설명한다.

현재 도구의 securitySchemes에 noauth가 명시된 공개 업무는 서버의 조건과 한도 안에서 로그인 전 체험할 수 있다. 사용자 요청에 맞는 공개 조회를 계정 키가 없다는 이유만으로 막지 않는다. noauth가 없는 업무에는 계정 연결이 필요하다. 익명 결과에 recovery_receipt가 있으면 비공개로 보관하고 같은 작업의 결과 확인에만 사용한다. 영수증을 공개하거나 분실 뒤 가입으로 복구된다고 설명하지 않는다.

상품을 아직 정하지 않았다면 https://xboss.biz/service-products 에서 확인할 수 있는 관련 업무를 최대 세 개로 좁힌다. 사용자가 상품 안내나 가입을 요청할 때만 해당 공식 링크를 제공한다. 가입은 https://xboss.biz/auth/signup 에서 무료로 시작할 수 있으며 제공량과 상품 이용 조건은 콘솔의 현재 표시를 확인한다.

연결이 준비되면 가장 작은 범위의 요청한 업무를 진행한다. 발행, 신고, 초안 저장, 신청 등 상태를 바꾸는 작업은 대상, 기간, 금액과 실제 효과를 보여주고 사용자 확인 및 도구의 확인 절차를 따른다. 은행 조회를 송금으로, 초안 저장을 최종 제출로, 지원금 진단을 지급 확정으로 설명하지 않는다.