// local

주간 캐시플로우·런웨이

통장 잔고와 카드 지출을 한 화면에서 보고 싶을 때. 주간 번·런웨이를 직접 만든 대시보드에 띄웁니다.

// 상황

이런 상황이라면

잔고와 지출이 흩어져 있다

통장은 통장대로, 카드는 카드대로 봐서 한 화면에 모이지 않습니다.

런웨이를 매번 손으로

번과 남은 개월을 계산하려면 매주 자료를 모아 정리합니다.

늦게 아는 현금 상황

현금이 빠듯해지는 걸 뒤늦게 알아챕니다.

// 흐름

어떻게 동작하나

은행·카드 수집

입출금내역과 카드 승인내역을 받습니다.

주간으로 합산

들어온 돈과 나간 돈을 주 단위로 모읍니다.

대시보드에 표시

주간 번과 런웨이를 직접 만든 화면에 띄웁니다.

// schemas

사용 데이터 형식

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

기업뱅킹 입출금내역

은행기간 지정

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

bank.transactions.cb.v1

법인카드 승인내역

법인카드기간 지정

기간별 카드 승인 거래. 승인일시·가맹점·결제 금액·할부·승인 상태를 받습니다.

card.approvals.corp.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를 넣는다. 등록 후 클라이언트 재시작.

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

프롬프트

이번달 매출 입금 합, 법인카드 출금 합, 운영 잔액을 받아서 runway 까지 요약해줘.

이렇게 보이면 성공

4월 매출입금 38,400,000 (전월 +12%)
카드 지출 18,210,000 (운영비 80%)
운영 잔액 142,800,000 · runway 약 7.8개월

03검증

매출 입금 합·카드 출금 합·운영 잔액·추정 runway 가 한 응답에 온다.
"표로" 또는 "전월 대비"로 더 깊게 물을 수 있다.

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

지난주 net 캐시 변화랑 번 알려줘

전체 가이드 페이지로 보기

// 더 보기

자주 묻는 질문

은행과 카드를 합쳐 보나요?

입출금내역과 카드 승인내역을 함께 받아 한 화면에서 봅니다.

매주 자동으로 갱신되나요?

스케줄로 주간 수집을 돌리면 대시보드가 자동으로 갱신됩니다.

런웨이 계산식은 정할 수 있나요?

받은 데이터로 번·런웨이 계산을 직접 구성합니다.

// related