AI 어시스턴트 연결하기

MCP 서버를 AI 클라이언트에 추가하고, 다섯 개 권한 그룹 중에서 무엇에 닿을 수 있는지 고르고, 다 쓴 뒤에는 취소하세요.

Read Frog 웹 앱의 MCP 페이지를 엽니다. 서버 주소, 클라이언트별 설정 단계, 그리고 이미 승인한 모든 클라이언트가 여기에 있습니다.

서버 주소는 누구에게나 같습니다.

https://api.readfrog.app/api/mcp

클라이언트마다 다른 것은 그 주소를 어디에 붙여넣는지, 그리고 클라이언트 자체가 무엇을 먼저 요구하는지뿐입니다.

서버 추가하기

위 주소로 원격 MCP 서버를 추가합니다. 전송 방식은 Streamable HTTP입니다. ChatGPT에서는 개발자 모드를 켠 뒤 설정 → 플러그인에 있고, Claude에서는 설정 → 커넥터 → 커스텀 커넥터 추가에 있습니다. Codex와 Claude Code는 각각 명령 한 줄이면 되며, MCP 페이지에 적혀 있습니다.

인가 방식은 OAuth 2.1을 선택합니다. 동적 클라이언트 등록과 클라이언트 ID 메타데이터 문서를 모두 지원하므로 입력할 client ID나 시크릿이 없습니다. 디스커버리 문서를 꼭 지정해야 하는 클라이언트는 https://api.readfrog.app/.well-known/oauth-protected-resource/api/mcp에서 읽을 수 있습니다.

클라이언트가 Read Frog의 권한 승인 페이지로 보냅니다. 로그인해서 거기 표시된 앱 이름과 식별자를 확인하고, 앱이 요청한 각 권한 그룹의 수준을 고른 뒤 허용을 선택합니다.

일부 클라이언트는 커스텀 커넥터를 자기 요금제 뒤에 둡니다. ChatGPT는 유료 요금제가 필요하고, 개인 Claude 계정은 Pro 또는 Max가 필요하며, Team이나 Enterprise에서는 소유자가 조직 설정에서 커넥터를 추가합니다. Codex와 Claude Code에는 이런 제약이 없습니다.

Read Frog 쪽의 요구 사항은 Ultra 요금제입니다. 요금제가 없는 계정에서 연결하면 인가는 끝까지 되지만 이후 모든 도구 호출이 설명과 함께 거부됩니다. 다시 로그인해도 달라지지 않습니다. 어떤 권한 허용도 구독을 바꾸지는 못하기 때문입니다.

다섯 개 권한 그룹

그룹은 정확히 다섯 개입니다. account는 읽기만 있고, 나머지 네 개는 각각 접근 불가, 읽기, 읽기 및 쓰기로 설정할 수 있습니다. 그룹별로 고르며, 클라이언트가 실제로 요청한 그룹 안에서만 고를 수 있습니다.

그룹	읽기로 어시스턴트가 볼 수 있는 것	쓰기로 추가되는 것
`account`	이름, 이메일 주소, 프로필 사진. 노트 내용은 절대 포함되지 않습니다.	없음 — 이 그룹에는 쓰기 수준이 없습니다.
`notebases`	내 Notebase와 그 필드 정의, 필드 ID까지.	Notebase 생성·이름 변경·삭제, 필드 추가·수정·삭제.
`notes`	모든 노트의 필드 값, 그리고 그 안에서의 검색.	노트 생성, 수정, 삭제.
`card_templates`	카드를 생성하는 앞면과 뒷면 형식.	템플릿 생성, 수정, 삭제.
`study`	복습 기록, 일정 상태, 대기열 수, 일일 한도.	복습 기록과 취소, 일일 한도 변경, 카드 영구 중지와 오늘 건너뛰기.

두 개의 도구는 그룹에 걸쳐 있습니다. 렌더링된 카드 하나 — 앞면, 뒷면, 학습 상태 — 를 읽으려면 notes:read와 study:read가 함께 필요합니다. 카드는 노트 내용에 일정 상태를 더한 것이기 때문입니다. 둘 중 하나만 허용하면 list_cards와 get_card를 쓸 수 없습니다.

쓰기 권한이 망가뜨릴 수 있는 것

쓰기는 "추가할 수 있다"만이 아닙니다. 모든 그룹의 쓰기 수준에는 삭제가 포함되고, Notebase 안에서의 삭제는 연쇄적으로 번집니다.

허용 항목	최악의 경우
`notes:write`	노트 하나가 영구히 삭제되고, 그 노트로 생성된 모든 카드와 그 카드들의 복습 기록까지 함께 사라집니다.
`notebases:write`	Notebase 하나가 통째로 영구히 삭제됩니다 — 필드, 모든 노트, 템플릿, 카드, 그리고 전체 복습 기록까지.
`card_templates:write`	템플릿이 삭제되고, 그 템플릿이 생성한 모든 카드와 복습 기록도 함께 사라집니다. 원본 노트는 남습니다.
`study:write`	하지 않은 복습이 기록됩니다. FSRS는 이를 실제로 받아들여 그 카드의 기억 안정성, 난이도, 다음 예정일이 모두 달라집니다.

이 중 어느 것도 Read Frog에서 되돌릴 수 없습니다. undo_review는 카드 하나의 가장 최근 복습을 되돌리지만, 삭제된 노트, 필드, 템플릿, Notebase에는 되돌리기가 없습니다.

먼저 읽기만 허용하세요. 읽기 전용 권한만으로도 찾아보기, 무엇을 복습할지 계획하기, 진행 상황을 정리해 보고받기가 이미 가능하고, 무엇도 잃을 수 없습니다. 특정 활용 예시에 꼭 필요할 때만 그 그룹을 쓰기로 올리고, 삭제를 승인하기 전에는 어시스턴트가 무엇을 하려는지 먼저 읽어 보세요.

나중에 권한 추가하기

한 번의 허용에는 그 인가 요청이 요청한 것만, 그때 고른 수준으로 담깁니다. 어떤 도구가 권한이 없어 실패하면 클라이언트는 어떤 권한이 필요한지 전달받습니다. 많은 클라이언트는 알아서 다시 승인 페이지로 보내고, 일부는 손으로 다시 연결해야 비로소 다시 요청합니다.

반대 방향도 됩니다. 다시 인가하면서 어떤 그룹을 낮추면 됩니다. 승인 페이지는 새 요청이 언급한 그룹만 낮출 수 있으므로, 클라이언트가 더 이상 요청하지 않는 권한은 그대로 남습니다. 한 번에 전부 지우려면 연결을 취소하세요.

관리와 취소

MCP 페이지는 연결된 모든 클라이언트를 등록된 이름, 앱 식별자, 연결한 시점, 마지막으로 인가한 시점, 그리고 현재 가진 권한과 함께 보여 줍니다.

취소는 그 클라이언트의 권한을 삭제하고 접근을 즉시 무효화합니다. 리프레시 토큰도 허용과 함께 사라지므로, 다음에 다시 연결을 시도하면 승인 페이지로 돌아오고 거기서 다시 정하게 됩니다. 같은 클라이언트를 나중에 다시 연결할 수 있으며, 새 허용은 아무것도 없는 상태에서 시작합니다.

취소는 과거까지 거슬러 가지 않습니다. 어떤 서비스가 이미 받은 내용은 그 서비스에 남습니다 — Read Frog가 데이터를 어떻게 다루는지는 개인정보 처리방침을 참고하세요. 어시스턴트 안에서 커넥터를 제거하는 것도 해 둘 만하지만, 그것만으로 Read Frog 쪽의 허용이 취소되지는 않습니다.

잘 안 될 때

어떤 도구가 권한이 더 필요하다고 합니다. 해당 그룹을 허용하거나, 계속 거부해 둔 채 허용한 작업 범위 안에서만 쓰세요. 클라이언트가 알아서 다시 요청하지 않으면 다시 연결하세요.
연결은 되는데 모든 도구가 요금제 안내와 함께 거부됩니다. 계정이 Ultra 요금제가 아닙니다.
새 도구가 보이지 않습니다. 커넥터를 새로 고치거나 다시 연결하세요. 클라이언트가 도구 목록을 캐시합니다.
쓰기가 노트가 바뀌었다며 실패합니다. 수정은 오래된 데이터로부터 보호됩니다. 어시스턴트에게 그 노트를 다시 읽고 재시도하도록 하세요.
복습 기록이 시간대를 요구하며 실패합니다. 복습을 기록하려면 그것이 어느 학습 일에 속하는지 정해야 하므로 추측하지 않습니다. 어시스턴트에게 내 IANA 시간대를 알려 주거나, 로그인한 상태로 Read Frog 웹 앱을 한 번 열어 계정에 저장되게 하세요.

막혔다면 문의해 주세요.