옵시디언에 AI 비서 연결하는 법 — Claude에 MCP 등록부터 첫 저장까지

먼저 구조부터 그려 둘게요. 세브렌을 켜면 AI가 쓸 새 보관함이 내 GitHub에 하나 생깁니다. 이름은 secondbrain-vault예요. 노트는 전부 이 보관함에 쌓이고, 옵시디언은 그 보관함을 내 컴퓨터에서 여는 창입니다.

그래서 지금 쓰고 있는 옵시디언 보관함에 AI를 그대로 붙이는 기능은 아니에요. 기존 보관함은 그대로 두고 새 보관함이 하나 더 생기는 구조이고, 옵시디언은 보관함을 여러 개 열 수 있으니 둘을 나란히 쓸 수 있습니다. 기존 노트를 새 보관함으로 옮겨 주는 기능은 없습니다.

이 구조가 맞는 분은 “앞으로 대화에서 나오는 기록을 파일로 남기고, 옵시디언에서도 열고 싶다”는 분이에요. “이미 쌓아 둔 노트를 AI가 읽고 정리해 줬으면 한다”는 분께는 다른 이야기라, 여기서 미리 말씀드립니다.

• GitHub 개인 계정. 조직(Organization) 계정에는 아직 설치할 수 없어요. 계정이 없다면 GitHub에서 무료로 만들 수 있습니다.
• Claude 계정. claude.ai 무료 플랜으로도 시작할 수 있어요(무료는 MCP 1개까지 연결돼요).
• 옵시디언은 선택. 세브렌은 claude.ai만으로 완전히 동작해요. 옵시디언은 마지막에 내 컴퓨터에서 노트를 열고 싶을 때만 설치합니다.

알아 둘 전제도 두 가지예요. 저장은 “기억해 둬”처럼 지시가 있을 때 일어나고, 대화가 저절로 전부 저장되지는 않아요. 그리고 저장·수정·삭제에는 월 횟수 한도가 있습니다(검색과 읽기는 무제한이에요).

가입 화면에서 GitHub 계정으로 로그인해요. 따로 비밀번호를 만들지 않습니다. 노트가 우리 서버가 아니라 내 GitHub 저장소에 저장되기 때문에, 어차피 필요한 GitHub 계정 하나로 로그인까지 끝내는 거예요.

설치 화면에서는 All repositories를 골라 주세요. 새 계정은 고를 저장소가 없어 이게 유일한 선택지이고, 다음 단계의 자동 생성에 필요해요. 대신 서버가 받는 접근 열쇠는 짧게 만료되는 단기 토큰이고,secondbrain-vault 저장소 전용으로 제한돼요. 비밀번호나 개인 액세스 토큰은 수집하지 않습니다. 허락하면 가입 화면으로 자동으로 돌아옵니다.

돌아오면 저장소가 자동으로 만들어져요. 버튼 한 번이면 됩니다. 이때 생기는 것은 네 가지예요.

• 나만 볼 수 있는 저장소 secondbrain-vault
• 노트 템플릿과 폴더 구조
• 검색용 목록을 갱신하는 자동 인덱서(GitHub Actions)
• 세브렌 계정 등록(무료)

여기서 다시 한번 확인해 두세요. 저장소는 새로 생깁니다. 세컨드브레인 전체는 저장소·통로(MCP)·스킬 세 가지가 함께 도는 구조이고, 지금 만든 저장소는 그중 기록이 실제로 쌓이는 곳이에요. 나머지 설정은 세브렌이 대신 처리합니다.

설치 화면에서 ‘Only select repositories’를 골랐다면 저장이 동작하지 않아요. GitHub 설치 설정에서 All repositories로 바꾸면 됩니다. 보안이 신경 쓰인다면 설치가 끝난 뒤 접근 범위를 이 저장소 하나로 좁혀도 서비스는 그대로 동작해요.

버튼 하나로 등록되는 경우

가입 화면의 MCP 추가하기 버튼을 누르면 새 탭에서 claude.ai 추가 창이 열려요. 이름과 주소가 미리 채워져 있으니 아무것도 바꾸지 말고 오른쪽 아래 [추가]만 누르세요. 이어서 뜨는 GitHub 로그인 화면에서 승인하면 연결이 끝납니다. 이 로그인으로 본인을 확인해서 내 저장소에만 연결돼요.

추가 창에 빨간 안내가 뜨는 건 정상이에요. “외부 링크에서 제안된 커넥터”라는 표시일 뿐이라 그대로 추가하면 됩니다. 인증·OAuth 클라이언트 같은 설정 항목이 함께 보여도 손댈 것 없어요. 두 항목에 붙은 감지됨표시가 “claude.ai가 이미 맞는 값을 골라 뒀다”는 뜻이에요.

“이미 있다”는 안내가 뜰 때

MCP 목록에 이미 Sebren-Secondbrain-MCP가 있으면 추가하지 말고 그 MCP의 [연결]을 누르세요. 그래도 추가를 누르면 영문 안내가 뜨고 창이 닫히지 않아요. 이름을 바꿔도 같습니다. 판단 기준이 주소이기 때문이에요. 다시 만들고 싶다면 기존 것을 먼저 제거한 뒤 추가하면 됩니다.

창이 바로 닫혔을 때, 주소를 직접 붙여넣는 경우

추가 창이 떴다가 곧바로 닫히는 경우가 있어요. 입력이 잘못돼서가 아니라 claude.ai가 주소를 정리하면서 ‘창을 열어라’는 표시를 지우기 때문이에요. 그 화면 오른쪽 위 [추가 ▾] → [커스텀 커넥터 추가]를 누르면 이름과 주소가 이미 채워져 있습니다. 그래도 비어 있으면 가입 화면에 있는 이름·주소 복사 버튼으로 값을 가져와 붙여넣으세요. claude.ai → 설정 → 커넥터 → 커넥터 추가 순서로 들어가면 같은 창이 나옵니다.

모바일에서는 브라우저로

휴대폰에서 버튼을 눌렀는데 Claude 앱이 열리고 새 대화창만 뜬다면 추가가 안 된 거예요. 앱에서는 MCP를 새로 만들 수 없고 브라우저(사파리·크롬)에서만 됩니다. 이름과 주소를 복사한 뒤 브라우저에서 claude.ai → 설정 → 커넥터 → 맞춤 설정 → 추가 → 커스텀 커넥터 추가에 붙여넣으세요.

역할을 한 번만 정리할게요. MCP는 통로이고, 분류 규칙은 통로 쪽 서버가 갖고 있어요. 연결만 해두면 규칙은 그대로 적용됩니다. 스킬은 시동 장치예요. “기억해줘” 같은 말이 Claude 자체 메모리로 새지 않고 내 보관함에 저장되게 붙잡아 줍니다. 규칙이 서버에 있어서 스킬을 다시 받거나 업데이트할 일은 없어요.

1. 가입 화면에서 스킬 파일 받기를 눌러요. 타인이 대신 받아가는 걸 막기 위해 GitHub 본인 확인을 한 번 더 거칩니다.
2. claude.ai 설정 → 기능(Capabilities)에서 ‘코드 실행 및 파일 생성’을 켜요.
3. 사용자 지정(Customize) → 스킬(Skills) → +를 누르고, 받은 스킬 파일(.skill)을 첨부해요. 업로드되면 토글로 켜고 끌 수 있습니다.

스킬을 올릴 수 없는 환경이라면 설치 없이 넘어가도 괜찮아요. 나중에 설치해도 되지만, 그전에 다른 곳에 쌓인 기록은 손으로 옮겨야 합니다.

claude.ai 설정 화면에서 일반을 열면 Claude 지침이라는 칸이 있어요. 거기에 가입 화면이 주는 지침을 붙여넣어 두면, 매번 설명하지 않아도 이 규칙이 먼저 켜집니다. 지침 전문과 복사 버튼은 어떻게 정리되나요?페이지의 ‘미리 켜두기’ 절에도 있어요. 지금 건너뛰어도 괜찮고, 나중에 붙여넣어도 똑같이 적용돼요.

튜토리얼은 완주 확인이 있어야 튜토리얼이에요. claude.ai에서 새 대화를 열고 이렇게 말해 보세요.

• “오늘 회의 내용 노트로 저장해줘”
• “지난주에 저장한 아이디어 찾아줘”

처음 도구를 쓰려고 하면 “써도 되냐”고 묻는 창이 떠요. 오류가 아니라 claude.ai가 사용자를 지키려고 두는 절차예요. 다만 그 창의 ‘항상 허용’은 그 대화 안에서만 통해서, 새 대화를 열면 다시 물어봐요. claude.ai 왼쪽 메뉴 사용자 지정 → 커넥터 → 내 항목에서 세브렌을 열면 도구 권한이 대화형·읽기 전용·쓰기/삭제 세 묶음으로 나뉘어 있고, 묶음마다 오른쪽 메뉴에서 ‘항상 허용’을 고르면 모든 대화에 적용됩니다. 그림으로 보려면 어떻게 정리되나요?의 ‘항상 허용’ 절을 보세요.

저장이 끝나면 대화 안에 저장된 노트의 위치가 보이고, GitHub의 secondbrain-vault 저장소를 열면 같은 파일이 실제로 생겨 있어요. 여기까지 보이면 연결은 끝난 겁니다.

보관함은 평범한 GitHub 저장소라, 내 컴퓨터로 복제하면 노트 폴더가 그대로 생기고 옵시디언은 그 폴더를 여는 앱이에요. 순서는 세 줄로 요약됩니다. GitHub Desktop을 설치해 로그인하고, secondbrain-vault를 Clone하고, 옵시디언에서 그 폴더를 보관함으로 열면 됩니다. 자동 동기화 플러그인 설정과 주의점은 내 컴퓨터 Obsidian과 연결하기에 그림과 함께 정리해 뒀어요. 이 과정은 전부 내 컴퓨터와 내 GitHub 계정 사이에서 일어나고, 세브렌 서버는 관여하지 않습니다.

• 저장소가 안 만들어져요.설치가 다른 GitHub 계정에 걸렸을 가능성이 커요. 설치 화면 우측 상단에서 어느 계정인지 확인하고, 조직 계정이 아닌 개인 계정으로 다시 시도하세요. 이미 허락하고 왔다면 반영에 몇 초 걸릴 수 있으니 ‘다시 확인’을 눌러 주세요.
• “기억해줘”라고 했는데 보관함에 안 남아요. 스킬이 꺼져 있거나 설치되지 않은 경우예요. claude.ai 설정 → 스킬에서 토글이 켜져 있는지 보고, 대화에서 세브렌 도구가 호출되는지 확인하세요.
• 새 기능이 안 보여요. 세브렌에 도구가 추가된 뒤에는 MCP를 지우고 같은 이름·주소로 다시 이어야 목록이 반영되는 경우가 있어요. 다시 연결하기를 따라 주세요.

개발 지식이 없어도 되나요?

네. GitHub 계정을 만들고 버튼을 누를 줄만 알면 됩니다. 터미널을 열거나 코드를 만질 일은 없어요.

PC와 모바일에서 모두 되나요?

네. 한 번 연결한 뒤에는 PC의 claude.ai와 Claude 모바일 앱에서 같은 보관함을 이어서 씁니다. 다만 MCP를 새로 추가하는 일은 브라우저에서만 돼요.

그만 쓰면 노트를 못 여나요?

노트는 평범한 마크다운 파일이라 세브렌 없이도 옵시디언 같은 편집기에서 그대로 열립니다. 해지해도 보관함은 내 GitHub에 남아요. 나머지 질문은 자주 묻는 질문에 있어요.

Obsidian은 Obsidian.md의 제품이며 Sebren과 무관한 별도 앱입니다. 본 가이드는 연동 방법 안내 목적으로만 해당 명칭을 사용합니다.

← 처음으로