후잉 MCP 사용 가이드

후잉 MCP는 표준 Model Context Protocol 서버입니다. Claude, ChatGPT, OpenAI API처럼 원격 MCP를 지원하는 도구에서 같은 엔드포인트로 후잉 가계부를 직접 대화로 사용할 수 있습니다.

MCP 엔드포인트:

https://whooing.com/mcp

OpenAI의 GPT Actions(OpenAPI JSON 스펙 등록)와 MCP는 다른 방식입니다. 후잉 MCP를 쓰는 경우 OpenAPI 스펙을 등록하지 않고, MCP 서버 URL로 https://whooing.com/mcp를 등록합니다.

ChatGPT 설정

준비물

Plus·Pro·Business·Enterprise·Education 계정 (웹에서만 지원)
후잉 계정

1. 개발자 모드 켜기

설정 → Security and login(보안 및 로그인) 에서 Developer mode(개발자 모드) 를 켭니다.

Business·Enterprise·Education은 관리자가 Workspace Settings → Permissions & Roles → Connected Data 에서 개발자 모드와 커스텀 MCP 커넥터 생성을 먼저 허용해야 합니다.

2. 커넥터 만들기

ChatGPT Plugins 로 이동
+ 버튼 클릭
개발자 모드 앱(developer-mode app) 만들기 선택
MCP 서버 URL 입력: https://whooing.com/mcp (끝의 /mcp 경로까지 포함)
인증은 OAuth 를 선택하고, 연결 테스트가 성공하면 후잉 로그인 및 권한 승인

3. 대화에서 사용

메시지 입력창의 + 메뉴에서 Developer mode 선택
그 대화에서 쓸 앱으로 후잉을 선택
"후잉 앱으로 이번 달 지출 보여줘" 처럼 앱을 지목해서 요청하면 더 확실하게 동작합니다

앱 상세 화면에서 개별 도구를 켜고 끌 수 있고, 새로고침하면 후잉이 제공하는 최신 도구 목록을 다시 받아옵니다.

메뉴가 보이지 않으면 워크스페이스 정책이나 계정 플랜을 확인하세요.

OpenAI API에서 사용

Responses API의 MCP 도구로 후잉 MCP 서버를 지정할 수 있습니다.

{
    "model": "사용할 모델",
    "tools": [
        {
            "type": "mcp",
            "server_label": "whooing",
            "server_description": "후잉 복식부기 가계부 데이터를 조회하고 입력합니다.",
            "server_url": "https://whooing.com/mcp",
            "authorization": "OAuth access token",
            "require_approval": "always"
        }
    ],
    "input": "이번 달 지출 내역 보여줘"
}

API에서 직접 사용할 때는 애플리케이션이 OAuth access token을 발급받아 authorization에 전달해야 합니다. 토큰 발급은 Authorization Code Flow이며 PKCE(S256)가 필수입니다(client_secret은 쓰지 않습니다). 절차는 API 문서의 OAuth 2.0을 따르세요. 민감한 가계부 데이터와 쓰기 기능이 포함되어 있으므로 require_approval은 처음에는 always로 두는 것을 권장합니다. 쓰기 도구를 빼고 조회만 열고 싶다면 allowed_tools로 사용할 도구를 좁힐 수 있습니다.

Claude 설정 (웹·데스크톱·모바일 공통)

준비물

후잉 계정
Free·Pro·Max·Team·Enterprise 중 아무 플랜 (Free는 커스텀 커넥터 1개까지)

후잉 MCP는 원격 커넥터입니다. 한 번 추가하면 claude.ai 웹·모바일·Claude Desktop·Claude Code에서 모두 쓸 수 있습니다. 클라이언트마다 따로 등록할 필요가 없습니다.

개인 계정 (Free/Pro/Max)

설정 → 커넥터(Settings → Connectors) 로 이동 (버전에 따라 Customize → Connectors 로 보이기도 합니다)
+ 를 누르고 커스텀 커넥터 추가(Add custom connector) 선택
URL 입력: https://whooing.com/mcp
추가(Add) 를 누르면 브라우저가 열립니다. 후잉 로그인 및 권한 승인

Team·Enterprise

소유자(Owner)가 먼저 조직에 등록해야 하고, 구성원은 그 다음에 각자 연결합니다.

소유자:

조직 설정 → 커넥터(Organization settings → Connectors) 로 이동
추가(Add) 클릭
Custom 에 마우스를 올린 뒤 Web 선택
URL https://whooing.com/mcp 입력 후 추가

구성원:

설정 → 커넥터 로 이동
소유자가 추가한 후잉 커넥터를 찾아 연결(Connect) 클릭

알아둘 점

Claude는 사용자 기기가 아니라 Anthropic 클라우드에서 후잉 MCP 서버에 접속합니다. 후잉은 공개 서버라 문제없지만, 같은 방식으로 사내망이나 VPN 뒤의 서버를 연결하려 하면 동작하지 않습니다.

claude_desktop_config.json과 데스크톱 확장(.mcpb)은 로컬 MCP 서버용 장치입니다. 후잉 같은 원격 서버는 위 커넥터로 붙이면 되고, 설정 파일을 만질 필요가 없습니다. 예외는 아래 AI 토큰 방식 뿐입니다.

Claude Code (CLI) 설정

claude.ai에 커넥터를 이미 추가했다면 Claude Code에서도 그대로 잡힙니다. 터미널에서 직접 등록하려면 아래와 같이 합니다.

등록

# 전역 (모든 프로젝트에서 사용)
claude mcp add --transport http whooing https://whooing.com/mcp --scope user

# 현재 프로젝트에서만
claude mcp add --transport http whooing https://whooing.com/mcp

--transport·--scope는 각각 -t·-s로 줄여 쓸 수 있습니다. 팀원과 설정을 공유하려면 --scope project로 등록하면 프로젝트의 .mcp.json에 기록됩니다.

후잉 계정 연결

등록 후 Claude Code 안에서 /mcp를 입력하거나, 터미널에서 아래를 실행하면 브라우저가 열립니다. 후잉 로그인 및 권한 승인을 마치면 연결이 완료됩니다.

claude mcp login whooing

확인·관리

claude mcp list          # 등록된 서버 목록
claude mcp get whooing   # 후잉 커넥터 상세
claude mcp remove whooing

Claude Code 안에서 /mcp를 입력하면 연결 상태와 사용 가능한 도구를 바로 볼 수 있습니다.

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

브라우저 팝업이 뜨지 않거나 OAuth 인증이 정상적으로 동작하지 않는 경우, AI 토큰을 헤더로 직접 넘기는 방식으로 연결할 수 있습니다. 임의의 HTTP 헤더를 설정할 수 있는 클라이언트에서만 동작합니다 — Claude Code는 --header 옵션으로, Claude Desktop은 설정 파일에 mcp-remote 브리지를 써서 넘깁니다. claude.ai 웹과 ChatGPT 웹은 이 방식을 쓸 수 없으니 OAuth로 연결하세요.

AI 토큰 발급

후잉 홈페이지 → 계정 > 비밀번호 및 보안 으로 가서 «승인된 써드파티» 아래 + AI 연동 버튼을 누르면 토큰이 발급됩니다.

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

Claude Desktop 설정

설정 파일 claude_desktop_config.json에 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 서버가 인식되지 않는다면 이 경로를 확인하세요.

파일이 없으면 새로 만들고, 기존에 다른 MCP 서버가 있다면 mcpServers 안에 "whooing": { ... } 부분만 추가하면 됩니다. 저장 후 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...로 시작하는 전체 문자열)"

--header는 -H로 줄여 쓸 수 있습니다.

GPT Actions와의 차이

OpenAI에는 외부 서비스를 연결하는 방식이 둘 있습니다.

방식	등록값	사용 위치
MCP (앱·플러그인·커넥터)	`https://whooing.com/mcp`	ChatGPT 개발자 모드 앱, OpenAI Responses API MCP 도구, Claude 커넥터
GPT Actions	OpenAPI JSON 또는 YAML 스펙	커스텀 GPT Actions

후잉 MCP는 첫 번째 방식입니다. 커스텀 GPT의 Actions 메뉴에서 OpenAPI 스펙을 요구한다면, 그 화면은 MCP 등록 화면이 아닙니다.

ChatGPT는 2026년 7월부터 앱 디렉토리를 플러그인 디렉토리로 통합했습니다. 화면에 «앱»과 «플러그인»이 섞여 보이더라도 후잉을 붙이는 경로는 위의 개발자 모드 앱 하나입니다.

사용 예시

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

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

사용 가능한 기능

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

권한(Scope) 안내

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

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

연결 해제

후잉 홈페이지 → 계정 > 비밀번호 및 보안 의 «승인된 써드파티» 목록에서 연결을 해제할 수 있습니다. 클라이언트 쪽에서도 커넥터를 지우려면 Claude는 설정 → 커넥터, ChatGPT는 플러그인 설정, Claude Code는 claude mcp remove whooing을 씁니다.

이용 제한

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

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

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

문의

support@whooing.com

변경 내역

각 클라이언트의 메뉴 구성은 수시로 바뀝니다. 화면과 다르면 support@whooing.com으로 알려주세요.

2026-09-22 Claude 연결을 원격 커넥터 하나로 통합(웹·모바일·데스크톱·Claude Code 공용). 설정 파일은 AI 토큰 방식에만 필요
2026-09-22 Claude 커넥터 추가 경로·Team/Enterprise 소유자 등록 절차 갱신, Free 플랜 지원(1개) 반영
2026-09-22 ChatGPT 개발자 모드·커넥터 생성·대화 중 사용 경로를 현행 UI로 갱신, Plus·Education 플랜 추가
2026-09-22 Claude Code에 claude mcp login·/mcp·get/remove·프로젝트 공유 설정 추가
2026-09-22 AI 토큰 발급 경로를 실제 화면(계정 > 비밀번호 및 보안 > + AI 연동)으로 정정
2026-06-14 ChatGPT 커넥터 연결 UI 경로 갱신, OpenAI 지원 사항 보완
2026-04-26 Claude Desktop 연결 가이드 수정
2026-04-25 AI 토큰 형식(__ 접두사) 명시
2026-04-23 Windows Microsoft Store 설치 시 설정 파일 경로 주의사항 추가
2026-04-02 후잉 MCP 정식 제공 시작