MCP로 Claude Desktop을 내 노트에 연결하기

Knowtarium은 사람과 각자의 AI 에이전트가 함께 일하는 종단간 암호화 지식 베이스예요. 컴퓨터용 Claude 앱인 Claude Desktop은 내 컴퓨터에서 실행되며 그곳에서 노트의 잠금을 푸는 작은 프로그램을 통해 MCP로 연결돼요. 연결되면 어떤 채팅에서든 Claude에게 다음을 요청할 수 있어요.

• 노트를 찾고 읽어요. 내가 허락한 워크스페이스와 폴더 안에서 노트 사이의 링크를 따라가고 관련 노트를 찾아요.
• 노트를 쓰고 편집해요. 각 변경은 즉시 저장되고, Claude의 것으로 서명되며, 기록에 남아요. 그래서 무엇을 했는지 보고 클릭 한 번으로 되돌릴 수 있어요.
• 폴더 지침을 따라요. 앱에서 워크스페이스나 폴더에 쓴 지침(그 AGENTS.md)은 Claude가 그곳에서 읽고 쓸 때마다 전달돼요. Claude는 이 지침에 대해 변경을 제안만 할 수 있고, 직접 바꿀 수는 없어요.
• 원하는 곳에서는 나를 기다려요. 워크스페이스나 폴더에 검토("Ask me first")를 켜면, 그곳에서 Claude의 노트 변경은 내가 승인하거나 거절할 때까지 기다려요. 그곳에서 폴더 변경은 대신 거부되고, Claude가 무엇을 바꾸려 했는지 알려 줘요.
• 노트를 이동하거나 삭제하고 폴더를 바꿔요. 단, 그 권한을 준 경우에만 가능하고, 대화에서 내가 요청할 때만 하도록 안내받아요.

허락하지 않은 워크스페이스나 폴더에 접근하거나, 내 이름으로 서명하거나, 노트를 내가 확인한 것으로 표시하거나, 검토를 켠 곳에서 검토를 건너뛸 수는 없어요. 전체 목록은 에이전트 페이지에 있어요.

가장 쉬운 방법이고, 저희가 권장하는 방법이에요. 터미널이나 Node.js는 필요 없고, Claude Desktop과 무료 Knowtarium 계정만 있으면 돼요.

1. 확장 프로그램을 내려받으세요. 최신 버전인 knowtarium.mcpb를 받으세요. GitHub에 있는 Knowtarium의 오픈 소스 코드로 만들어졌고, 파일을 확인하고 싶다면 각 릴리스에 체크섬이 나와 있어요.
2. 파일을 여세요. 파일을 더블 클릭하면 Claude Desktop이 확장 프로그램 설치를 제안해요. 설치하기 전에 확장 프로그램의 이름, 아이콘, 도구, 지원 링크를 보여 줘요. Claude Desktop이 파일을 열지 않으면 설정의 Extensions에서 설치하세요.
3. Claude에게 Knowtarium을 연결해 달라고 하세요. 채팅을 시작하고 아래 같은 문장을 입력하세요. Claude가 브라우저에서 Knowtarium을 열어요.
4. 이 컴퓨터를 승인하세요. 브라우저에서 에이전트 이름을 정하고, Claude가 접근할 수 있는 범위를 고른 뒤(아래 참고) Allow를 클릭하세요. 그런 다음 채팅으로 돌아가 Claude에게 끝났다고 말하세요. Claude가 승인을 확인하고 워크스페이스를 보여 줘요. 그때부터 모든 채팅에서 노트를 쓸 수 있어요.

> Knowtarium을 연결하고 내 워크스페이스 목록을 보여 주세요

승인 페이지는 터미널 설정과 같은 페이지라서 명령과 터미널을 언급해요. Claude Desktop이 요청한 것이니, 방금 Claude에게 연결을 요청했다면 계속 진행하세요. 브라우저가 이 페이지가 로컬 네트워크의 기기에 접근해도 되는지 물으면 허용하세요.

Claude의 설정에는 비밀번호, 토큰, 키가 들어가지 않아요. 연결은 내 컴퓨터에 암호화되어 저장되고, 그 키는 시스템 키체인이 있으면 그곳에 보관돼요. 이 컴퓨터가 이미 연결되어 있다면(전에 npx knowtarium connect를 실행했다면) 확장 프로그램은 그 연결을 쓰고, 승인할 것도 없어요. Claude Desktop을 체크한 채로 명령을 실행했다면 이미 Claude Desktop에 Knowtarium이 있으므로 확장 프로그램은 필요 없어요.

(새 탭에서 원래 크기로 열림) (새 탭에서 원래 크기로 열림)

터미널이 익숙하다면 명령 하나로 이 컴퓨터를 연결하고, Claude Desktop과 함께 찾아낸 다른 에이전트(Claude Code나 Cursor 등)에도 Knowtarium을 추가할 수 있어요. Node.js 20 이상(22 또는 24 권장)이 필요해요. 홈 폴더에서 실행하세요. npx는 실행되는 폴더를 신뢰하므로, 프로젝트 안에서 실행하면 그 프로젝트의 파일이 Knowtarium의 파일을 대신할 수 있어요.

$ cd ~                          # 프로젝트가 아닌 홈 폴더$ npx knowtarium connect
Opening the browser to connect this computer to Knowtarium.
Connected to workspace ws_8f2k (read and write).
Add Knowtarium to which agents? Claude Desktop
added to Claude Desktop (/Users/you/Library/Application Support/Claude/claude_desktop_config.json)

1. 확장 프로그램과 마찬가지로, 열리는 브라우저 페이지에서 이 컴퓨터를 승인하세요.
2. 에이전트를 고르세요. 명령이 찾아낸 에이전트를 모두 체크된 상태로 보여 줘요. Enter를 누르면 전부에 Knowtarium을 추가하고, 먼저 일부를 해제할 수도 있어요(화살표로 이동, 스페이스로 선택·해제).
3. Claude Desktop에 항목이 추가돼요. 명령은 Claude Desktop의 설정 파일인 claude_desktop_config.json에 Knowtarium을 추가하고, 다른 설정은 그대로 둬요. 이전 파일은 그 옆에 백업해요.
4. Claude Desktop을 완전히 종료하고 다시 여세요. 창을 닫는 것만으로는 부족해요. Mac에서는 Claude, Quit Claude를 고르거나 Cmd+Q를 누르고, Windows에서는 시스템 트레이(시계 옆)의 Claude 아이콘을 오른쪽 클릭해 Quit을 고르세요.

명령이 바꾸는 설정 파일은 Claude Desktop 자체 폴더에 있어요.

명령이 무엇이든 쓰기 전에 무엇을 바꿀지 보려면 npx knowtarium agents --dry-run을 실행하세요. 명령은 오픈 소스이고, 코드는 GitHub에 있어요.

브라우저에서 열리는 페이지에서 이 연결이 할 수 있는 일이 정해져요. 모든 것은 이 에이전트 하나에만 적용되고, 저희 서버가 이를 강제해요.

• 워크스페이스 하나. 각 연결은 정확히 하나의 워크스페이스에 접근해요.
• 원하면 일부 폴더만. Claude에게 필요한 폴더만 체크하세요. 그 위에 있는 폴더의 지침도 읽지만, 그 지침에 대한 변경은 제안할 수 없어요.
• 읽기 또는 읽기·쓰기. 노트에서 답만 얻고 싶다면 읽기 전용으로 시작하세요.
• 편집 이상의 일은 체크할 때만. 노트 이동, 노트 삭제, 폴더 만들기, 이름 바꾸기, 이동, 삭제는 여섯 가지 별도 권한이고, 모두 기본값은 꺼짐이에요.

나중에 앱의 Settings, Agents에서 모두 바꿀 수 있으며, 바꿀 때마다 새 권한 세트에 서명해요. 그곳에서 Claude의 접근을 취소하면 즉시 차단되고 워크스페이스는 새 키를 받으므로, 그 이후에 쓰인 것은 읽을 수 없어요.

Claude에게 두 번째 워크스페이스를 주려면 홈 폴더에서 npx knowtarium connect --no-agents를 실행하고(이 경우에는 Node.js가 필요해요), 다른 워크스페이스를 고른 뒤 Claude Desktop을 종료했다가 다시 여세요. 첫 번째 연결은 그대로 남아요.

Claude는 이미 채팅 내용을 기억할 수 있고, Claude의 프로젝트에는 내가 추가한 파일이 담겨요. 그 메모리는 내 Claude 계정에 있고, Claude만 사용해요. Claude와 어떻게 일하고 싶은지 담기에는 좋아요. 하지만 결정, 리서치, 회의 메모, 그리고 나와 팀, 다른 AI 도구가 의지하는 사실 같은 지식 자체를 담기에는 적합하지 않아요.

그게 지식 베이스가 있는 이유예요. 노트는 내보낼 수 있는 일반 마크다운으로 계속 내 것이고, 연결한 모든 에이전트가 같은 노트를 봐요. Claude는 그곳에서 찾아보고 알게 된 것을 기록하며, 나는 각 변경을 보고 되돌릴 수 있어요. 저희의 AI 세컨드 브레인 가이드에서 이 아이디어를 더 자세히 다뤄요.

특별한 명령은 필요 없어요. 평소 말로 요청하면 Claude가 알맞은 도구를 골라요. Claude가 어디를 찾아야 할지 알도록 “Knowtarium”이나 “내 노트”라고 말해 주면 도움이 돼요. 다음은 읽기 전용부터 작고 구체적인 편집까지, 처음 해 보기 좋은 프롬프트예요.

> 내 Knowtarium 워크스페이스에서 뭘 할 수 있나요?
 
> 내 Knowtarium 노트에서 온보딩 절차를 찾아서,
  참고한 노트의 링크와 함께 답해 주세요.
 
> 이번 주 회의 메모를 읽고 짧은 요약을 새 노트로
  써 주세요. 회의 노트는 바꾸지 마세요.
 
> 오늘 통화 메모를 Acme 프로젝트 노트에 추가해 주세요.
  그 밖에는 아무것도 바꾸지 마세요.
 
> 내 인박스에 뭐가 있나요?
  클립마다 할 일을 하나씩 제안해 주세요.

첫 번째 프롬프트는 연결이 작동하는지 빠르게 확인하는 방법이에요. Claude가 워크스페이스 이름을 말하고, 변경이 즉시 저장되는지 승인을 기다리는지 알려 줘야 해요. 마지막 프롬프트는 웹 클리퍼로 저장한 페이지를 읽어요. 처음 편집은 작게 하고, 바뀌면 안 되는 것을 말해 주세요. 바뀐 노트 마흔 개보다 네 개를 확인하는 게 훨씬 쉬워요.

Claude의 모든 변경은 자신의 키로 서명되므로, 어떤 편집이 Claude의 것인지 항상 알 수 있어요.

• 사이드바의 점이 Claude가 편집한 노트를 열어 볼 때까지 표시하고, 워크스페이스 페이지는 그 노트들을 Edited by agents 아래에 나열해요.
• 노트 제목 아래 줄에 어떤 에이전트가 편집했는지 표시되고, 비교하는 See changes와 이전 버전을 되살리는 Undo가 있어요.
• 삭제, 이동, 폴더 변경은 워크스페이스 페이지의 Deleted and reorganized by agents 아래에 2주 동안(기록 보관 기간이 더 짧으면 그 기간 동안) Undo, Undo this agent's last 24 hours와 함께 나열돼요. 삭제된 노트는 기록 보관 기간 안이라면 되살릴 수 있어요.
• 기록은 하루에서 1년까지 내가 정한 기간 동안 모든 버전을 보관해요. 검토가 켜진 폴더에서는 변경이 대신 검토 대기열에서 기다려요.

(새 탭에서 원래 크기로 열림) (새 탭에서 원래 크기로 열림)

에이전트 편집 검토 가이드에는 에이전트가 바꾼 것을 믿기 전에 확인하는 루틴이 있어요.

Knowtarium은 컴퓨터의 Claude Desktop에 연결되고, 아직 브라우저의 claude.ai나 Claude 휴대폰 앱에는 연결되지 않아요. 이들은 클라우드에서만 실행되므로 저희가 호스팅하는 커넥터가 필요한데, 이는 나중에 나와요.

이유는 암호화예요. 지금은 확장 프로그램이나 명령이 내 컴퓨터에서만 노트의 잠금을 풀어요. 호스팅 커넥터는 누구나 확인할 수 있는 코드를 실행하는, 철저히 잠긴 서버에서만 노트의 잠금을 풀도록 계획되어 있어요. 그때까지는 Claude Desktop이나 Claude Code 같은 컴퓨터의 다른 에이전트를 쓰세요.

Claude에서 Knowtarium이 보이지 않아요

Claude Desktop 설정의 Extensions에서 확장 프로그램이 설치되어 있고 켜져 있는지 확인하세요. 명령을 썼다면 Claude Desktop을 완전히 종료하고 다시 여세요. 시작할 때만 새 설정을 불러와요.

Claude가 Knowtarium이 연결되지 않았다고 해요

Claude에게 Knowtarium을 연결해 달라고 하고, 열리는 브라우저 페이지에서 이 컴퓨터를 승인하세요. 그 페이지를 닫았다면 다시 요청하세요.

연결 확인하기

앱의 Settings, Agents에 연결된 모든 에이전트와 각 에이전트가 접근할 수 있는 범위가 나와요. 터미널에서는 npx knowtarium status가 연결된 워크스페이스와 그 접근 권한, 키가 어디에 보관되는지 보여 줘요.

Knowtarium이 업데이트하라고 해요

확장 프로그램을 쓴다면 knowtarium.mcpb를 다시 내려받아(링크는 항상 최신 버전을 줘요) 여세요. Claude Desktop이 설치된 확장 프로그램의 업데이트를 제안해요. 명령을 쓴다면 홈 폴더에서 npx knowtarium@latest agents를 실행하세요. 어느 쪽이든 그다음 Claude Desktop을 종료했다가 다시 여세요.

$ cd ~$ npx knowtarium@latest agents$ npx knowtarium status

저장될 줄 알았던 변경이 승인을 기다려요

Claude는 각 변경이 저장되었는지 제안되었는지, 그리고 그 이유를 알려 줘요. 폴더가 검토를 요구하거나, 워크스페이스 설정을 확인할 수 없었거나, Claude가 오늘의 직접 변경 한도에 도달했을 수 있어요. 또는 이 연결이 변경을 제안만 할 수 있는 경우예요. 이때는 홈 폴더에서 npx knowtarium connect를 다시 실행하고(확장 프로그램을 쓴다면 --no-agents와 함께), Claude Desktop을 종료했다가 다시 여세요.