전체 활용 사례

// 업종별 — 그대로 따라가는 시나리오

SaaS 스타트업 — 캐시 사이클 자연어 요약

Claude Desktop 에서 "이번달 매출/카드/캐시 사이클" 한 줄 — MRR 대비 카드 지출, 운영 자금 잔액, runway 까지.

MCP주 1회 (월요일 아침)

이런 분께 런웨이를 매주 체크하는 초기 SaaS 창업자·CFO.

MCP · Claude

이번달 캐시 사이클 요약해줘

4월 매출입금 38,400,000 (전월 +12%)

카드 지출 18,210,000 (운영비 80%)

운영 잔액 142,800,000 · runway 약 7.8개월

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 캐시 변화랑 번 알려줘
다음SaaS 스타트업 — 주간 번/런웨이 Slack