Obsidian Second Brain (Claude Skill) — 설치 & 라이브 데모

왜 쓰나요

핵심 기능

볼트 우선 리서치 — 웹/AI에 도달하기 전에 내부 노트 검색
캡처, 리팩토링, 검토에 걸친 31개 명령
템플릿에서 원자적 노트 생성 (Zettelkasten 스타일)
백링크 + MOC 유지 (링크 제안, 허브 페이지 구축)
주기적 검토 큐 (생각을 위한 간격 반복)
예약된 에이전트 — 일간/주간 유지 실행
플러그인 불필요한 Markdown 네이티브

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "obsidian-second-brain-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/eugeniughelbur/obsidian-second-brain",
        "~/.claude/skills/obsidian-second-brain"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-second-brain-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/eugeniughelbur/obsidian-second-brain",
        "~/.claude/skills/obsidian-second-brain"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-second-brain-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/eugeniughelbur/obsidian-second-brain",
        "~/.claude/skills/obsidian-second-brain"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-second-brain-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/eugeniughelbur/obsidian-second-brain",
        "~/.claude/skills/obsidian-second-brain"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-second-brain-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/eugeniughelbur/obsidian-second-brain",
        "~/.claude/skills/obsidian-second-brain"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-second-brain-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/eugeniughelbur/obsidian-second-brain",
          "~/.claude/skills/obsidian-second-brain"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add obsidian-second-brain-skill -- git clone https://github.com/eugeniughelbur/obsidian-second-brain ~/.claude/skills/obsidian-second-brain

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Obsidian Second Brain

볼트 우선, 웹 두 번째로 주제 리서치

👤 연구자, 작가, 지식 노동자 ⏱ ~45 min intermediate

언제 쓸까: 이전에 생각해본 것을 조사할 때; 자신의 이전 생각을 먼저 표면화하고 싶을 때.

사전 조건

스킬 설치됨 — git clone https://github.com/eugeniughelbur/obsidian-second-brain ~/.claude/skills/obsidian-second-brain
볼트 경로 — 스킬 설정에서 .obsidian 볼트 경로 설정

흐름

내부 우선

Obsidian-2brain: '주의력 vs 의도력'을 리서치하세요. 패스 1: 내 볼트를 검색하세요. 날짜와 핵심 주장이 있는 관련 노트를 나열하세요.✓ 복사됨

→ 인용된 주장이 있는 구체적인 노트 목록, '관련 노트 없음'이 아님
내 생각 종합

종합하세요: 이 노트들을 기반으로 내 진화하는 견해는 무엇인가요? 시간이 지남에 따른 모순을 기록하세요.✓ 복사됨

→ 모순이 표시된 당신의 생각에 대한 솔직한 요약
외부 보완

패스 2: 내 견해에서 무엇이 빠져 있나요? 이제 공백을 채우기 위해 외부 소스를 가져오세요.✓ 복사됨

→ 내부를 보완하는 타겟된 외부 리서치
캡처

이것을 종합하는 새 원자적 노트를 생성하세요. 모든 소스 노트에 링크하세요. '주의력' MOC에 추가하세요.✓ 복사됨

→ 적절한 백링크와 함께 inbox에 노트 생성됨

결과: 처음부터 시작하는 대신 자신의 생각을 기반으로 구축하는 리서치

함정

볼트가 지저분함 → 내부 패스가 쓸모없음 — 먼저 백링크 위생 패스 실행; 혼란스러운 볼트를 리서치하지 말 것

함께 쓰기: filesystem

주제 클러스터를 위한 콘텐츠 맵 구축

👤 볼트 관리자 ⏱ ~30 min intermediate

언제 쓸까: 주제에 50개 이상의 노트가 있고 정리가 안 된 상태일 때.

흐름

클러스터

Obsidian-2brain: #productivity로 태그된 모든 노트를 클러스터링하세요. 3-5개의 하위 주제를 보여주세요.✓ 복사됨

→ 깨끗한 클러스터 제안
MOC 구축

클러스터별로 섹션이 있는 '생산성 MOC.md'를 생성하고 관련 노트에 링크하세요. 각 클러스터를 위한 간략한 프레이밍을 추가하세요.✓ 복사됨

→ 허브 페이지 생성됨; 백링크 확립됨

결과: 주제가 단일 허브 페이지에서 탐색 가능

함정

MOC가 쓰레기통이 됨 — 30개 링크로 제한; 나머지는 하위 MOC에

주간 검토 에이전트 예약

👤 PKM 열정가 ⏱ ~20 min beginner

언제 쓸까: 일요일 아침 의식 — 고아 노트, 오래된 항목, 일간 노트 롤업.

흐름

구성

Obsidian-2brain: 주간 검토를 구성하세요. 작업: 고아 노트 나열, 90일 이상 열지 않은 노트 나열, 주간 일간 노트 롤업 생성.✓ 복사됨

→ 일정 등록됨; 첫 번째 실행 드라이
출력 검토

지금 주간 검토를 실행하세요. 보고서를 보여주세요.✓ 복사됨

→ 구체적인 실행 항목이 있는 보고서

결과: 볼트가 당신이 돌보지 않아도 건강하게 유지됨

함정

자동 보관이 실제 노트를 삭제 — 스킬은 제안하지만 절대 삭제하지 않음; 실행 전 검토

조합

다른 MCP와 조합해 10배 효율

obsidian-second-brain-skill + filesystem

볼트 경로의 노트 읽기/쓰기

vault/Areas/의 모든 것을 읽으세요. 주제별로 클러스터링하세요.✓ 복사됨

obsidian-second-brain-skill + personal-os-skills

볼트 우선 리서치와 더 넓은 Obsidian 스킬 suite 결합

주간 검토 실행 (2brain). 그런 다음 주간 캡처-롤업 실행 (personal-os).✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
vault_search	query, max_results?	항상 웹으로 가기 전에
create_note	template, title, body, links[]	새 원자 캡처
build_moc	topic, source_notes	주제 허브 구축
backlink_hygiene	scope?	주기적 유지보수
orphan_notes	(없음)	주간 검토
review_queue	(없음)	간격 검토 세션
schedule_agent	cadence, tasks[]	자동화 설정

비용 및 제한

운영 비용

API 쿼터: 해당 없음
호출당 토큰: 볼트 검색은 타이트하게 유지; 전체 볼트 클러스터는 5k–30k까지 실행 가능
금액: 무료
팁: vault_search를 적극적으로 사용 — 큰 컨텍스트를 가져오기 전에 빠른 필터

보안

권한, 시크릿, 파급범위

최소 스코프: filesystem-read filesystem-write

자격 증명 저장: 없음

데이터 외부 송신: 없음 — 볼트는 로컬에 유지

볼트에 민감한 노트가 있을 수 있음; 웹/공유 MCP와 결합하기 전에 검토
대규모 편집 전에 항상 볼트 백업 (git, iCloud 등)

문제 해결

자주 발생하는 오류와 해결

vault_search가 명백한 일치에도 아무것도 반환 안 함

볼트 경로가 잘못됐을 수 있음; 스킬 설정에서 확인

MOC가 기존 허브와 겹침

먼저 기존 것 감지; 중복 대신 병합

예약된 에이전트가 실행되지 않음

스킬은 Claude가 호출할 때 실행됨; 여기서 '예약'은 실행할 문서화된 루틴을 의미하며 시스템 cron이 아님

대안

Obsidian Second Brain 다른 것과 비교

대안	언제 쓰나	단점/장점
personal-os-skills (ArtemXTech)	더 넓은 Claude × Obsidian 실험실을 원할 때	다른 포커스; 볼트 우선 리서치 강조가 적음
Obsidian Smart Connections 플러그인	Obsidian 내부에서 IDE 스타일 제안을 원할 때	플러그인 기반; Claude Code 아님
Roam Research / Logseq	다른 PKM을 사용할 때	다른 툴; 스킬은 Obsidian 모양

Obsidian Second Brain