Synapse

AI와 노트 사이의 신경계.

모든 AI를 Obsidian 볼트에 연결하는 MCP 서버입니다. Claude, ChatGPT, Cursor, Windsurf 및 모든 MCP 호환 클라이언트와 함께 작동합니다. 휴대폰에서 기사를 저장하고, 노트 전체에 걸쳐 질문하며, 지식 베이스를 구축하세요.

30초 설정

Claude Desktop

1. 설정 파일 열기: Mac ~/Library/Application Support/Claude/claude_desktop_config.json | Windows %APPDATA%\Claude\claude_desktop_config.json

2. mcpServers 객체에 Synapse 추가:

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-obsidian", "/path/to/your/obsidian-vault"]
    }
  }
}

3. Claude Desktop을 재시작합니다. Synapse 도구가 자동으로 나타납니다.

Claude Code

홈 디렉토리의 .claude/.mcp.json에 추가:

{
  "mcpServers": {
    "synapse": {
      "command": "npx",
      "args": ["-y", "synapse-obsidian", "/path/to/your/vault"]
    }
  }
}

Claude.ai / ChatGPT / 기타 원격 AI

Synapse를 로컬에서 실행하고 무료 터널로 노출하세요:

# Terminal 1: Start Synapse
npx synapse-obsidian /path/to/vault --http --port 3777

# Terminal 2: Expose it (free, no account needed)
npx cloudflared tunnel --url http://localhost:3777

터널 URL을 복사합니다. AI 클라이언트의 사용자 지정 MCP 통합 설정에 https://your-tunnel-url.trycloudflare.com/mcp를 추가하세요.

시작하기

연결되면 다음과 같이 말해보세요:

"Help me get started with Synapse"

Synapse가 볼트를 스캔하고 세 가지 옵션을 제공합니다:

• Use my existing vault — 폴더 구조, 위키링크, 명명 규칙을 감지합니다. 아무것도 이동하거나 덮어쓰지 않습니다. Synapse가 사용자에게 맞춥니다.

• Set up a knowledge base — 체계적인 폴더를 생성합니다: 원본 콘텐츠용 sources/, 정리된 지식용 notes/, 쿼리 결과용 outputs/. 집중적인 연구 주제에 가장 적합합니다.

• Custom — 원하는 정리 방식을 Synapse에 알려줍니다.

또한 볼트를 어떤 용도(연구, 비즈니스, 학업, 라이프 OS 등)로 사용할지 물어보고 경험을 맞춤화합니다.

주요 기능

어디서나 무엇이든 저장

"Save this article: https://example.com/interesting-post"

페이지를 가져와 마크다운으로 변환하고 볼트에 저장합니다. 휴대폰에서도 작동합니다.

노트 전체에 질문하기

"What do my notes say about pricing strategy?"

볼트를 검색하고 관련 파일을 읽은 뒤, 인용된 답변을 종합합니다.

지식 베이스 구축

"Process all new articles in my vault"

원본 소스를 요약, 개념 페이지, 엔티티 페이지로 변환하며, 모두 위키링크로 상호 연결됩니다. 모든 답변은 다시 지식 베이스로 피드백됩니다.

노트 상태 점검

"Run a health check on my vault"

깨진 링크, 고아 페이지, 누락된 프론트매터, 오래된 콘텐츠를 찾습니다. 가능한 경우 수정합니다.

모든 도구

작동 원리

Synapse는 MCP 서버입니다. 이는 AI를 도구 및 데이터에 연결하기 위한 개방형 프로토콜입니다. AI에게 볼트에 대한 읽기/쓰기 권한을 부여합니다(볼트 디렉토리로 샌드박스 처리되어 다른 곳에는 접근 불가).

• Stdio (기본값) — 데스크톱 AI 앱용 (Claude Desktop 등)

• HTTP (--http) — 브라우저 기반 AI용 (Claude.ai, ChatGPT 등, 터널 사용)

• Cloud (--cloud) — Google Drive OAuth를 사용하는 호스팅 모드 (출시 예정)

볼트는 단순히 마크다운 파일 폴더입니다. Synapse는 Obsidian이 실행 중일 필요가 없으며, 어떤 폴더와도 작동합니다.

요구 사항

• Node.js 18+ (node -v로 확인)

• Obsidian 볼트 또는 마크다운 파일이 포함된 폴더

• MCP 호환 AI 클라이언트

라이선스

MIT — MainLoop Systems