COMMANDS & EXAMPLES

복잡한 API 호출을
익숙한 명령어로 바꿔요.

조회, 발행, 설정 명령을 CLI에서 실행해요. 자주 쓰는 예시 정리.

REFERENCE

필요한 작업을
명령어로 찾아요.

조회 명령어

거래, 잔액, 거래처, 급여 데이터를 읽을 때 사용해요.

  • apisCLI 지원 Public API 카탈로그 열람
  • tx거래·증빙 티켓 조회
  • bal계좌 잔액 흐름 조회
  • contacts거래처 목록 조회
  • salary급여 내역 조회

수정·발행·설정 명령어

JSON 파일로 쓰기 작업을 실행하고 API 키를 관리할 때 사용해요.

  • init브라우저·터미널 로그인 및 API 키 저장
  • configAPI 키·Base URL·현재 설정 관리
  • ticket-update티켓 계정과목·태그·설명 수정
  • inv issueJSON 파일 기반 세금계산서 발행
  • cr issueJSON 파일 기반 현금영수증 발행
  • granter-mcpMCP 서버 실행 파일
EXAMPLES

반복 업무는
복사해서 시작해요.

월말 조회, 정기 발행, AI 연동 흐름을 예시로 묶었어요. 값만 바꾸면 자동화 스크립트로 연결.

월말 데이터 조회

카드, 계좌, 세금계산서를 같은 기간으로 확인해요.

# 이번 달 카드 내역 전부
$ granter tx --type EXPENSE_TICKET --from 2026-04-01 --to 2026-04-30
 
# 계좌 잔액 흐름
$ granter bal --from 2026-04-01 --to 2026-04-30
 
# 거래처별 세금계산서
$ granter tx --type TAX_INVOICE_TICKET --from 2026-04-01 --to 2026-04-30

정기 세금계산서 발행

발행 내용을 JSON 파일로 준비해요.

$ granter inv issue \
--file invoices/april-beta.json
✓ 발행 완료 · 주식회사 베타
 
$ granter inv issue \
--file invoices/april-gamma.json
✓ 발행 완료 · 주식회사 감마
 
# 날짜만 바꿔 매달 반복

AI 도구와 함께 쓰기

MCP가 같은 조회 흐름을 대신 호출해요.

You › "3월 대비 4월
마케팅비 얼마나 늘었어?"
 
→ list_transactions (3월)
→ list_transactions (4월)
→ 계정과목 '광고선전비' 집계
 
Claude › 광고선전비는
3월 대비 +34% 증가했어요.
AUTOMATION

매번 하는 조회는
한 줄로 다시 실행해요.

시작일과 종료일만 바꿔 같은 조회를 반복해보세요. 결과 JSON은 리포트, 대시보드, AI 분석 단계로 전달 가능.

close-month.sh
#!/bin/bash
START=$1 # 예: 2026-04-01
END=$2 # 예: 2026-04-30
 
granter tx --type EXPENSE_TICKET \
--from "$START" --to "$END" > out/expense.json
granter bal --from "$START" --to "$END" > out/balance.json
 
echo "✓ $START ~ $END 마감 데이터 준비 완료"

명령어가 정리되면,
AI도 같은 흐름을 따라요.

MCP로 연결하면 사람이 자연어로 요청하고, AI가 필요한 조회 명령을 실행해요.