Windows에서 Claude가 내 로컬 파일을 검색하고 읽게 하는 법 (MCP 단계별 설정)

2026-11-13·7분
요약: LocalSynapse는 PC의 문서를 색인하고 MCP 서버를 내장한 Windows·macOS용 무료 데스크톱 앱으로, Claude가 그 문서를 검색하고 읽을 수 있게 합니다. Windows에서는 LocalSynapse를 설치해 폴더를 색인하고, MCP 페이지에서 Claude Desktop 옆의 연결 버튼을 누른 뒤 Claude Desktop을 다시 시작하면 됩니다. 그러면 %APPDATA%\Claude\claude_desktop_config.json에 LocalSynapse.exe를 mcp 인자로 실행하는 'localsynapse' 항목이 추가됩니다. Claude Code용으로는 같은 페이지에 복사할 수 있는 'claude mcp add' 명령이 표시됩니다. 이후 Claude는 search_files, get_file_content 등 9개 도구를 씁니다. 색인은 PC에 남지만, Claude가 읽은 내용은 Anthropic과의 대화 일부가 됩니다.

Claude는 기본적으로 내 컴퓨터의 파일을 볼 수 없습니다. Claude Desktop에게 지난 분기 단가표 파일을 찾아 달라고 하면 검색할 대상이 없습니다. Model Context Protocol(MCP)이 이 빈틈을 메웁니다: Claude가 내 PC에서 실행되는 도구를 호출하고, 그 도구가 검색을 합니다. 이 글은 LocalSynapse를 로컬 서버로 삼아 Windows에서 단계별로 설정합니다.

무엇이 필요한가요?

Claude Desktop을 내 로컬 파일에 어떻게 연결하나요?

  1. LocalSynapse를 설치합니다. 설치기는 현재 Windows 사용자용으로 설치하며 기본 경로는 %LOCALAPPDATA%\Programs\LocalSynapse\LocalSynapse.exe입니다. Windows 빌드는 코드 서명이 없어 Microsoft Defender SmartScreen 경고가 뜰 수 있습니다. 추가 정보 → 실행을 선택하세요.
  2. 폴더를 색인하게 둡니다. LocalSynapse는 Word(.docx), Excel(.xlsx), PowerPoint(.pptx), PDF, HWP/HWPX, OpenDocument, RTF, HTML, 이메일(.eml, .msg), 일반 텍스트 파일을 읽습니다. 키워드 검색은 추가 다운로드 없이 됩니다. 의미 검색에는 선택 사항인 AI 모델(약 2.3GB)이 필요하며, 설치를 선택할 때만 내려받습니다.
  3. MCP 페이지에서 Claude Desktop 항목의 연결 버튼을 누릅니다. LocalSynapse가 %APPDATA%\Claude\claude_desktop_config.json에 localsynapse 항목을 씁니다. 파일에 있던 다른 MCP 서버는 그대로입니다.
  4. Claude Desktop을 다시 시작합니다. 앱도 같은 안내를 띄웁니다: 새 서버는 Claude Desktop이 시작될 때 인식됩니다.
  5. 동작을 확인합니다. Claude에게 "LocalSynapse로 색인 상태를 확인해 줘"라고 물어보세요. get_pipeline_status를 호출해 추출과 임베딩 진행 상황을 알려 줘야 합니다.

연결 버튼은 무엇을 쓰나요?

아래가 항목 전체입니다. command는 지금 실행 중인 LocalSynapse의 경로이고 MCP 페이지에 그 경로가 그대로 표시되므로, 직접 추가해도 됩니다:

{
  "mcpServers": {
    "localsynapse": {
      "command": "C:\\Users\\사용자이름\\AppData\\Local\\Programs\\LocalSynapse\\LocalSynapse.exe",
      "args": ["mcp"]
    }
  }
}

Claude Code에는 어떻게 추가하나요?

같은 MCP 페이지에 Claude Code용 명령과 복사 버튼이 있습니다. 형태는 claude mcp add localsynapse -- "<LocalSynapse.exe 경로>" mcp이고 경로가 이미 채워져 있습니다. 터미널에 붙여 넣으세요. 되돌리는 claude mcp remove localsynapse도 표시됩니다.

Cursor, Cline 등 다른 MCP 클라이언트는요?

로컬(stdio) MCP 서버를 실행할 수 있는 클라이언트라면 같습니다: command는 LocalSynapse.exe, 인자는 mcp 하나입니다. 클라이언트가 필요할 때 LocalSynapse를 백그라운드로 실행하므로 LocalSynapse 창을 열어 둘 필요가 없습니다. 일반 참고는 MCP 연동 페이지에, 다른 클라이언트의 설정 예는 Hermes Agent 가이드에 있습니다.

연결되면 Claude는 무엇을 할 수 있나요?

Claude는 9개 도구를 받습니다:

전형적인 흐름: "협력사 계약서에 해지 통보 기간이 뭐라고 돼 있었지?"라고 물으면 Claude가 search_files로 계약서 PDF의 해당 구절을 찾아, 어느 파일에서 왔는지와 함께 답합니다.

문제 해결

LocalSynapse가 하지 않는 것


관련 포스트

LocalSynapse 무료 체험

파일 내용 검색, 오프라인 동작, 무료

홈으로 이동

관련 글