도움말 › AI로 기록하기

Claude 연결하기

연결 주소를 등록하고 iobook에 로그인해 허용하면, Claude에서 대화로 거래를 기록하고 조회합니다.

5분2026년 11월 8일 수정

iobook에는 자체 AI가 없습니다. 대신 내가 쓰는 Claude 같은 AI에 iobook을 연결하면, 대화로 거래를 기록하고 조회할 수 있습니다. 설치할 것은 없습니다. 연결 주소를 AI에 등록하고, 열리는 화면에서 iobook에 로그인해 허용하면 됩니다.

시작 전에

1. 연결 주소 복사하기

  1. 사이드바 맨 아래의 내 이름을 눌러 설정을 열고 AI 연결을 고릅니다.
  2. AI에 연결 주소 등록하기에서 쓰는 AI의 탭(Claude, Claude Code, Claude Desktop, ChatGPT, Cursor, Codex)을 고릅니다.
  3. 복사 버튼으로 주소나 명령을 복사합니다.
MCP 연결 주소https://www.iobook.io/api/mcp복사토큰을 붙여 넣을 필요가 없습니다. 주소를 등록하면 AI가 브라우저에 iobook 로그인과 허용 화면을 엽니다.

주소는 누구에게나 같은 https://www.iobook.io/api/mcp입니다. 주소에 비밀이 들어 있지 않고, 토큰을 붙여 넣을 필요도 없습니다.

2. AI에 등록하고 허용하기

Claude 앱(웹·데스크톱)

  1. Claude 설정에서 커넥터 메뉴를 엽니다.
  2. 커스텀 커넥터를 추가합니다.
  3. 이름에 iobook을 적고, URL에 복사한 연결 주소를 붙여넣습니다. 고급 설정의 OAuth 칸은 비워 둡니다.
  4. 추가한 커넥터의 연결을 누르면 iobook 화면이 열립니다. 로그인하지 않았다면 먼저 로그인합니다.
  5. "Claude에서 내 iobook에 연결하려고 합니다" 화면에서 AI가 할 수 있는 일과 연결될 계정을 확인하고 허용을 누릅니다.

한 번 등록하면 Claude 웹, 모바일 앱, 데스크톱 앱에서 모두 쓸 수 있습니다. 모바일 앱에서는 커넥터 추가를 웹에서 해야 합니다.

Claude Code

  1. 터미널에서 다음 명령을 실행합니다. 모든 프로젝트에서 쓰려면 -s user를 붙입니다.

    claude mcp add --transport http iobook https://www.iobook.io/api/mcp
    
  2. Claude Code에서 /mcp를 열고 iobook을 골라 인증합니다.

  3. 브라우저에 열리는 iobook 화면에서 허용을 누릅니다.

다른 AI

원격 MCP 서버(Streamable HTTP)와 OAuth 로그인을 지원하는 AI라면 같은 주소로 연결할 수 있습니다. 인증 방식을 묻는다면 OAuth를 고르고, 클라이언트 ID 칸은 비워 둡니다. ChatGPT, Cursor, Codex는 AI 연결 화면의 각 탭에 등록 위치가 안내되어 있습니다.

로그인 창을 열지 못하는 AI는 토큰이 든 주소로 연결합니다. 아래 토큰으로 연결하기를 보세요.

3. 연결 확인하기

AI에게 이렇게 말해 봅니다.

내 가계부 이름이 나오면 연결된 것입니다. 허용한 AI는 계정 설정 › AI 연결의 연결된 앱 목록에 연결한 날짜와 함께 나옵니다.

4. 기록하고 확정하기

  • 한 건씩 말한 거래는 보통 바로 거래내역에 들어갑니다.
  • 파일, 사진, 긴 붙여넣기처럼 여러 건을 한 번에 넣으면 AI가 검토 대기 상태로 넣습니다. 검토 대기 거래는 웹에서 확인한 뒤 확정해야 거래내역과 합계에 반영됩니다.
  • 거래를 넣거나 고치면 AI가 iobook 링크를 함께 보여 줍니다. 한 건이면 그 거래가 바로 열리고, 여러 건이면 그 달의 거래내역이, 검토 대기로 넣었으면 대량 입력 화면이 열립니다. 예산이나 반복 거래를 바꾸면 그 화면의 링크입니다.

검토 대기 거래가 있으면 거래내역 화면에 이런 띠가 보입니다.

검토 대기 중인 거래 4건이 있어요.검토하기

검토하기를 누르면 대량 입력 화면으로 갑니다. 이 화면에서 다음을 할 수 있습니다.

  • 맨 위에서 카드·통장마다 모두 확정하면 얼마가 되는지 봅니다. 결제일을 넣은 신용카드는 이용 기간 청구액(이미 확정된 사용 + 검토 대기)이라, 카드 명세서의 결제 예정 금액과 바로 맞춰 볼 수 있습니다. 통장과 그 밖의 카드는 잔액입니다.
  • 할부는 그 기간 회차만 청구액에 들어가고, 환불은 빠집니다. 중복 의심 거래가 있으면 그것을 버렸을 때의 금액도 함께 나옵니다.
  • 카드나 통장이 둘 이상이면 표로 나옵니다. 행을 누르면 그 통장·카드의 검토 대기 거래만 보이고, 신한카드만 확정처럼 그 이름이 적힌 버튼으로 그것만 확정할 수 있습니다.
  • 행마다 ✓로 확정하거나 ✕로 버립니다. 한 번에 처리하려면 모두 확정 또는 버리기를 누릅니다.
  • 행을 누르면 거래를 고칠 수 있습니다. 고친 뒤에도 검토 대기로 남습니다.

이미 가계부에 있는 거래와 날짜, 금액, 결제 수단이 같으면 중복 의심 배지가 붙습니다. AI가 파일을 넣을 때는 이런 행을 아예 넣지 않고 건너뛴 행을 알려 줍니다.

이렇게 말해 보세요

종류예시
기록"오늘 점심 김밥천국 9,000원 신한카드로 기록해줘"
기록"어제 월급 320만 원 들어왔어. 급여 통장으로 기록해줘"
기록"이 영수증 사진 기록해줘"
기록"첨부한 카드 명세서 파일 전부 넣어줘"
조회"이번 달 식비 얼마 썼어?"
조회"지난달 스타벅스 거래 찾아줘"
수정"방금 넣은 점심 거래 금액을 8,000원으로 고쳐줘"
정리"검토 대기 중인 거래 중에 분류가 이상한 것 알려줘"
예산"이번 달 예산 얼마나 남았어? 식비 예산을 40만 원으로 올려줘"
반복"매달 25일 월세 50만 원 주거래 통장에서 나가게 반복 거래 만들어줘"
카드"신한카드 이번 달 청구 금액이랑 할부 내역 보여줘"
결산"올해 손익계산서를 작년이랑 비교해서 정리해줘"

AI가 할 수 있는 일

AI는 다음 일만 할 수 있습니다.

  • 가계부 목록, 자산·부채와 분류 목록 보기
  • 거래 검색, 기간별 수입·지출·분류별 합계와 잔액 보기. 합계는 리포트처럼 리포트에서 빼기를 한 분류를 빼고, 뺀 금액은 따로 알려 줍니다
  • 과거에 비슷한 이름의 거래를 어떤 분류로 넣었는지 참고하기
  • 거래 넣기(한 번에 최대 100건, 바로 확정 또는 검토 대기), 고치기, 검토 대기 거래 확정하기, 지우기
  • 가계부에 없는 분류나 통장·카드 만들기(소유자·관리자만)
  • 통장·카드의 시작 잔액 넣기(소유자·관리자만). “주거래 통장에 9월 30일 기준 240만 원 있었어”처럼 말하면 됩니다.
  • 예산 보기, 분류 그룹별 예산 정하기(정하기는 소유자·관리자만). 숫자는 예산 화면과 같습니다.
  • 반복 거래 보기, 만들기, 고치기, 멈추기, 지우기
  • 신용카드의 이용 기간별 청구액과 이용 내역 보기(카드에 이용 기간 기준일이 있어야 합니다)
  • 재무상태표·손익계산서 보기(한 달 또는 한 해, 이전 기간과 함께)

멤버, 가계부 설정은 AI로 바꿀 수 없습니다. AI가 넣은 거래는 항상 모든 멤버에게 보이며, 나만 보기로 넣을 수 없습니다.

권한은 웹과 같습니다.

  • 권한을 읽기만으로 바꾼 연결은 보기, 검색, 합계만 합니다. 거래, 예산, 반복 거래, 분류·자산·부채 항목, 시작 잔액을 넣거나 바꾸는 일은 할 수 없습니다. 바꾸는 법은 권한 바꾸기를 보세요.
  • 보기 전용 멤버인 가계부에는 기록하거나 고칠 수 없습니다.
  • 다른 멤버의 나만 보기 거래는 AI에게도 보이지 않습니다.
  • AI가 한 변경은 변경 기록에 배지와 함께 남습니다. 로그인으로 연결한 AI는 배지에 앱 이름(예: Claude)이, 토큰으로 연결한 AI는 AI가 표시됩니다.
  • AI는 위에 적힌 일만 할 수 있습니다. 멤버, 가계부 설정, 내 계정(이메일, 비밀번호, 탈퇴)은 AI로 바꿀 수 없습니다.

연결 하나당 한 시간에 600번까지 요청할 수 있습니다.

권한 바꾸기

새로 허용한 앱과 새로 만든 토큰은 읽고 쓰기로 시작합니다. 조회만 시키려면 연결마다 읽기만으로 바꿀 수 있고, 언제든 되돌릴 수 있습니다.

  1. 계정 설정 › AI 연결을 엽니다.
  2. 연결된 앱 목록(토큰이라면 토큰으로 연결 (고급)의 목록)에서 그 연결 옆의 권한을 누릅니다.
  3. 읽고 쓰기나 읽기만을 고릅니다. "권한을 바꿨습니다. 다음 요청부터 적용됩니다."가 나오면 끝입니다.

AI에서 다시 연결할 필요는 없습니다.

연결 끊기

계정 설정 › AI 연결의 연결된 앱 목록에서 앱 옆의 연결 끊기를 누르고, 확인 창에서 한 번 더 연결 끊기를 누릅니다. 그 앱은 다음 요청부터 iobook을 쓸 수 없습니다. 다시 쓰려면 AI에서 다시 연결하고 허용합니다. 다시 연결한 앱은 읽고 쓰기로 시작합니다.

토큰으로 연결하기

로그인 창을 열지 못하는 AI는 토큰이 든 주소로 연결할 수 있습니다. 예전에 만든 토큰 주소도 그대로 동작합니다.

  1. 계정 설정 › AI 연결 아래의 토큰으로 연결 (고급)을 엽니다.
  2. 토큰 이름 칸에 연결할 AI 이름을 적습니다. 비워 두면 MCP로 저장됩니다.
  3. 토큰 만들기를 누르면 https://www.iobook.io/api/mcp/iob_… 형태의 연결 주소가 나타납니다. 이 화면을 벗어나면 다시 볼 수 없으니 바로 복사해 AI에 등록합니다. 인증 방식을 묻는다면 "인증 없음"을 고릅니다.
  • 목록에서 토큰마다 이름, 권한, 마지막 사용 시각을 볼 수 있습니다. 토큰은 읽고 쓰기로 만들어지고, 목록의 권한에서 읽기만으로 바꿀 수 있습니다. 한 번도 쓰지 않았으면 사용 안 함으로 나옵니다.
  • 휴지통 버튼을 누르고 확인 창에서 삭제를 누르면 토큰이 삭제되고, 그 주소로 연결된 AI도 즉시 끊깁니다. 되돌릴 수 없습니다.
  • 기기나 AI마다 토큰을 따로 만드세요. 하나를 잃어버려도 그것만 삭제하면 됩니다.

잘 안 될 때

AI가 iobook 도구를 못 찾습니다

주소가 https://www.iobook.io/api/mcp로 정확히 들어갔는지 확인합니다. Claude 앱이라면 커넥터의 연결을 눌러 허용까지 마쳤는지, Claude Code라면 /mcp에서 iobook이 인증된 상태인지 봅니다. 그래도 안 되면 커넥터를 지우고 다시 추가합니다.

허용 화면에서 다시 로그인하라고 합니다

iobook.io가 아니라 www.iobook.io에 로그인되어 있어야 합니다. 주소를 https://www.iobook.io/api/mcp로 등록했는지 확인하세요.

"연결 요청을 찾을 수 없거나 만료되었습니다"가 나옵니다

허용 화면을 오래 열어 두었거나 이미 처리한 요청입니다. AI에서 다시 연결을 시작하세요.

"권한이 없다"는 답이 옵니다

그 가계부에서 내가 보기 전용이면 기록할 수 없습니다. 분류나 통장·카드 만들기는 소유자·관리자만 할 수 있습니다. 연결을 끊었거나 토큰을 삭제했다면 AI에서 다시 연결합니다. 한 시간에 600번을 넘겨도 잠시 막힙니다.

"읽기만 허용된 연결"이라며 기록하지 못합니다

그 연결의 권한이 읽기만으로 되어 있습니다. 기록까지 시키려면 계정 설정 › AI 연결에서 그 앱이나 토큰의 권한을 읽고 쓰기로 바꾸세요. 권한 바꾸기를 보세요.

넣었다는데 거래내역에 안 보입니다

검토 대기로 들어갔을 수 있습니다. 거래내역의 검토 대기 띠나 대량 입력 화면을 확인하세요. 가계부가 여러 개라면 AI가 다른 가계부에 넣지 않았는지도 확인합니다.

토큰을 잃어버렸습니다

만든 토큰은 다시 볼 수 없습니다. 새 토큰을 만들어 AI에 다시 등록하고, 예전 토큰은 삭제하세요.