Claude 연결하기

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

시작 전에

1. 토큰 만들기

1. 계정 › AI 연결 화면을 엽니다.
2. 토큰 이름 칸에 알아보기 쉬운 이름을 적습니다. 예를 들어 Claude처럼 연결할 AI 이름을 쓰면 됩니다. 비워 두면 MCP로 저장됩니다.
3. 토큰 만들기를 누릅니다.
4. "이 토큰은 지금 한 번만 보입니다. 안전한 곳에 복사해 두세요." 상자가 나타납니다. 이 화면을 벗어나면 토큰을 다시 볼 수 없습니다.

MCP 연결 주소https://www.iobook.io/api/mcp/iob_••••••••••••••••복사이 토큰은 지금 한 번만 보입니다. 안전한 곳에 복사해 두세요.

토큰을 만들면 아래 AI에 연결 주소 등록하기의 주소에 방금 만든 토큰이 자동으로 채워집니다. 주소는 https://www.iobook.io/api/mcp/iob_… 형태입니다. 다음 단계를 이 화면에서 바로 이어서 하세요.

2. AI에 주소 등록하기

AI에 연결 주소 등록하기에는 AI별 탭(Claude, Claude Code, Claude Desktop, ChatGPT, Cursor, Codex)이 있습니다. 쓰는 AI의 탭을 고르고 복사 버튼으로 주소나 명령을 복사합니다.

Claude 앱(웹·데스크톱)

1. Claude 설정에서 커넥터 메뉴를 엽니다.
2. 커스텀 커넥터를 추가합니다.
3. 이름에 iobook을 적고, URL에 복사한 연결 주소를 붙여넣습니다.
4. 고급 설정의 OAuth 칸은 비워 둡니다.

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

Claude Code

터미널에서 다음 명령을 실행합니다. Claude Code 탭에서 복사하면 내 토큰이 들어간 명령이 복사됩니다.

claude mcp add --transport http iobook https://www.iobook.io/api/mcp/iob_…

모든 프로젝트에서 쓰려면 -s user를 붙입니다. claude mcp list로 연결을 확인할 수 있습니다.

다른 AI

원격 MCP 서버(Streamable HTTP)를 지원하는 AI라면 같은 주소로 연결할 수 있습니다. iobook은 OAuth를 쓰지 않습니다. 주소에 든 토큰이 인증 수단이므로 인증 방식은 "인증 없음"을 고르세요. ChatGPT, Cursor, Codex는 AI 연결 화면의 각 탭에 등록 위치가 안내되어 있습니다.

3. 연결 확인하기

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

내 가계부 이름이 나오면 연결된 것입니다. 연결 뒤에는 계정 › AI 연결의 토큰 목록에 마지막 사용 시각이 표시됩니다.

4. 기록하고 확정하기

• 한 건씩 말한 거래는 보통 바로 거래내역에 들어갑니다.
• 파일, 사진, 긴 붙여넣기처럼 여러 건을 한 번에 넣으면 AI가 검토 대기 상태로 넣습니다. 검토 대기 거래는 웹에서 확인한 뒤 확정해야 거래내역과 합계에 반영됩니다.

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

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

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

• 위의 합계를 카드 명세서 총액과 맞춰 봅니다.
• 행마다 ✓로 확정하거나 ✕로 버립니다. 한 번에 처리하려면 모두 확정 또는 버리기를 누릅니다.
• 행을 누르면 거래를 고칠 수 있습니다. 고친 뒤에도 검토 대기로 남습니다.

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

이렇게 말해 보세요

AI가 할 수 있는 일

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

• 가계부 목록, 자산·부채와 분류 목록 보기
• 거래 검색, 기간별 수입·지출·분류별 합계와 잔액 보기
• 과거에 비슷한 이름의 거래를 어떤 분류로 넣었는지 참고하기
• 거래 넣기(한 번에 최대 100건, 바로 확정 또는 검토 대기), 고치기, 검토 대기 거래 확정하기, 지우기
• 가계부에 없는 분류나 계정 만들기(소유자·관리자만)
• 통장·카드의 시작 잔액 넣기(소유자·관리자만). “주거래 통장에 9월 30일 기준 240만 원 있었어”처럼 말하면 됩니다.

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

권한은 웹과 같습니다.

• 보기 전용 멤버인 가계부에는 기록하거나 고칠 수 없습니다.
• 다른 멤버의 나만 보기 거래는 AI에게도 보이지 않습니다.
• AI가 한 변경은 변경 기록에 AI 배지와 함께 남습니다.

토큰 하나로 한 시간에 600번까지 요청할 수 있습니다.

토큰 관리

• 계정 › AI 연결의 목록에서 토큰마다 이름과 마지막 사용 시각을 볼 수 있습니다. 한 번도 쓰지 않았으면 사용 안 함으로 나옵니다.
• 휴지통 버튼을 누르면 토큰이 바로 삭제되고, 그 주소로 연결된 AI도 즉시 끊깁니다. 확인 단계가 없으니 주의하세요.
• 기기나 AI마다 토큰을 따로 만드세요. 하나를 잃어버려도 그것만 삭제하면 됩니다.

잘 안 될 때

AI가 iobook 도구를 못 찾습니다

연결 주소 끝까지 토큰이 빠짐없이 들어갔는지 확인합니다. Claude 앱이라면 OAuth 칸이 비어 있는지, Claude Code라면 claude mcp list에 iobook이 있는지 봅니다. 그래도 안 되면 커넥터를 지우고 다시 추가합니다.

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

그 가계부에서 내가 보기 전용이면 기록할 수 없습니다. 분류나 계정 만들기는 소유자·관리자만 할 수 있습니다. 토큰을 삭제했다면 연결이 끊긴 상태이니 새 토큰으로 다시 등록합니다. 한 시간에 600번을 넘겨도 잠시 막힙니다.

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

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

토큰을 잃어버렸습니다

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