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

회계법인 — 클라이언트 자연어 조회

Claude Desktop 에서 "○○클라이언트 이번주 거래 알려줘" 한 줄. workspace 별로 분리된 다중 클라이언트 자료를 자연어로 횡단.

MCP임의

이런 분께 — 여러 클라이언트를 동시에 보는 세무사·회계사.

MCP · Claude

에이클라이언트 이번주 입출금 알려줘

workspace: client-a (자동 해석)

입금 3건 +6,840,000 / 출금 5건 -2,120,000

특이 거래 1건 — 2026-04-29 -1,500,000 적요 불명▍

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

클라이언트별 설정 파일을 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 적요 불명

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) 또는 콘솔에서 먼저 등록.

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

다른 클라이언트·기간

terminal

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