// platform

다중 고객·클라이언트 데이터 수집

여러 고객사의 세금계산서·거래내역을 한 흐름으로 받을 때. 회계 소프트웨어·세무 서비스가 클라이언트를 한꺼번에 수집합니다.

// 상황

이런 상황이라면

고객사마다 따로 로그인

세무·회계 서비스는 고객사 수만큼 홈택스·은행에 접속해야 합니다. 손으로 하면 고객사가 늘수록 감당하기 어려워집니다.

수집 방식이 제각각

고객사마다 자료 받는 절차가 달라 표준화가 어렵습니다.

마감마다 같은 일 반복

분기·월마다 같은 수집을 처음부터 다시 합니다.

// 흐름

어떻게 동작하나

고객사별 자격증명 등록

고객사마다 자격증명을 등록해 두면 한 워크스페이스에서 묶어 관리합니다.

한 흐름으로 일괄 수집

고객사 목록을 돌며 같은 수집 요청을 보냅니다. 세금계산서와 거래내역을 함께 받습니다.

고객사 단위로 정리

결과는 표준 데이터 형식으로 와서 고객사별로 나눠 저장하거나 전달하기 쉽습니다.

// schemas

사용 데이터 형식

이 시나리오에서 받는 데이터입니다. 기관이 달라도 같은 모양으로 옵니다. 필드 전체 명세는 각 데이터 형식 문서에서 확인할 수 있습니다.

매출 (세금)계산서

홈택스기간 지정

발행한 전자세금계산서·면세계산서. 공급가액·세액·합계와 공급받는자 정보를 받습니다.

hometax.tax-invoices.sales.v1

매입 (세금)계산서

홈택스기간 지정

수취한 전자세금계산서·면세계산서. 공급자 정보와 공급가액·세액·합계를 받습니다.

hometax.tax-invoices.purchase.v1

기업뱅킹 입출금내역

은행기간 지정

기간별 입출금 거래. 거래일시·금액(입금 +/출금 −)·적요·거래 후 잔액을 계좌 유형 구분과 함께 받습니다.

bank.transactions.cb.v1

// 결과물

손에 남는 것

고객사별 매출·매입 세금계산서를 일괄로

거래내역까지 함께 묶어 수집

마감 때마다 반복하던 수동 접속 제거

고객사가 늘어도 같은 흐름으로 확장

// 실행 가이드

그대로 따라 하면 됩니다

사전 점검부터 검증까지 이 페이지에서 끝납니다. 실행 방식이 여럿이면 하나만 고르면 됩니다.

01사전 점검

아래 명령을 붙여 넣어 현재 환경이 준비됐는지 확인합니다.

API Key 가 있다 (MCP 설정 env 에 넣을 값)
echo $H6S_API_KEY
h6s_live_... 로 시작하는 키가 출력된다
대안으로 콘솔(https://h6s.ai)에서 발급 후 export H6S_API_KEY=h6s_live_...
클라이언트별 워크스페이스 자격증명이 등록돼 있다 (MCP는 등록 안 함)
h6s credentials list
대상 기관에 매칭되는 자격증명이 1건 이상 보입니다
대안으로 h6s credentials create --interactive --cert
CLI가 글로벌 설치돼 있다 (MCP cold-start 회피)
h6s --version
버전 문자열이 출력됩니다
대안으로 npm i -g @h6s-ai/cli

02실행

클라이언트별 설정 파일을 toolkit 이 생성·병합한다. 한 번만.

terminal

npx @h6s-ai/toolkit install --target=cursor   # 또는 --target=mcp | gemini

Claude Desktop은 --target=mcp 출력을 claude_desktop_config.json의 mcpServers에 병합하고 env 블록에 H6S_API_KEY를 넣는다. 등록 후 클라이언트 재시작.

등록이 끝나면 채팅창에 자연어 한 줄.

프롬프트

에이클라이언트 워크스페이스에서 이번주 입출금 받아서 특이 거래 있으면 표시해줘.

이렇게 보이면 성공

workspace: client-a (자동 해석)
입금 3건 +6,840,000 / 출금 5건 -2,120,000
특이 거래 1건 · 2026-04-29 -1,500,000 적요 불명

03검증

클라이언트명을 자연어로 부르면 해당 워크스페이스로 해석되어 자료를 횡단한다.
이번주 입출금 요약과 특이 거래가 채팅창에 직접 온다.

04흔한 에러

MCP 서버가 연결 안 됨 / handshake timeout

npx cold-start (npm cache hydration) 가 handshake 보다 느리다.

해결 npm i -g @h6s-ai/cli 로 글로벌 설치 후 클라이언트 재시작.

도구 호출 시 NO_API_KEY 친절 에러

MCP 설정의 env 블록에 H6S_API_KEY 가 빠졌다.

해결 설정 파일 mcpServers.h6s.env 에 H6S_API_KEY 추가 후 재시작.

CERT_EXPIRED · CERT_WRONG_PASSWORD

등록된 공동인증서가 만료됐거나 비밀번호가 틀렸다.

해결 h6s credentials update 로 갱신 후 재실행.

자격증명을 찾을 수 없음

MCP는 자격증명 등록을 다루지 않는다.

해결 CLI(h6s credentials create) 또는 콘솔에서 먼저 등록.

05변형

같은 사례에서 자주 바꾸는 옵션. 다른 사례는 아래 이전/다음에서.

다른 클라이언트·기간

terminal

비클라이언트 지난달 매출 세금계산서 합계 알려줘

전체 가이드 페이지로 보기

// 더 보기

거래처	공급가액	세액	발행일
㈜에이클라이언트	12,500,000	1,250,000	2026-04-12
비클라이언트	3,800,000	380,000	2026-04-20

자주 묻는 질문

고객사가 많아도 한 번에 되나요?

고객사별 자격증명을 등록해 두면 목록을 돌며 같은 요청을 보냅니다. 결과는 고객사 단위로 구분됩니다.

세금계산서와 거래내역을 함께 받을 수 있나요?

네. 매출·매입 세금계산서와 은행 입출금내역을 같은 흐름에서 수집합니다.

고객사 자격증명은 안전한가요?

자격증명은 암호화해 보관하고 수집 시점에만 복호화합니다.

// related