AI 앱이 내 서재를 읽고 목차 · 요약 · 문서를 저장하려면 MCP 로 연결해요. 주소는 하나예요.
https://api.knoverse.im/mcp
사람이 쓸 때는 로그인으로 연결해요. 토큰은 필요 없어요. 브라우저가 없는 봇 · CI 만 토큰을 써요. 콘솔 사이드바 설정 › MCP 연결의 「AI 앱에 연결」 카드에도 같은 순서가 앱별로 있어요.
Claude 앱 (claude.ai · Claude 데스크톱)
- claude.ai 또는 Claude 데스크톱 왼쪽 메뉴에서 Customize › Connectors 를 열고 Add › Add custom connector 를 눌러요
- 이름에
노버스, 주소에https://api.knoverse.im/mcp를 넣고 Continue, 그다음 Add 를 눌러요. 로그인 방식은 저절로 맞춰져요 - Connect 를 누르면 노버스 연결 허용 창이 열려요. 노버스에 로그인하고 허용을 누르면 끝이에요
- 팀 · 엔터프라이즈 요금제는 관리자가 먼저 추가해야 할 수 있어요
- 컴퓨터에서 한 번 연결하면 휴대폰 Claude 앱에서도 써요
ChatGPT
- chatgpt.com 왼쪽 메뉴 Plugins 에서 오른쪽 위 Add › Add custom MCP server 를 눌러요
- Name 에
노버스, Connection 의 Server URL 에https://api.knoverse.im/mcp를 넣어요. Authentication 은 OAuth 그대로 둬요. 안내를 읽고 「I understand and want to continue」 를 체크한 뒤 Create as a plugin 을 눌러요 - 노버스 로그인 창에서 로그인하고 허용을 눌러요
- 업무용 워크스페이스는 관리자 설정에 따라 막혀 있을 수 있어요
Claude Code
터미널에서 실행해요
claude mcp add --transport http knoverse https://api.knoverse.im/mcpClaude Code 안에서
/mcp를 열고 knoverse 를 골라 인증해요브라우저에 뜬 노버스 로그인 창에서 허용하면 끝이에요
Codex
터미널에서 서버를 추가해요
codex mcp add knoverse --url https://api.knoverse.im/mcp로그인 명령을 실행해요
codex mcp login knoverse브라우저에 뜬 노버스 로그인 창에서 허용하면 끝이에요
Cursor
Cursor 설정 › MCP 에서 새 서버 추가를 열어요
mcp.json에 아래를 넣고 저장해요{ "mcpServers": { "knoverse": { "url": "https://api.knoverse.im/mcp" } } }서버 옆 로그인을 누르고 노버스 로그인 창에서 허용해요
그 밖의 앱
- 앱의 MCP 서버 추가 화면에서 종류를 원격(HTTP) 으로 골라요
- 주소에
https://api.knoverse.im/mcp를 넣어요. 로그인을 지원하는 앱이면 여기서 끝나요 - 로그인을 지원하지 않는 앱이면 아래 「봇 · CI 가 쓸 때」처럼 토큰을 발급해
Authorization: Bearer <토큰>헤더로 넣어요
다 됐는지 확인
새 대화에서 이렇게 물어보세요.
노버스에서 내 서재 목록 보여 줘
내 서재가 나오면 연결된 거예요. 콘솔 › 설정 › MCP 연결의 「연결된 AI 앱 · 발급한 토큰」 목록에도 앱 이름이 뜨고, 옆에 로그인 연결 표시가 붙어요.
연결이 안 될 때
- 로그인 창이 안 떴다면 브라우저 팝업 차단을 풀고 다시 연결해요
- 회사 · 팀 요금제 앱이면 관리자가 커넥터 추가를 먼저 허용해야 할 수 있어요
- 다른 노버스 계정으로 로그인했다면 콘솔 목록에서 그 연결을 연결 끊기 한 뒤 맞는 계정으로 다시 연결해요
- 401 · 403 · 404 같은 메시지가 나오면 이럴 땐 어떻게
봇 · CI 가 쓸 때: 토큰으로 연결
- 콘솔 › 설정 › MCP 연결의 「봇·CI 용 토큰」 › 「새 토큰」 칸에 이름을 적고 발급을 눌러요
- 토큰(
kn_mcp_로 시작)은 이때 한 번만 보여요. 닫으면 다시 볼 수 없으니 바로 복사해 비밀 저장소에 넣어요 - 연결해요
claude mcp add --transport http --scope user knoverse https://api.knoverse.im/mcp --header "Authorization: Bearer <토큰>"
이렇게 말하면 돼요
- 「리팩터링」 목차랑 요약까지 다 해 줘
- 「리팩터링」 요약 안 된 장만 이어서 해 줘
- 「리팩터링」 3장으로 발표자료 만들어 줘
연결 끊기
콘솔 › 설정 › MCP 연결의 목록에서 그 줄의 연결 끊기(토큰은 폐기)를 눌러요. 그 즉시 그 연결로는 못 들어와요.
알아 둘 것
- AI 앱은 연결한 사람의 권한으로 움직여요. 내가 못 보는 스페이스 · 책은 MCP 로도 안 보여요
- 요약 · 문서를 쓰는 건 내 AI 앱이고, 노버스는 저장만 해요