# 어시스턴트 커넥터

ChatGPT, Claude, Meta Muse를 Reading Journey 서재에 연결하고 책 추가, 완독 표시, 별점 매기기, 다음에 읽을 책 정리를 부탁해 보세요. 설정은 2분 정도면 끝나고, 커넥터는 무료예요.

서버 주소: `https://mcp.readingjourney.app`

## 시작하기 전에

- Reading Journey 계정이 필요해요. Apple, Google, 이메일과 비밀번호로 로그인할 수 있고, 설정 중에 계정을 만들 수도 있어요.
- 앱과 같은 로그인 방법을 써야 어시스턴트가 기존 서재에 연결돼요.
- **Claude**(웹, 데스크톱, 모바일 앱), ChatGPT 또는 **Meta Muse**가 필요해요.
- RJ+는 필요 없고, 연결할 때 앱이 설치되어 있지 않아도 돼요.

## Claude 연결하기

Reading Journey는 Claude 커넥터 디렉터리에 등록되어 있어서 따로 붙여 넣을 것이 없어요.

1. [Claude 디렉터리의 Reading Journey](https://claude.ai/directory/reading-journey)를 열고 **Connect to Claude**를 클릭하세요.
2. Reading Journey 페이지에서 **Apple로 계속하기** 또는 **Google로 계속하기**를 고르거나, 이메일과 비밀번호로 로그인하세요.
3. Claude가 할 수 있는 일을 확인하고 **허용**을 클릭하세요. 그러면 Claude로 돌아가요.
4. 채팅에서 **+** 메뉴를 열고 **Connectors**를 골라 Reading Journey가 켜져 있는지 확인하세요. 이제 요청하면 돼요.

Team 및 Enterprise 플랜에서는 먼저 소유자가 **Organization settings > Connectors**에서 커넥터를 켜야 해요. 그다음 각 멤버가 자신의 Reading Journey 계정으로 연결하면 돼요. 웹에서 연결하고 나면 Claude 모바일 앱에서도 쓸 수 있어요.

## Meta Muse 연결하기

1. Muse에서 **Settings > Connectors**를 여세요.
2. **Add custom connector**를 고르고 `https://mcp.readingjourney.app`을 붙여 넣으세요.
3. Reading Journey 페이지에서 앱과 같은 방법으로 로그인하고, 권한을 확인한 다음 **허용**을 고르세요.

Muse의 메뉴는 버전에 따라 바뀔 수 있어요. Connectors가 보이지 않으면 맞춤 커넥터에 관한 Meta 도움말을 확인하세요.

## 이렇게 써 보세요

새 채팅을 열고 이렇게 물어보세요.

- "Susanna Clarke의 《피라네시》를 Reading Journey에 '읽고 싶은'으로 추가하고 '다음에 읽을 책'에 넣어 줘."
- "'다음에 읽을 책'에 뭐가 있어? 세 번째 책을 《어둠의 왼손》으로 바꿔 줘."
- "어제 《내일 또 내일 또 내일》을 다 읽었어. 완독으로 표시하고 별점 4.5개 줘."
- "'북클럽 2026'이라는 컬렉션을 만들고, '읽고 싶은' 책 중에 일본 작가 책을 전부 넣어 줘."
- "지금 읽고 있는 책이랑 중단한 책이 뭐야?"
- "《Infinite Jest》는 하차할래. 미완독으로 표시해 줘."
- "내 서재에 없는 코지 판타지 소설 세 권 추천해 주고, 내가 고른 걸 추가해 줘."

그런 다음 Reading Journey를 열면 바뀐 내용이 반영되어 있어요. 앱이 이미 열려 있었다면 다른 앱으로 갔다가 돌아오면 동기화돼요.

## 어시스턴트가 할 수 있는 일과 없는 일

| 할 수 있는 일 | 할 수 없는 일 |
| --- | --- |
| 책, 독서 상태, 별점, 컬렉션, 다음에 읽을 책, 메모, 리뷰, 독서 일지 보기 및 변경 | 사진이나 정확한 위치 보기 |
| 책 추가, 상태 변경, 별점 매기기, 진도 기록, 목표 설정 | 먼저 묻지 않고 컬렉션, 목표, 회독 기록, 독서 이력이 있는 책 삭제 |
| 다음에 읽을 책과 Top 4 관리, 컬렉션 만들고 채우기, 요청하면 사진 추가 | 계정, 구독, 설정 변경 |

연결할 때 보이는 권한 페이지에도 같은 내용이 나와요. 어시스턴트는 메모, 리뷰, 독서 일지를 읽고 바꿀 수 있고, 요청하면 사진을 추가, 교체, 삭제할 수 있지만 사진을 볼 수는 없어요. 2026년 11월 1일 이전에 연결했다면 이 권한을 주기 위해 다시 연결하세요.

## 도구 참고

도구를 직접 호출할 일은 없어요. 평소 말투로 요청하면 어시스턴트가 알맞은 도구를 골라요. 모든 도구는 내 서재에서만 작동해요.

| 도구 | 종류 | 설명 |
| --- | --- | --- |
| `list_books` | 읽기 | 상태, 별점, 다음에 읽을 책, 컬렉션과 함께 책 목록을 보여 줌. 상태, 컬렉션, 단어로 필터링 가능 |
| `get_book` | 읽기 | 책 한 권의 회독별 날짜, 내 별점, 컬렉션, 다음에 읽을 책 순서 |
| `list_collections` | 읽기 | 컬렉션과 각 컬렉션에 담긴 책 수 |
| `get_next_up` | 읽기 | 다음에 읽을 책 목록을 순서대로 |
| `add_book` | 쓰기 | 책 추가(기본값은 '읽고 싶은'). 이미 있는 책은 중복으로 추가하지 않음 |
| `set_status` | 쓰기 | 책을 읽는 중, 중단, 완독, 미완독으로 바꾸거나 '읽고 싶은'으로 표시 |
| `rate_book` | 쓰기 | 지금 읽는 회독에 별점 0.25~5개를 매기거나 별점 지우기 |
| `set_next_up` | 쓰기 | 아직 시작하지 않은 책을 다음에 읽을 책에 추가 |
| `remove_from_next_up` | 쓰기 | 다음에 읽을 책에서 책 빼기 |
| `create_collection` | 쓰기 | 컬렉션 만들기 |
| `add_to_collection` | 쓰기 | 컬렉션에 책 넣기 |
| `remove_from_collection` | 쓰기, 먼저 확인 | 컬렉션에서 책 빼기. 책 자체는 그대로 남음 |
| `remove_book` | 쓰기, 먼저 확인 | 추가만 해 둔 책 삭제. 독서 이력, 별점, 독서 일지 기록, 진도, Top 4 자리, 메모, 표지 사진이 있는 책은 삭제하지 않음 |

개발자를 위한 정보: OAuth 스코프는 `mcp`(읽기 및 변경, 허용 시 부여되는 권한), `library:read`, `library:write`예요. 연결은 사용하는 동안 로그인 상태로 유지되고, 60일 동안 쓰지 않으면 다시 연결해야 해요.

## 제한과 안전

- 책을 삭제하거나 컬렉션에서 빼기 전에 어시스턴트가 먼저 나에게 물어보도록 되어 있어요.
- 휴대폰에서 바꾼 내용과 어시스턴트가 바꾼 내용이 겹치면 휴대폰에서 바꾼 내용이 우선이에요.
- 어시스턴트는 책 제목, 저자 이름, 컬렉션 이름에 적힌 지시는 절대 따르지 않도록 되어 있어요.
- 연결 하나당 서재를 1분에 60번 읽고 30번 변경할 수 있어요.
- 커넥터는 기기 수에 포함되지 않아서 무료 플랜의 동기화에 영향을 주지 않아요.

## 연결 해제

어시스턴트에서 커넥터를 삭제하세요. Claude에서는 **Customize > Connectors**에서 Reading Journey를 선택하고 **Remove**를 고르고, Muse에서는 **Settings > Connectors**에서 삭제하세요. Reading Journey 계정을 삭제하면 모든 어시스턴트의 연결이 해제돼요. 앱에서 로그아웃하는 것만으로는 해제되지 않아요.

## 문제 해결

| 이런 메시지가 보이면 | 이렇게 하세요 |
| --- | --- |
| "이 이메일과 비밀번호에 맞는 계정이 없습니다." | 오타가 없는지 확인하거나, 앱에서 **비밀번호를 잊으셨나요?** 메뉴로 비밀번호를 재설정하세요. 앱에서 Apple이나 Google로 로그인한다면 대신 **Apple로 계속하기** 또는 **Google로 계속하기**를 고르세요. |
| 어시스턴트에 서재가 비어 있다고 나와요 | 앱과 다른 방법으로 로그인한 경우예요. 연결을 해제하고 다시 연결할 때 같은 방법을 쓰세요. |
| "먼저 이메일 주소를 인증한 다음 로그인하세요." | 저희가 보낸 확인 메일을 연 다음 다시 로그인하세요. |
| "이 페이지가 만료되었습니다." | 어시스턴트로 돌아가 Reading Journey를 다시 연결하세요. |
| 제공업체가 앱 등록을 거부했어요 | 아직 지원하지 않는 어시스턴트예요. Claude, ChatGPT, Meta Muse를 지원해요. |
| 앱에 변경 사항이 보이지 않아요 | 앱이 같은 계정으로 로그인되어 있는지 확인하고, 다른 앱으로 갔다가 돌아오세요. 무료 계정에서는 동기화하는 기기에만 변경 사항이 반영돼요. |
| "…은(는) Reading Journey 앱에서만 삭제할 수 있습니다." | 독서 이력이 있는 책이에요. 앱의 책 페이지에서 삭제하세요. |
