후잉 MCP 사용 가이드

Claude AI 또는 MCP를 지원하는 AI 도구에서 후잉 가계부를 직접 대화로 사용할 수 있습니다.

Claude Desktop 설정

준비물

Claude Desktop 설치
후잉 계정

Claude Desktop에서 원격 MCP 서버를 연결하는 방법은 두 가지입니다.

방법 1: Connectors UI (Pro/Max/Team/Enterprise 플랜)

설정 파일 없이 Claude Desktop UI에서 직접 연결합니다.

Claude Desktop에서 Settings → Connectors → Add custom connector 클릭
URL 입력: https://whooing.com/mcp
브라우저가 열리면 후잉 로그인 및 권한 승인

방법 2: mcp-remote 설정 파일 (모든 플랜)

claude_desktop_config.json 파일에 mcp-remote를 통해 연결합니다.

Claude Desktop의 설정 파일은 HTTP 서버를 직접 지원하지 않아 mcp-remote 브리지가 필요합니다.

설정 파일 경로

Mac:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Microsoft Store에서 설치한 경우 위 경로가 아닌 아래 경로를 사용해야 합니다.
%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
MCP 서버가 인식되지 않는다면 이 경로를 확인하세요.

파일이 없으면 새로 만드세요.

추가할 내용

Mac/Linux:

{
    "mcpServers": {
        "whooing": {
            "command": "npx",
            "args": ["-y", "mcp-remote", "https://whooing.com/mcp"]
        }
    }
}

Windows:

{
    "mcpServers": {
        "whooing": {
            "command": "npx.cmd",
            "args": ["-y", "mcp-remote", "https://whooing.com/mcp"]
        }
    }
}

기존에 다른 MCP 서버가 있다면 mcpServers 안에 "whooing": { ... } 부분만 추가하면 됩니다.

Claude Desktop 재시작

설정 파일 저장 후 Claude Desktop을 완전히 종료했다가 다시 실행하세요.

후잉 계정 연결

처음 실행 시 브라우저가 열리면서 후잉 로그인 및 권한 승인 화면이 나타납니다. 승인하면 연결이 완료됩니다.

Claude Code (CLI) 설정

터미널에서 사용하는 Claude Code에서도 동일하게 연결할 수 있습니다.

전역 설정 (모든 프로젝트에서 사용)

claude mcp add --transport http whooing https://whooing.com/mcp --scope user

프로젝트별 설정

프로젝트 루트에서 실행하면 해당 프로젝트에서만 활성화됩니다.

claude mcp add --transport http whooing https://whooing.com/mcp

설정 확인

claude mcp list

후잉 계정 연결

처음 사용 시 Claude Code가 브라우저를 열어 후잉 로그인 및 권한 승인을 요청합니다. 승인하면 연결이 완료됩니다.

브라우저 OAuth 인증이 어려운 경우 (AI 토큰 방식)

Claude Desktop이나 Claude Code 환경에서 브라우저 팝업이 뜨지 않거나 OAuth 인증이 정상적으로 동작하지 않는 경우, AI 토큰을 직접 입력하는 방식으로 연결할 수 있습니다.

AI 토큰 발급

후잉 홈페이지 → 사용자 > 계정 > 비밀번호 및 보안 > AI 토큰 발급에서 토큰을 발급받으세요.

발급된 토큰은 __eyJh... 형식으로 앞의 __ 두 글자를 포함한 전체 문자열이 토큰입니다. __를 제거하거나 생략하지 마세요.

Claude Desktop 설정

Mac/Linux:

{
    "mcpServers": {
        "whooing": {
            "command": "npx",
            "args": ["-y", "mcp-remote", "https://whooing.com/mcp", "--header", "X-API-Key: 발급받은 AI 토큰(__eyJh...로 시작하는 전체 문자열)"]
        }
    }
}

Windows:

{
    "mcpServers": {
        "whooing": {
            "command": "npx.cmd",
            "args": ["-y", "mcp-remote", "https://whooing.com/mcp", "--header", "X-API-Key: 발급받은 AI 토큰(__eyJh...로 시작하는 전체 문자열)"]
        }
    }
}

Claude Code 설정

전역 설정 (모든 프로젝트에서 사용):

claude mcp add --transport http whooing https://whooing.com/mcp --scope user --header "X-API-Key: 발급받은 AI 토큰(__eyJh...로 시작하는 전체 문자열)"

프로젝트별 설정:

claude mcp add --transport http whooing https://whooing.com/mcp --header "X-API-Key: 발급받은 AI 토큰(__eyJh...로 시작하는 전체 문자열)"

이 방식은 Claude Desktop과 Claude Code에서만 동작합니다. Claude.ai 웹은 OAuth 방식만 지원합니다.

사용 예시

연결 후 Claude와 대화하듯 가계부를 사용할 수 있습니다.

"이번 달 지출 내역 보여줘"
"오늘 점심 15,000원 식비로 기록해줘"
"이번 달 손익 보고서 보여줘"
"지난 3개월 현금흐름 분석해줘"
"저축 계좌 잔액이 얼마야?"

사용 가능한 기능

기능	설명
거래 내역	기간별 입출금 조회, 새 거래 입력·수정·삭제
계정 항목	자산·부채·수입·지출 항목 잔액 조회, 추가·수정·삭제
장부(섹션) 관리	여러 가계부 장부 생성·수정·삭제
매월입력 거래	월별 고정 지출·수입 등록 및 관리
자주입력 거래	자주 쓰는 거래 패턴 저장·수정·삭제·순서 변경
포스트잇	장부별 메모 추가·수정·삭제
예산	예산 현황 조회, 항목별 예산 설정·삭제
장기목표	장기 재무 목표 설정 및 월별 목표 관리
보고서	손익계산서·재무상태표·현금흐름표·기간별 통계
사용자 정의 보고서	커스텀 보고서 항목 구성·수정·삭제
커뮤니티 게시판	후잉 커뮤니티 게시물 조회
쪽지	후잉 사용자 간 쪽지 확인 및 발송
사용자 설정	타임존·통화 등 계정 설정 조회·변경

권한(Scope) 안내

승인 화면에서 요청하는 권한의 의미입니다.

권한	설명
`read`	가계부 데이터 읽기
`write`	거래 입력·수정·삭제
`messages`	쪽지 읽기 및 발송
`post_it`	포스트잇 접근
`bbs`	게시판 접근

연결 해제

후잉 홈페이지 → 계정 → 비밀번호 및 보안 → 연결된 앱에서 Claude MCP 연결을 해제할 수 있습니다.

이용 제한

AI가 자동으로 많은 요청을 보낼 수 있어 아래와 같은 제한이 적용됩니다.

유형	한도
분당	20회
일일	20,000회

한도를 초과하면 잠시 요청이 차단되며(429 Too Many Requests), 잠시 후 재시도하면 됩니다. 일일 한도는 매일 자정에 초기화됩니다.

문의

support@whooing.com