Help › Guides

AI 앱에 연결하기

Help articles are available in Korean only for now.

AI 앱이 내 서재를 읽고 목차 · 요약 · 문서를 저장하려면 MCP 로 연결해요. 주소는 하나예요.

https://api.knoverse.im/mcp

사람이 쓸 때는 로그인으로 연결해요. 토큰은 필요 없어요. 브라우저가 없는 봇 · CI 만 토큰을 써요. 콘솔 사이드바 설정 › MCP 연결의 「AI 앱에 연결」 카드에도 같은 순서가 앱별로 있어요.

Claude 앱 (claude.ai · Claude 데스크톱)

  1. claude.ai 또는 Claude 데스크톱 왼쪽 메뉴에서 Customize › Connectors 를 열고 Add › Add custom connector 를 눌러요
  2. 이름에 노버스, 주소에 https://api.knoverse.im/mcp 를 넣고 Continue, 그다음 Add 를 눌러요. 로그인 방식은 저절로 맞춰져요
  3. Connect 를 누르면 노버스 연결 허용 창이 열려요. 노버스에 로그인하고 허용을 누르면 끝이에요

ChatGPT

  1. chatgpt.com 왼쪽 메뉴 Plugins 에서 오른쪽 위 Add › Add custom MCP server 를 눌러요
  2. Name 에 노버스, Connection 의 Server URL 에 https://api.knoverse.im/mcp 를 넣어요. Authentication 은 OAuth 그대로 둬요. 안내를 읽고 「I understand and want to continue」 를 체크한 뒤 Create as a plugin 을 눌러요
  3. 노버스 로그인 창에서 로그인하고 허용을 눌러요

Claude Code

  1. 터미널에서 실행해요

    claude mcp add --transport http knoverse https://api.knoverse.im/mcp
    
  2. Claude Code 안에서 /mcp 를 열고 knoverse 를 골라 인증해요

  3. 브라우저에 뜬 노버스 로그인 창에서 허용하면 끝이에요

Codex

  1. 터미널에서 서버를 추가해요

    codex mcp add knoverse --url https://api.knoverse.im/mcp
    
  2. 로그인 명령을 실행해요

    codex mcp login knoverse
    
  3. 브라우저에 뜬 노버스 로그인 창에서 허용하면 끝이에요

Cursor

  1. Cursor 설정 › MCP 에서 새 서버 추가를 열어요

  2. mcp.json 에 아래를 넣고 저장해요

    {
      "mcpServers": {
        "knoverse": { "url": "https://api.knoverse.im/mcp" }
      }
    }
    
  3. 서버 옆 로그인을 누르고 노버스 로그인 창에서 허용해요

그 밖의 앱

  1. 앱의 MCP 서버 추가 화면에서 종류를 원격(HTTP) 으로 골라요
  2. 주소에 https://api.knoverse.im/mcp 를 넣어요. 로그인을 지원하는 앱이면 여기서 끝나요
  3. 로그인을 지원하지 않는 앱이면 아래 「봇 · CI 가 쓸 때」처럼 토큰을 발급해 Authorization: Bearer <토큰> 헤더로 넣어요

다 됐는지 확인

새 대화에서 이렇게 물어보세요.

노버스에서 내 서재 목록 보여 줘

내 서재가 나오면 연결된 거예요. 콘솔 › 설정 › MCP 연결의 「연결된 AI 앱 · 발급한 토큰」 목록에도 앱 이름이 뜨고, 옆에 로그인 연결 표시가 붙어요.

연결이 안 될 때

봇 · CI 가 쓸 때: 토큰으로 연결

  1. 콘솔 › 설정 › MCP 연결의 「봇·CI 용 토큰」 › 「새 토큰」 칸에 이름을 적고 발급을 눌러요
  2. 토큰(kn_mcp_ 로 시작)은 이때 한 번만 보여요. 닫으면 다시 볼 수 없으니 바로 복사해 비밀 저장소에 넣어요
  3. 연결해요
claude mcp add --transport http --scope user knoverse https://api.knoverse.im/mcp --header "Authorization: Bearer <토큰>"

이렇게 말하면 돼요

연결 끊기

콘솔 › 설정 › MCP 연결의 목록에서 그 줄의 연결 끊기(토큰은 폐기)를 눌러요. 그 즉시 그 연결로는 못 들어와요.

알아 둘 것

Still stuck? Contact us · support@knoverse.im